Criadores

Os criadores são uma forma padrão de criar entidades nos scripts do Google AdWords. Os criadores permitem criar uma entidade do Google AdWords de forma síncrona ou assíncrona. Além disso, você pode conferir se a operação foi bem-sucedida ou não e realizar as ações com base nos resultados da operação. O snippet de código a seguir mostra como criar uma palavra-chave usando um criador.

// Retrieve your ad group.
var adGroup = AdWordsApp.adGroups().get().next();

// Create a keyword operation.
var 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.
  var keyword = keywordOperation.getResult();
} else {
  // Handle the errors.
  var errors = keywordOperation.getErrors();
}

A versão atual agrega suporte do criador a anúncios e palavras-chave. Os criadores existentes de grupos de anúncios e extensões de anúncio, números de telefone, sitelinks e aplicativos para dispositivos móveis, também foram padronizados. Os métodos addSitelink, addPhoneNumber e addMobileApp das classes AdGroup e Campaign agora retornarão a operação resultante.

Considerações de desempenho

Por padrão, os scripts do Google AdWords executam suas operações de forma assíncrona. Isso permite que os scripts agrupem suas operações em lotes e alcancem alto desempenho. No entanto, chamar os métodos Operation, como isSuccessful() e getResult(), força os scripts do Google AdWords a executar as respectivas listas de operações pendentes. Isso poderá levar a um desempenho insatisfatório. Em vez disso, crie um array para recuperar os resultados.

Desempenho insatisfatório Desempenho satisfatório
for (var i = 0; i < keywords.length; i++)
  var keywordOperation = adGroup
    .newKeywordBuilder()
    .withText(keywords[i])
    .build();

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

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

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

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.