Extensões de anúncio

Os scripts do Google Ads são compatíveis com as seguintes extensões de anúncio:

• Apps para dispositivos móveis
• Números de telefone
• Frases de destaque
• Preços
• Snippets
• Sitelinks

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

Atenção: em breve, as extensões com base em recursos vão substituir as extensões com base em feeds. Consulte o guia de migração para mais informações.

Com os scripts do Google Ads, você pode acessar extensões de anúncios compatíveis na sua conta. Por exemplo, o snippet de código a seguir acessa os sitelinks:

const sitelinkIterator = AdsApp.extensions().sitelinks().get();
for (const sitelink of sitelinkIterator) {
  // Do something with each sitelink
}

Você pode recuperar outras extensões de anúncio suportadas de forma similar usando seus respectivos iteradores.

Criação

Com os scripts do Google Ads, você cria extensões de anúncio compatíveis. Por exemplo, o snippet de código abaixo usa um criador de números de telefone para criar um número de telefone na sua conta:

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

Quando build() é chamado, o número de telefone é criado na conta, mas 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úncios com suporte podem ser criadas e associadas a campanhas ou grupos de anúncios da mesma forma com os respectivos criadores.

Análise de estatísticas

Com os scripts do Google Ads, você pode acessar estatísticas de extensões de anúncios compatíveis no nível da conta, da campanha ou do grupo de anúncios.

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

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

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

// Ad-group-level stats.
// Get a sitelink in an ad group.
const adGroupSitelinkIterator = adGroup.extensions().sitelinks().get();
const adGroupSitelink = adGroupSitelinkIterator.next();
const adGroupSitelinkStats = adGroupSitelink.getStatsFor("LAST_30_DAYS");
console.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 Ads. Por exemplo, o snippet de código a seguir modificará um sitelink existente:

// Get a sitelink in the account.
const sitelinkIterator = AdsApp.extensions().sitelinks().get();
const sitelink = sitelinkIterator.next();
console.log(sitelink.getLinkText()); // "original text"

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

// Get a sitelink from an ad group. Assume it's the same one as above.
const adGroupSitelinkIterator = adGroup.extensions().sitelinks().get();
const adGroupSitelink = adGroupSitelinkIterator.next();
console.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!
console.log(campaignSitelink.getLinkText()); // "new link text"
console.log(adGroupSitelink.getLinkText()); // "new link text"
console.log(sitelink.getLinkText()); // "new link text"

Observação: se você modificar um Sitelink, isso vai afetar a veiculação de anúncios em todas as campanhas e grupos de anúncios a que o sitelink está associado. Essa regra se aplica se você extraiu o sitelink diretamente 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 anterior 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

Com os scripts do Google Ads, você pode acessar extensões de anúncios no nível do grupo de anúncios. A chamada de método a seguir vai retornar números de telefone que foram adicionados explicitamente a um grupo de anúncios. Se números de telefone tiverem sido adicionados à campanha à qual o grupo de anúncios pertence, a chamada de método a seguir não vai retornar esses números, mesmo que eles estejam qualificados para aparecer nos anúncios veiculados nesse grupo.

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

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

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

Com os scripts do Google Ads, você pode acessar extensões de anúncio no nível da conta. As frases de destaque, os apps para dispositivos móveis e as avaliações podem ser adicionadas como extensões de anúncio no nível da conta, mas os sitelinks e números de telefone no nível da conta não estão disponíveis. A chamada de método a seguir vai retornar as frases de destaque que foram adicionadas explicitamente à sua conta.

// This will return callouts that have been explicitly added to your account.
const accountCalloutIterator =
    AdsApp.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.
const calloutBuilder = AdsApp.extensions().newCalloutBuilder();
const newCallout = calloutBuilder.withText("Sample Text").build().getResult();

// Add the new callout as an account-level extension. This enables it to serve
// for all campaigns in the account.
AdsApp.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 Ads 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.
const campaignMobileAppIterator = campaign.extensions().mobileApps().get();
const 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.
const mobileAppIterator = AdsApp.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.
const adGroupMobileAppIterator = adGroup.extensions().mobileApps().get();
const adGroupMobileApp = adGroupMobileAppIterator.next();

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

// Get an account-level mobile app.
const accountMobileAppIterator =
    AdsApp.currentAccount().extensions().mobileApps().get();
const 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.
AdsApp.currentAccount().removeMobileApp(accountMobileApp);

Se todos os apps para dispositivos móveis forem removidos de uma campanha, ela não terá mais uma extensão de app para 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 de cada vez. O procedimento é o mesmo para outras extensões de anúncio suportadas.