Extensões de anúncio

As extensões de anúncio, incluindo extensões de aplicativo, extensões de chamada, extensões de frase de destaque, extensões de comentários e sitelinks, são suportadas por meio dos scripts do Google AdWords.

Para saber mais sobre as extensões de anúncio, acesse o artigo da Central de Ajuda.

Os scripts do Google AdWords permitem que você acesse as extensões de anúncio suportadas na sua conta. Por exemplo, o snippet de código a seguir acessa os sitelinks:

var sitelinkIterator = AdWordsApp.extensions().sitelinks().get();
while (sitelinkIterator.hasNext()) {
  var sitelink = sitelinkIterator.next();
}

De forma semelhante, você pode recuperar outras extensões de anúncio suportadas usando seus respectivos iteradores.

Criação

Os scripts do Google AdWords permitem que você crie as extensões de anúncio suportadas. Por exemplo, o snippet de código a seguir usa um criador de números de telefone para criar um na sua conta.

var phoneNumberBuilder = AdWordsApp.extensions().newPhoneNumberBuilder();
var newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("6502530000")
  .withCallOnly(false)
  .build()
  .getResult();

Quando build() é chamado, o número de telefone é criado na conta. No entanto, ele ainda não será exibido ao lado dos anúncios. Primeiro, é necessário adicioná-lo a uma campanha ou a um grupo de anúncios:

// Add a phone number to a campaign.
campaign.addPhoneNumber(newPhoneNumber);

// Add a phone number to an ad group.
adGroup.addPhoneNumber(newPhoneNumber);

Outras extensões de anúncio suportadas podem ser criadas e associadas a campanhas ou grupos de anúncios da mesma forma com seus respectivos criadores.

Análise de estatísticas

Os scripts do Google AdWords permitem a você acessar as estatísticas das extensões de anúncio no nível da conta, da campanha ou do grupo de anúncios.

Por exemplo, para obter as estatísticas de sitelink:

// Account-level stats
// Get a sitelink in the account.
var sitelinkIterator = AdWordsApp.extensions().sitelinks().get();
var sitelink = sitelinkIterator.next();
var sitelinkStats = sitelink.getStatsFor("LAST_30_DAYS");
Logger.log(sitelinkStats.getClicks());

// Campaign-level stats.
// Get a sitelink in a campaign.
var campaignSitelinkIterator = campaign.extensions().sitelinks().get();
var campaignSitelink = campaignSitelinkIterator.next();
var campaignSitelinkStats = campaignSitelink.getStatsFor("LAST_30_DAYS");
Logger.log(campaignSitelinkStats.getClicks());

// Ad-group-level stats.
// Get a sitelink in an ad group.
var adGroupSitelinkIterator = adGroup.extensions().sitelinks().get();
var adGroupSitelink = adGroupSitelinkIterator.next();
var adGroupSitelinkStats = adGroupSitelink.getStatsFor("LAST_30_DAYS");
Logger.log(adGroupSitelinkStats.getClicks());

As estatísticas de outras extensões de anúncio suportadas podem ser acessadas de forma semelhante.

Modificação das extensões de anúncio

As extensões de anúncio existentes e suportadas podem ser modificadas com os scripts do Google AdWords. Por exemplo, o snippet de código a seguir modificará um sitelink existente:

// Get a sitelink in the account.
var sitelinkIterator = AdWordsApp.extensions().sitelinks().get();
var sitelink = sitelinkIterator.next();
Logger.log(sitelink.getLinkText()); // "original text"

// Get a sitelink from a campaign. Assume it's the same one as above.
var campaignSitelinkIterator = campaign.extensions().sitelinks().get();
var campaignSitelink = campaignSitelinkIterator.next();
Logger.log(campaignSitelink.getLinkText()); // "original text"

// Get a sitelink from an ad group. Assume it's the same one as above.
var adGroupSitelinkIterator = adGroup.extensions().sitelinks().get();
var adGroupSitelink = adGroupSitelinkIterator.next();
Logger.log(adGroupSitelink.getLinkText()); // "original text"

// Change the sitelink's link text. This change will affect all the campaigns and ad
// groups to which the sitelink belongs.
campaignSitelink.setLinkText("new link text");

// Same text!
Logger.log(campaignSitelink.getLinkText()); // "new link text"
Logger.log(adGroupSitelink.getLinkText()); // "new link text"
Logger.log(sitelink.getLinkText()); // "new link text"

Observação: a modificação de um sitelink afetará a veiculação de anúncios em todas as campanhas, além dos grupos de anúncios aos quais o sitelink está associado. Essa regra é aplicada independentemente de você ter recuperado o sitelink diretamente a partir do nível da conta, de um CampaignSitelink de uma campanha associada ou de um AdGroupSitelink de um grupo de anúncios associado. O exemplo de código precedente a seguir demonstra esse comportamento.

