Estensioni annuncio

Gli script Google Ads supportano le seguenti estensioni annuncio:

• App mobile
• Numeri di telefono
• Callout
• Prezzi
• Snippet
• Sitelink

Per scoprire di più sulle estensioni degli annunci, visita il Centro assistenza.

Attenzione: a breve le estensioni basate su asset sostituiranno quelle basate su feed. Per ulteriori informazioni, consulta la guida alla migrazione.

Gli script Google Ads ti consentono di accedere alle estensioni degli annunci supportate nel tuo account. Ad esempio, il seguente snippet di codice accede ai sitelink:

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

Puoi recuperare altre estensioni annuncio supportate in modo simile utilizzando i rispettivi iteratori.

Creazione

Gli script Google Ads ti consentono di creare estensioni annuncio supportate. Ad esempio, il seguente snippet di codice utilizza un generatore di numeri di telefono per creare un numero di telefono nel tuo account:

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

Quando viene chiamato build(), il numero di telefono viene creato nell'account, ma non verrà visualizzato accanto agli annunci. Devi prima aggiungerlo a una campagna o a un gruppo di annunci:

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

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

Le altre estensioni degli annunci supportate possono essere create e associate alle campagne o ai gruppi di annunci nello stesso modo con i rispettivi costruttori.

Visualizzazione delle statistiche

Gli script Google Ads consentono di accedere alle statistiche delle estensioni annuncio supportate a livello di account, campagna o gruppo di annunci.

Ad esempio, per ottenere le statistiche dei 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());

In modo simile, puoi accedere alle statistiche relative ad altre estensioni annuncio supportate.

Modificare le estensioni annuncio

Le estensioni degli annunci supportate esistenti possono essere modificate con gli script Google Ads. Ad esempio, il seguente snippet di codice modifica un sitelink esistente:

// 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"

Nota: se modifichi un Sitelink, la modifica colpirà gli annunci pubblicati in tutte le campagne e i gruppi di annunci a cui è associato il sitelink. Questa regola si applica se hai recuperato il sitelink direttamente dall'account, da una CampaignSitelink di una campagna associata o da un AdGroupSitelink di un gruppo di annunci associato. L'esempio di codice precedente mostra questo comportamento.

Gli stessi concetti si applicano alle altre estensioni degli annunci supportate.

Accedere alle estensioni degli annunci a livello di gruppo di annunci

Gli script Google Ads ti consentono di accedere alle estensioni annuncio a livello di gruppo di annunci. La seguente chiamata al metodo restituirà i numeri di telefono che sono stati aggiunti esplicitamente a un gruppo di annunci. Tieni presente che se sono stati aggiunti numeri di telefono alla campagna a cui appartiene il gruppo di annunci, la seguente chiamata al metodo non li restituirà anche quando i numeri di telefono saranno idonei a essere mostrati negli annunci pubblicati da questo gruppo di annunci.

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

È possibile accedere alle altre estensioni annuncio supportate a livello di gruppo di annunci in modo simile.

Accedere alle estensioni annuncio a livello di account

Gli script Google Ads ti consentono di accedere alle estensioni dell'annuncio a livello di account. I callout, le app mobile e le recensioni possono essere aggiunti come estensioni dell'annuncio a livello di account, ma i sitelink e i numeri di telefono a livello di account non sono disponibili. La chiamata al metodo seguente restituirà i callout aggiunti esplicitamente al tuo account.

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

In modo simile, puoi accedere alle app mobile e alle recensioni a livello di account.

L'aggiunta di estensioni annuncio a livello di account è simile all'aggiunta di estensioni annuncio a livello di campagna o di gruppo di annunci. L'esempio seguente mostra come aggiungere un'estensione callout a livello di account:

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

Le app mobile e le recensioni a livello di account possono essere aggiunte in modo simile.

Rimozione delle estensioni annuncio della campagna, del gruppo di annunci e dell'account

Le estensioni annuncio supportate possono essere rimosse dalle campagne e dai gruppi di annunci a livello di account. Gli script Google Ads non supportano la rimozione simultanea delle estensioni annuncio da un account.

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

Analogamente, per rimuovere un'app mobile a livello di gruppo di annunci o account:

// 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 tutte le app mobile vengono rimosse da una campagna, la campagna non avrà più un'estensione per app mobile. Per rimuovere tutte le app mobile dalla campagna, devi recuperare l'elenco delle app mobile per la campagna e rimuoverle una alla volta. La procedura è la stessa per le altre estensioni degli annunci supportate.