Google Ads supporta vari tipi di annunci, come annunci di testo, illustrati e per dispositivi mobili. Questa guida spiega come creare, recuperare e generare report sugli annunci utilizzando Google Ads script. Per una panoramica di tutti i tipi di annunci supportati da Google Ads, consulta la Guida alle API.
Creazione
Gli script possono creare annunci utilizzando
newAd()
metodo attivo
AdGroup
di Compute Engine. Questo restituisce un
AdBuilderSpace
che crea creator
tipi di annunci supportati.
Il seguente snippet illustra come creare un annuncio di testo espanso:
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();
Ispezione
Alcune informazioni associate a tutti i tipi di annuncio sono immediatamente disponibili da un
Ad
, ad esempio
l'ID e lo stato di approvazione dell'annuncio. Inoltre, qualsiasi annuncio può essere messo in pausa, attivato
rimosso.
Per accedere ai campi specifici del tipo di annuncio, come il campo
descrizione, utilizza
asType()
per creare
AdViewSpace
.
Consente di accedere a una versione estesa del
Ad
che espone
specifici del tipo.
Il seguente snippet riporta la descrizione di ogni annuncio di testo espanso:
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();
}
Tieni presente che la condizione Type = EXPANDED_TEXT_AD
assicura che ogni annuncio dal
è un annuncio di testo espanso. Stai tentando di visualizzare un annuncio con un errore
causerà un errore che interrompe l'esecuzione dello script, quindi
è importante visualizzare campi specifici del tipo solo quando il tipo di annuncio è noto.
Il seguente snippet mostra come determinare se un annuncio è del tipo corretto
utilizzando
Ad.isType()
:
if (ad.isType().expandedTextAd()) {
let expandedTextAd = ad.asType().expandedTextAd();
let headlinePart1 = expandedTextAd.getHeadlinePart1();
let headlinePart2 = expandedTextAd.getHeadlinePart2();
}
Rapporti
La vista ad_group_ad
può anche essere
utilizzati per eseguire query su campi annuncio specifici del tipo oltre a normali statistiche, come
ad_group_ad.expanded_text_ad.headline_part1
.
Il seguente snippet mostra come recuperare le statistiche per tutti gli annunci di testo espansi
che contengono "Sconti" nel titolo 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;
...
}
Consulta la guida ai report per ulteriori informazioni sui report negli script.