Yapımcılar

Oluşturucular, Google Ads komut dosyalarında öğe oluşturmanın standart yoludur. Oluşturucular, Google Ads öğesini senkronize veya asenkron olarak oluşturmanıza olanak tanır. Ayrıca, işlemin başarılı olup olmadığını kontrol edebilir ve işlemin sonucuna göre uygun işlemleri yapabilirsiniz. Aşağıdaki kod snippet'inde, bir oluşturucu kullanarak nasıl anahtar kelime oluşturulacağı gösterilmektedir.

// Retrieve your ad group.
let adGroup = AdsApp.adGroups().get().next();

// Create a keyword operation.
let keywordOperation = adGroup.newKeywordBuilder()
    .withCpc(1.2)
    .withText("shoes")
    .withFinalUrl("http://www.example.com/shoes")
    .build();

// Optional: examine the outcome. The call to isSuccessful()
// will block until the operation completes.
if (keywordOperation.isSuccessful()) {
  // Get the result.
  let keyword = keywordOperation.getResult();
} else {
  // Handle the errors.
  let errors = keywordOperation.getErrors();
}

Google Ads komut dosyaları kullanılarak oluşturulabilen tüm varlıklar bu oluşturucu kalıbı kullanılarak oluşturulur.

Performansla ilgili konular

Google Ads komut dosyaları, varsayılan olarak işlemlerini eşzamansız olarak yürütür. Bu, komut dosyalarının işlemlerinizi gruplar halinde toplamasına ve yüksek performans elde etmesine olanak tanır. Ancak isSuccessful() ve getResult() gibi İşlem yöntemlerini çağırmak, Google Ads komut dosyalarının bekleyen işlem listesini temizlemesini zorunlu kılar ve bu nedenle düşük performansa neden olabilir. Bunun yerine, işlemleri tutacak bir dizi oluşturun ve ardından sonuçları almak için bu diziden iterasyon yapın.

Kötü performans İyi performans 
for (let i = 0; i < keywords.length; i++)
  let keywordOperation = adGroup
    .newKeywordBuilder()
    .withText(keywords[i])
    .build();

  // Bad: retrieving the result in the same
  // loop that creates the operation
  // leads to poor performance.
  let newKeyword =
      keywordOperation.getResult();
  newKeyword.applyLabel("New keywords”);
}
 
// Create an array to hold the operations
let operations = [];

for (let i = 0; i < keywords.length; i++) {
  let keywordOperation = adGroup
    .newKeywordBuilder()
    .withText(keywords[i])
    .build();
  operations.push(keywordOperation);
}

// Process the operations separately. Allows
// Google Ads scripts to group operations into
// batches.
for (let i = 0; i < operations.length; i++) {
  let newKeyword = operations[i].getResult();
  newKeyword.applyLabel("New keywords”);
}