Builders

Standardmäßig werden Entitäten in Google Ads-Skripts mit Generatoren erstellt. Mit Generatoren können Sie eine Google Ads-Entität synchron oder asynchron erstellen. Sie können auch prüfen, ob der Vorgang erfolgreich war, und je nach Ergebnis entsprechende Maßnahmen ergreifen. Das folgende Code-Snippet zeigt, wie Sie ein Keyword mit einem Generator erstellen.

// 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();
}

Jede Entität, die mit Google Ads-Skripts erstellt werden kann, verwendet dieses Generatormuster.

Hinweise zur Leistung

Standardmäßig werden Vorgänge in Google Ads-Skripts asynchron ausgeführt. So können Skripts Vorgänge in Batches gruppieren und eine hohe Leistung erzielen. Wenn Sie jedoch die Vorgangs methoden wie isSuccessful() und getResult() aufrufen, werden die ausstehenden Vorgänge in Google Ads-Skripts geleert, was zu einer schlechten Leistung führen kann. Erstellen Sie stattdessen ein Array, um die Vorgänge zu speichern, und durchlaufen Sie dann das Array, um die Ergebnisse abzurufen.

Schlechte Leistung Gute Leistung 
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");
}