Extensões de anúncio

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

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

Os scripts do Google Ads 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:

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.

com base em trends

Com os scripts do Google Ads, você pode criar extensões de anúncio compatíveis. Por exemplo, o snippet de código a seguir usa um criador de números de telefone para criar um 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. No entanto, ele ainda não é 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 compatíveis podem ser criadas e associadas a campanhas ou grupos de anúncios da mesma forma com seus respectivos criadores.

Análise de estatísticas

Com os scripts do Google Ads, você pode acessar estatísticas das extensões de anúncio suportadas 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.
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"

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 Ads 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á 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á, mesmo quando os números estiverem qualificados para aparecer em anúncios veiculados daquele grupo de anúncios.

// 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 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 Ads permitem acessar extensões de anúncio no nível da conta. 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 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 frases de destaque que foram explicitamente adicionadas à 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 aplicativos para dispositivos móveis forem removidos de uma campanha, ela não terá mais uma extensão de aplicativo para dispositivos móveis. Para remover todos os aplicativos para dispositivos móveis da sua campanha, você precisa recuperar a lista de aplicativos para dispositivos móveis dessa campanha e removê-los um de cada vez. O procedimento é o mesmo para outras extensões de anúncio suportadas.