AdWords Scripts and MCC Scripting

AdWords Scripts for MCCManage AdWords accounts using JavaScript

Mark Bowyer, Google, Inc.

Agenda

● Introduction

● Getting started

● Resources

● Questions


Introduction


● Way to programmatically access AdWords data

● Write your code in JavaScript

● Embedded IDE in AdWords UI

Recap - AdWords Scripts

Script


function main() { // Retrieve campaign by name using AWQL. var demoCampaign = AdWordsApp.campaigns(). withCondition("Name='Demo campaign'").get().next(); // Retrieve child adgroup using AWQL. var demoAdGroup = demoCampaign.adGroups(). withCondition("Name='Demo adgroup'").get().next();

// Modify the adgroup properties. demoAdGroup.setKeywordMaxCpc(1.2);}

Recap - AdWords Scripts


● AdWords Scripts at MCC level

● Allows managing accounts at scale

What are MCC Scripts?


● Currently open for beta signup

● Whitelisting usually takes a few business days.

● Request whitelist at top-level MCC account

Availability

https://services.google.com/fb/forms/mccscripts


● Manage multiple client accounts from a single script

● No more copy-pasting a script into multiple accounts!

● Process multiple accounts in parallel

Benefits


● Bid management in all your child accounts

● Cross-account reporting

Common use cases


Accessing MCC Scripts

1

2


Get started!

Script


Your first scriptfunction main() { // Retrieve all the child accounts.

var accountIterator = MccApp.accounts().get();

// Iterate through the account list. while (accountIterator.hasNext()) { var account = accountIterator.next();

// Get stats for the child account. var stats = account.getStatsFor("THIS_MONTH");

// And log it. Logger.log("%s,%s,%s", account.getCustomerId(), stats.getClicks(), stats.getImpressions(), stats.getCost()); }}


● Provides account management functionality

● Retrieve child accounts

● Select a child account for further operations

● Process multiple child accounts in parallel

MccApp class


var accountIterator = MccApp.accounts().get();

● Use MccApp.accounts method

● By default, returns all client accounts (excluding sub-

MCCs)

Selecting child accounts

Script


● Can optionally filter by an account label

Selecting child accounts (cont’d)

var accountIterator = MccApp.accounts()

.withCondition('LabelName = "xxx"')

.get();

Script


● Can optionally take a list of client ids

Selecting child accounts (cont’d)

var accountIterator = MccApp.accounts()

.withIds(['123-456-7890', '345-678-9000'])

.get();

Script


● By default, this is the account where script resides

● Switch context using MccApp.select method

● Then use AdWordsApp class to process account

● Remember to switch back to your MCC account!

What account am I operating on?

Script


var childAccount = MccApp.accounts().withIds(["918-501-8835"]) .get().next();

// Save the MCC account.

var mccAccount = AdWordsApp.currentAccount();

// Select the child account

MccApp.select(childAccount);

// Process the account....

// Switch back to MCC account.MccApp.select(mccAccount);

Operating on a specific child account (cont’d)


Processing accounts in parallel


● Use AccountSelector.executeInParallel

method

● Operate on upto 50 accounts in parallel

● Optional callback method after processing accounts

Operating on accounts in parallel

Script


function main() { MccApp.accounts().executeInParallel("processAccount");}

function processAccount() { Logger.log("Operating on %s",

AdWordsApp.currentAccount().getCustomerId()); // Process the account. // ... return;}

Operating on accounts in parallel (cont’d)

Script


function main() { MccApp.accounts().executeInParallel("processAccount",

"allFinished");}

function processAccount() { ...}

function allFinished(results) { ...}

Specifying a callback


● Use results argument of callback method

● Array of ExecutionResult objects

● One ExecutionResult per account processed

Analyzing the outcome...


● Contains

● CustomerId

● Status (Success, Error, Timeout)

● Error (if any)

● Return values from processAccount

Analyzing the outcome (cont’d)

Script


function processAccount() { return AdWordsApp.campaigns().get().totalNumEntities().toString();}

function allFinished(results) { var totalCampaigns = 0; for (var i = 0; i < results.length; i++) { totalCampaigns += parseInt(results[i].getReturnValue()); } Logger.log("There are %s campaigns under MCC ID: %s.",

totalCampaigns,

AdWordsApp.currentAccount().getCustomerId());}

Returning processing results (cont’d)


● Processing method can return a string value

● Use JSON.stringify / JSON.parse to serialize / deserialize

complex objects

● Use datastore to return large values

● E.g. SpreadSheetApp, DriveApp...

Returning processing results (cont’d)


Execution time limits

30-X m

in

processAccount(A)

30 m

inutes30 m

inutes30-X m

in

processAccount(C)

30-X m

in

processAccount(B)

main() method

calls executeInParallel() for accounts A, B, C

allFinished()

X m

inutes

1 hour


● Signup form: https://services.google.

com/fb/forms/mccscripts

Beta signup





ResourcesMccApp Documentation: http://goo.gl/r0pGJOFeature guide: http://goo.gl/u65RAFCode snippets: http://goo.gl/2BXrfoComplete solutions: http://goo.gl/JSjYyfForum: http://goo.gl/sc95Q8

http://goo.gl/r0pGJO

http://goo.gl/u65RAF

http://goo.gl/2BXrfo

http://goo.gl/JSjYyf

http://goo.gl/sc95Q8


Questions?

AdWords Scripts and MCC Scripting

Technology

Transcript of AdWords Scripts and MCC Scripting