Os mesmos conceitos se aplicam a outras extensões de anúncio suportadas.

Acesso às extensões de anúncio no nível do grupo de anúncios

Os scripts do Google AdWords permitem que você acesse extensões de anúncio no nível do grupo de anúncios. A chamada de método a seguir retornará os números de telefone que foram explicitamente adicionados a um grupo de anúncios. Se os números de telefone foram adicionados à campanha à qual o grupo de anúncios pertence, a chamada de método a seguir não os retornará. Isso não acontecerá nem mesmo se os números de telefone forem qualificados para exibição em anúncios veiculados daquele grupo de anúncios.

// This will return phone numbers that have been explicitly added to this ad group.
var adGroupPhoneNumberIterator = adGroup.extensions().phoneNumbers().get();

Outras extensões de anúncio suportadas podem ser acessadas no nível do grupo de anúncios de forma semelhante.

Acesso às extensões de anúncio no nível da conta

Os scripts do Google AdWords permitem que você acesse extensões de anúncio no nível da conta. Todas as frases de destaque, aplicativos para dispositivos móveis e comentários podem ser adicionados como extensões de anúncio no nível da conta, mas os sitelinks no nível da conta e os número de telefone não estão disponíveis. A chamada de método a seguir retornará frases de destaque que foram explicitamente adicionadas à sua conta.

// This will return callouts that have been explicitly added to your account.
var accountCalloutIterator =
    AdWordsApp.currentAccount().extensions().callouts().get();

Comentários e aplicativos para dispositivos móveis no nível da conta podem ser acessados de forma semelhante.

Adicionar extensões de anúncio no nível da conta é semelhante a adicionar extensões de anúncio no nível do grupo de anúncios ou da campanha. O exemplo a seguir mostra como adicionar uma extensão de frase de destaque no nível da conta.

// Create a new callout in the account. Without adding the new callout as an ad
// group, campaign or account extension, it won't actually serve.
var calloutBuilder = AdWordsApp.extensions().newCalloutBuilder();
var newCallout = calloutBuilder.withText("Sample Text").build().getResult();

// Add the new callout as an account-level extension. This allows it to serve
// for all campaigns in the account.
AdWordsApp.currentAccount().addCallout(newCallout);

Os comentários e aplicativos para dispositivos móveis no nível da conta podem ser adicionados de forma semelhante.

Remoção de campanhas, grupos de anúncios e extensões de anúncio da conta

As extensões de anúncio suportadas podem ser removidas das campanhas e dos grupos de anúncios no nível da conta. Os scripts do Google AdWords não oferecem suporte a remoção de extensões de anúncio de uma conta de uma só vez.

// Get a mobile app from a campaign.
var campaignMobileAppIterator = campaign.extensions().mobileApps().get();
var campaignMobileApp = campaignMobileAppIterator.next();

// Remove the mobile app.
campaign.removeMobileApp(campaignMobileApp);

// The mobile app still exists in the account and will be returned in the following
// iterator.
var mobileAppIterator = AdWordsApp.extensions().mobileApps().get();

De forma semelhante, para remover um aplicativo para dispositivos móveis do nível da conta ou do grupo de anúncios:

// Get a mobile app from an ad group.
var adGroupMobileAppIterator = adGroup.extensions().mobileApps().get();
var adGroupMobileApp = adGroupMobileAppIterator.next();

// Remove the mobile app.
adGroup.removeMobileApp(adGroupMobileApp);

// Get an account-level mobile app.
var accountMobileAppIterator =
    AdWordsApp.currentAccount().extensions().mobileApps().get();
var accountMobileApp = accountMobileAppIterator.next();

// Remove the mobile app.
// Note that this removes the mobile app from the account level, so it will
// not serve as an account-level extension, but it will still exist in the
// account. It can still be added to an AdGroup or Campaign, or again as an
// account-level extension in the future.
AdWordsApp.currentAccount().removeMobileApp(accountMobileApp);

Se todos os aplicativos para dispositivos móveis forem removidos de uma campanha, ela não terá mais uma extensão para aplicativo de dispositivos móveis. Para remover todos os aplicativos para dispositivos móveis da sua campanha, é necessário recuperar a lista de aplicativos para dispositivos móveis da campanha em questão e removê-los um por vez. O procedimento é o mesmo para outras extensões de anúncio suportadas.

Scripts e feeds do Google AdWords

Os scripts do Google AdWords só podem ser usados para recuperar extensões no feed padrão. Os itens de feeds personalizados não são suportados. Todas as extensões criadas por meio da interface do Google AdWords são criadas no feed padrão. Para mais informações sobre feeds personalizados, acesse a documentação da AdWords API sobre feeds.

Enviar comentários sobre…

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