Google Ads accepte différents types d'annonces, comme les annonces textuelles, illustrées et pour mobile. Ce guide vous explique comment créer et récupérer des annonces, ainsi que générer des rapports les concernant à 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. Cela renvoie un AdBuilderSpace qui crée des outils de création pour les types d'annonces compatibles.
L'extrait de code suivant montre comment créer une annonce textuelle agrandie:
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, telles que l'ID et l'état d'approbation d'une annonce, sont immédiatement disponibles dans un Ad. De plus, chaque annonce peut être mise en veille, activée ou supprimée.
Pour accéder aux champs spécifiques au type d'une annonce, tels que la description d'une annonce textuelle agrandie, utilisez la méthode asType() afin de créer un 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. Si vous tentez d'afficher une annonce dont le type est incorrect, vous obtiendrez une erreur qui interrompra l'exécution de votre script. Il est donc 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 une annonce est du type approprié à l'aide de la méthode Ad.isType():
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 à un type en plus des statistiques standards, 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 agrandies dont le titre 1 contient "Réductions" :
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.