Types d'annonce

Google Ads est compatible avec différents types d'annonces, comme les annonces textuelles, illustrées et pour mobile. Ce guide explique comment créer, récupérer et créer des rapports sur les annonces à l'aide de scripts Google Ads. Pour obtenir une présentation de tous les types d'annonces compatibles avec Google Ads, consultez le guide de l'API.

Création

Les scripts peuvent créer des annonces à l'aide de la méthode newAd() sur les instances AdGroup. Cette opération renvoie une AdBuilderSpace qui crée des compilateurs pour types d'annonces pris en charge.

L'extrait de code suivant montre comment créer une annonce textuelle étendue :

let adOperation = adGroup.newAd().expandedTextAdBuilder()
    .withHeadlinePart1("First headline part")
    .withHeadlinePart2("Second headline part")
    .withDescription("Ad description")
    .withFinalUrl("http://www.example.com")
    .withPath1("path1") // optional
    .withPath2("path2") // optional
    .build();

Inspection

Certaines informations associées à tous les types d'annonces sont immédiatement disponibles à partir d'un Ad, par exemple l'identifiant et l'état d'approbation de l'annonce. Vous pouvez également mettre en veille, activer ou supprimer n'importe quelle annonce.

Pour accéder à des champs spécifiques à un type d'annonce, tels que le champ description, utilisez l'élément asType() pour créer une AdViewSpace Cela permet d'accéder à une version étendue de Ad qui expose des méthodes spécifiques au type.

L'extrait de code suivant permet d'obtenir la description de chaque annonce textuelle agrandie:

const iterator = AdsApp.ads().withCondition("Type = EXPANDED_TEXT_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let expandedTextAd = ad.asType().expandedTextAd();
  let description = expandedTextAd.getDescription();
}

Notez que la condition Type = EXPANDED_TEXT_AD garantit que chaque annonce de l'itérateur est une annonce textuelle agrandie. Tentative d'affichage d'une annonce présentant une erreur génère une erreur qui arrête l'exécution de votre script. important de n'afficher les champs spécifiques au type que lorsque le type d'une annonce est connu.

L'extrait de code suivant montre comment déterminer si le type d'une annonce est correct. à l'aide du Ad.isType() méthode:

if (ad.isType().expandedTextAd()) {
  let expandedTextAd = ad.asType().expandedTextAd();
  let headlinePart1 = expandedTextAd.getHeadlinePart1();
  let headlinePart2 = expandedTextAd.getHeadlinePart2();
}

Rapports

La vue ad_group_ad peut également être utilisée pour interroger des champs d'annonces spécifiques au type en plus des statistiques régulières, telles que ad_group_ad.expanded_text_ad.headline_part1. L'extrait de code suivant montre comment récupérer les statistiques de toutes les annonces textuelles étendues contenant "Promotions" dans le titre 1 :

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
         "ad_group_ad.id, " +
         "ad_group_ad.expanded_text_ad.headline_part1, " +
         "ad_group_ad.expanded_text_ad.headline_part2, " +
         "metrics.clicks, " +
         "metrics.impressions, " +
         "metrics.cost" +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.expanded_text_ad.headline_part1 = 'Discount Sales' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let headlinePart1 = row.adGroupAd.expandedTextAd.headlinePart1;
  let headlinePart2 = row.adGroupAd.expandedTextAd.headlinePart2;
  ...
}

Pour en savoir plus sur la création de rapports dans les scripts, consultez le guide des rapports.