Extensions d'annonce

Les scripts Google Ads sont compatibles avec les extensions d'annonces suivantes :

• Applications mobiles
• Numéros de téléphone
• Accroches
• Prix
• Snippets
• Liens annexes

Pour en savoir plus sur les extensions d'annonces, consultez le Centre d'aide.

Attention : Les extensions basées sur les composants remplaceront bientôt les extensions basées sur les flux. Pour en savoir plus, consultez le guide de migration.

Les scripts Google Ads vous permettent d'accéder aux extensions d'annonces compatibles de votre compte. Par exemple, l'extrait de code suivant accède aux liens annexes:

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

Vous pouvez récupérer d'autres extensions d'annonces compatibles de la même manière en utilisant leurs itérateurs respectifs.

Création

Les scripts Google Ads vous permettent de créer des extensions d'annonces compatibles. Par exemple, l'extrait de code suivant utilise un outil de création de numéros de téléphone pour créer un numéro de téléphone dans votre compte :

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

Lorsque build() est appelé, le numéro de téléphone est créé dans le compte, mais il ne s'affiche pas encore à côté d'annonces. Vous devez d'abord l'ajouter à une campagne ou à un groupe d'annonces :

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

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

Vous pouvez créer et associer d'autres extensions d'annonces compatibles aux campagnes ou aux groupes d'annonces de la même manière à l'aide de leurs outils de création respectifs.

Affichage de statistiques

Les scripts Google Ads vous permettent d'accéder aux statistiques des extensions d'annonces compatibles au niveau du compte, de la campagne ou du groupe d'annonces.

Par exemple, pour obtenir les statistiques relatives aux liens annexes :

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

Vous pouvez accéder aux statistiques des autres extensions d'annonces compatibles de la même manière.

Modification des extensions d'annonce

Vous pouvez modifier les extensions d'annonce compatibles existantes à l'aide des scripts Google Ads. Par exemple, l'extrait de code suivant modifie un sitelink existant :

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

Remarque : Si vous modifiez un Sitelink, cela aura un impact sur la diffusion des annonces dans toutes les campagnes et tous les groupes d'annonces auxquels le lien annexe est associé. Cette règle s'applique que vous ayez récupéré le lien annexe directement à partir du compte, d'un CampaignSitelink d'une campagne associée ou d'un AdGroupSitelink d'un groupe d'annonces associé. L'exemple de code précédent illustre ce comportement.

Les mêmes concepts s'appliquent aux autres extensions d'annonces compatibles.

Accéder aux extensions d'annonces au niveau du groupe d'annonces

Les scripts Google Ads vous permettent d'accéder aux extensions d'annonces au niveau du groupe d'annonces. L'appel de méthode suivant renvoie les numéros de téléphone qui ont été ajoutés explicitement à un groupe d'annonces. Notez que si des numéros de téléphone ont été ajoutés à la campagne à laquelle appartient le groupe d'annonces, l'appel de la méthode ci-dessous ne les renverra pas, même s'ils sont susceptibles d'apparaître dans les annonces diffusées à partir de ce groupe d'annonces.

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

Vous pouvez accéder aux autres extensions d'annonces compatibles au niveau du groupe d'annonces de la même manière.

Accéder aux extensions d'annonce au niveau du compte

Les scripts Google Ads vous permettent d'accéder aux extensions d'annonce par compte. Vous pouvez ajouter des accroches, des applications mobiles et des avis en tant qu'extensions d'annonces au niveau du compte, mais les liens annexes et les numéros de téléphone au niveau du compte ne sont pas disponibles. L'appel de méthode suivant renvoie les accroches qui ont été explicitement ajoutées à votre compte.

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

Vous pouvez procéder de la même manière pour accéder aux applications mobiles et aux avis au niveau du compte.

L'ajout d'extensions d'annonces au niveau du compte est semblable à l'ajout d'extensions d'annonces au niveau de la campagne ou du groupe d'annonces. L'exemple suivant montre comment ajouter une extension de callout au niveau du compte :

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

Vous pouvez ajouter des applications mobiles et des avis au niveau du compte de la même manière.

Supprimer des extensions d'annonces de campagne, de groupe d'annonces et de compte

Vous pouvez supprimer les extensions d'annonces compatibles des campagnes et des groupes d'annonces au niveau du compte. Les scripts Google Ads ne permettent pas de supprimer toutes les extensions d'annonces d'un compte en une seule fois.

// 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 même, pour supprimer une application mobile au niveau d'un groupe d'annonces ou d'un compte :

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

Si vous supprimez toutes les applications mobiles d'une campagne, elle ne comportera plus d'extension pour application mobile. Pour supprimer toutes les applications mobiles de votre campagne, vous devez récupérer la liste des applications mobiles de cette campagne et les supprimer une par une. La procédure est la même pour les autres extensions d'annonces compatibles.