Extensions d'annonce

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

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

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

Les scripts Google Ads vous permettent d'accéder aux extensions d'annonce compatibles dans 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'annonce 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'annonce compatibles. Par exemple, l'extrait de code suivant utilise un générateur 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é des 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'annonce compatibles à des campagnes ou des 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'annonce 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'annonce compatibles de la même manière.

Modification des extensions d'annonce

Vous pouvez modifier les extensions d'annonce compatibles existantes à l'aide de scripts Google Ads. Par exemple, l'extrait de code suivant modifiera un lien de site 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 une incidence sur les annonces diffusées 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 depuis le compte, depuis un CampaignSitelink d'une campagne associée ou depuis 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'annonce compatibles.

Accéder aux extensions d'annonce 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é explicitement ajoutés à 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 méthode suivant ne les renverra pas, même s'ils sont éligibles à 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'annonce compatibles au niveau du groupe d'annonces de la même manière.

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

Les scripts Google Ads vous permettent d'accéder aux extensions d'annonce au niveau du compte. Vous pouvez ajouter des accroches, des applications mobiles et des avis en tant qu'extensions d'annonce 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 renverra les accroches qui ont été ajoutées explicitement à votre compte.

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

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

L'ajout d'extensions d'annonce au niveau du compte est semblable à celui d'extensions d'annonce au niveau de la campagne ou du groupe d'annonces. L'exemple suivant montre comment ajouter une extension d'accroche 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 les extensions d'annonce au niveau du compte, de la campagne et du groupe d'annonces

Vous pouvez supprimer les extensions d'annonce compatibles des campagnes et des groupes d'annonces au niveau du compte. Les scripts Google Ads ne permettent pas de supprimer les extensions d'annonce 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 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);

Si toutes les applications mobiles sont supprimées d'une campagne, celle-ci ne comportera plus d'extension d'application mobile. Pour supprimer toutes les applications mobiles de votre campagne, vous devez récupérer la liste des applications mobiles pour cette campagne et les supprimer une par une. La procédure est la même pour les autres extensions d'annonce acceptées.