Ads Manager Komut Dosyaları

Google Ads komut dosyalarındaki AdsManagerApp sınıfı, Yönetici Hesabınız altında bağlı hesapları yönetmenizi sağlar. Her hesap için ayrı bir komut dosyası oluşturmak yerine tüm reklamveren hesaplarınızı tek bir komut dosyası üzerinden yönetebilirsiniz.

Hesap listesini alma

accounts yöntemini kullanarak bir yönetici hesabındaki hesapları alabilirsiniz. Örneğin:

const accountSelector = AdsManagerApp.accounts()
    .withCondition('customer_client.descriptive_name = "My Account"');

const accountIterator = accountSelector.get();

Alınabilen hesaplarla ilgili bazı kısıtlamalar vardır:

• Çok düzeyli bir hiyerarşiniz varsa yönetici hesapları alınamaz. Yalnızca müşteri hesapları seçilebilir.
• Varsayılan olarak kapalı, iptal edilmiş ve askıya alınmış hesaplar iade edilmez. customer_client.status için farklı bir filtre belirterek withCondition'ü çağırarak bu davranışı geçersiz kılabilirsiniz.

accounts çağrısı, varsayılan olarak yönetici hesabı hiyerarşisindeki tüm müşteri hesaplarının listesini alır. Komut dosyanızın aldığı hesap sayısını kısıtlamak için ManagedAccountSelector sınıfının withLimit yöntemini kullanabilirsiniz. Bir diğer seçenek de withIds yöntemini kullanarak hesapları müşteri kimliklerine göre seçmektir:

// Hyphens in the account ID are optional.
const accountSelector = AdsManagerApp.accounts()
    .withIds(['123-456-7890', '234-567-8901', '345-678-9012']);

Müşteri hesaplarında çalışma

Müşteri hesaplarını aldıktan sonra iteratörlerin hasNext ve next yöntemlerini kullanarak bu hesapları iteratif olarak inceleyebilirsiniz. Yürütme bağlamını bir müşteri hesabına geçirmek için select yöntemini kullanmanız gerekir. Bir istemci hesabı seçtikten sonra, başka bir hesabı açıkça seçene kadar diğer API çağrıları istemci hesabı için geçerli olur:

// Keep track of the manager account for future reference.
const managerAccount = AdsApp.currentAccount();

// Select your accounts
const accountIterator = AdsManagerApp.accounts()
// ... Write some logic here to select the accounts you want using
// withCondition or withIds

// Iterate through the list of accounts
for (const account of accountIterator) {
  // Select the client account.
  AdsManagerApp.select(account);

  // Select campaigns under the client account
  const campaignIterator = AdsApp.campaigns().get();

  // Operate on client account
  ...
}

Hesaplar üzerinde paralel olarak çalışma

Google Ads komut dosyaları, ManagedAccountSelector sınıfının executeInParallel yöntemini kullanarak birden fazla müşteri hesabında paralel olarak işlem yapmanıza olanak tanır. executeInParallel yönteminin imzası aşağıdaki gibidir:

function executeInParallel(functionName, optionalCallbackFunctionName, optionalInput);

executeInParallel yöntemi, functionName tarafından belirtilen bir işlevi, ManagedAccountSelector ile eşleşen her ManagedAccount üzerinde yürütür. Tüm hesaplar işlendikten sonra, optionalCallbackFunctionName tarafından belirtilmişse geri çağırma işlevi bir kez yürütülür ve daha fazla işlem için bağımsız değişkeni olarak bir ExecutionResult öğesi listesi iletilir. Tipik kullanım aşağıda gösterilmiştir:

function main() {
  const accountSelector = AdsManagerApp.accounts()
      .withLimit(50)
      .withCondition('customer_client.currency_code = "USD"');

  accountSelector.executeInParallel("processClientAccount", "afterProcessAllClientAccounts");
}

function processClientAccount() {
  const clientAccount = AdsApp.currentAccount();

  // Process your client account here.
  ...

  // optionally, return a result, as text.
  return "";
}

function afterProcessAllClientAccounts(results) {
  for (const result of results) {
    // Process the result further
    ...
  }
}

functionName tarafından belirtilen işlev isteğe bağlı olarak bir dize bağımsız değişkeni (optionalInput) kabul edebilir. Bu parametre, executeInParallel tarafından çağrılan tüm paralel yöntemlere ek bir parametre iletmek için kullanılabilir:

function main() {
  const accountSelector = AdsManagerApp.accounts().withIds([1234567890, 3456787890]);
  const sharedParameter = "INSERT_SHARED_PARAMETER_HERE";
  accountSelector.executeInParallel("processClientAccount", null, sharedParameter);
}

function processClientAccount(sharedParameter) {
  // Process your client account here.
  ...
}

Hesaba özgü ayarlar içeren bir JavaScript yapılandırma nesnesi iletmek istiyorsanız önce JSON.stringify yöntemini kullanarak nesneyi bir dizeye dönüştürebilirsiniz:

function main() {
  ...
  const accountFlags = {
    '1234567890': {
       'label': 'Brand 1 campaigns',
     },
    '3456787890': {
       'label': 'Brand 2 campaigns',
     }
  };
  accountSelector.executeInParallel("processClientAccount", null,
      JSON.stringify(accountFlags));
  ...
}

function processClientAccount(sharedParameter) {
  const accountFlags = JSON.parse(sharedParameter);
  // Process your client account here.
  ...
}

functionName tarafından belirtilen işlev, JSON.stringify aracılığıyla nesne yerine dize de döndürebilir:

function processClientAccount() {
  ...
  const jsonObj = {value: 10, list: [1,2,3,4,5,6], name: "Joe Smith"};
  return JSON.stringify(jsonObj);
}

Döndürülen değerler, ExecutionResult objelerinin listesinde geri çağırma işlevine iletilir. İşlevden bir JSON dizesi döndürdüyseniz JSON.parse yöntemini kullanarak bunu tekrar JavaScript nesnesine dönüştürebilirsiniz:

function callbackFunctionName(results) {
  for (var i = 0; i < results.length; i++) {
    var resultObj = JSON.parse(results[i].getReturnValue());
  }
}

executeInParallel yöntemi en fazla 50 accounts ile çalışır. Bu nedenle, komut dosyanızın aldığı hesap sayısını sınırlamak için kendi kısıtlamalarınızı uygulamanız gerekir. Komut dosyanızın aldığı hesap sayısını kısıtlamak için ManagedAccountSelector sınıfının withLimit veya withIds yöntemini kullanabilirsiniz.

Yürütme süresi sınırları

Ads Manager komut dosyası yürütme süresi sınırları hakkında ayrıntılı bilgi için bu sayfaya bakın.