Estensioni annuncio

Gli script Google Ads supportano le seguenti estensioni annuncio:

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

Per saperne di più sulle estensioni annuncio, visita il Centro assistenza.

Attenzione: le estensioni basate su asset sostituiranno presto le estensioni basate su feed. Consulta la guida alla migrazione per ulteriori informazioni.

Gli script Google Ads ti consentono di accedere alle estensioni annuncio supportate nel tuo account. Ad esempio, il seguente snippet di codice consente di accedere 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 consentono di creare estensioni annuncio supportate. Ad esempio, il seguente snippet di codice utilizza uno strumento per la creazione 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 il numero build(), nell'account viene creato il numero di telefono, ma non viene ancora mostrato insieme 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);

Altre estensioni annuncio supportate possono essere create e associate a campagne o gruppi di annunci nello stesso modo con i rispettivi sviluppatori.

Recupero delle statistiche in corso...

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

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

Puoi accedere alle statistiche relative ad altre estensioni annuncio supportate in modo simile.

Modifica delle estensioni annuncio

Le estensioni annuncio 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: la modifica di un Sitelink influirà sulla pubblicazione degli annunci in tutte le campagne e tutti i gruppi di annunci a cui è associato il sitelink. Questa regola si applica sia che tu abbia recuperato il sitelink direttamente dall'account, da un CampaignSitelink di una campagna associata o da un AdGroupSitelink di un gruppo di annunci associato. L'esempio di codice precedente dimostra questo comportamento.

Gli stessi concetti valgono per le altre estensioni annuncio supportate.

Accesso alle estensioni annuncio a livello di gruppo di annunci

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

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

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

Accesso alle estensioni annuncio a livello di account

Gli script Google Ads consentono di accedere alle estensioni annuncio a livello di account. Callout, app mobile e recensioni possono essere aggiunti come estensioni annuncio a livello di account, ma non sono disponibili sitelink e numeri di telefono a livello di account. La seguente chiamata al metodo 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();

Puoi accedere alle recensioni e alle app mobile a livello di account in modo simile.

L'aggiunta di estensioni annuncio a livello di account è simile all'aggiunta di estensioni annuncio a livello di campagna o di gruppo di annunci. Il seguente esempio 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 a livello di campagna, gruppo di annunci e account

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

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