Tipi di annunci

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 gli script Google Ads. Per una panoramica di tutti i tipi di annunci supportati da Google Ads, consulta la guida all'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 mostra 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 per il tipo di annuncio, ad esempio la descrizione di un annuncio di testo espanso, utilizza il metodo asType() per creare un 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. Il tentativo di visualizzare un annuncio con un tipo scorretto causerà un errore che interrompe l'esecuzione dello script, pertanto è importante visualizzare i campi specifici per tipo solo quando il tipo di annuncio è noto.

Lo snippet seguente mostra come determinare se un annuncio è del tipo corretto utilizzando il metodo Ad.isType():

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

Rapporti

La visualizzazione ad_group_ad può essere utilizzata anche per eseguire query sui campi degli annunci specifici per tipo, oltre alle statistiche standard, 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;
  ...
}

Per ulteriori informazioni sui report negli script, consulta la guida ai report.