Google Ads accepte différents types d'annonces, telles que les annonces textuelles, illustrées et pour mobile. Ce guide vous explique comment créer des annonces, les récupérer et générer des rapports les concernant à l'aide de Google Ads. les scripts. Pour obtenir un aperçu de tous les types d'annonces acceptés par Google Ads, consultez le Guide de l'API
Création
Les scripts peuvent créer des annonces à l'aide des
newAd()
méthode activée
AdGroup
Compute Engine. 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 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 sont immédiatement disponibles à partir d'un
Ad
, par exemple
l'identifiant et l'état d'approbation de l'annonce. De plus, n'importe quelle annonce peut être mise en veille, activée
supprimés.
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
Vous pouvez ainsi accéder à une version étendue
Ad
qui expose
méthodes spécifiques à un 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 la
iterator est une annonce textuelle grand format. Tentative d'affichage d'une annonce présentant une erreur
génère une erreur qui arrête l'exécution du 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és pour interroger des champs d'annonce spécifiques au type de données, en plus des statistiques classiques,
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.
contenant "Ventes discount" 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;
...
}
Consultez le guide des rapports pour connaître pour en savoir plus sur la création de rapports dans les scripts.