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 annuncio, visita il Centro assistenza.

Gli script Google Ads consentono di accedere alle estensioni annuncio 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 consentono di creare estensioni annuncio supportate. Ad esempio, lo snippet di codice seguente 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à ancora visualizzato 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 strumenti di creazione.

Visualizzare le statistiche

Gli script Google Ads ti consentono di accedere alle statistiche per le 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());

Le statistiche per altre estensioni annuncio supportate sono accessibili 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 modificherà 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 interesserà la pubblicazione degli annunci in tutte le campagne e i gruppi di annunci a cui è associato il sitelink. Questa regola si applica indipendentemente dal fatto 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 mostra questo comportamento.

Gli stessi concetti si applicano ad altre estensioni annuncio supportate.

Accesso alle estensioni annuncio 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 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 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();

È possibile accedere ad 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 consentono di accedere alle estensioni dell'annuncio a livello di account. Callout, app mobile e recensioni possono essere aggiunti come estensioni annuncio a livello di account, ma sitelink e numeri di telefono a livello di account non sono disponibili. 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();

È possibile accedere alle app mobile e alle recensioni 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 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 di tutte le 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 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 won't
// 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 app mobile. Per rimuovere tutte le app mobile dalla tua campagna, devi recuperare l'elenco delle app mobile per quella campagna e rimuoverle una alla volta. La procedura è la stessa per le altre estensioni annuncio supportate.