Tipi di annunci

Google Ads supporta diversi tipi di annunci, tra cui annunci di testo, illustrati e per dispositivi mobili. Questa guida illustra 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 alle API.

Nota: gli annunci display adattabili hanno ottenuto supporto per più asset di testo, immagine e video nello stesso annuncio. Gli annunci display adattabili precedenti non supportano queste nuove funzionalità. Gli annunci nuovi e precedenti continueranno a essere pubblicati come di consueto, ma l'API per il recupero e la manipolazione degli annunci display adattabili è cambiata. Consulta la sezione Gestire gli annunci display adattabili precedenti.

Creazione

Gli script possono creare annunci utilizzando il metodo newAd() sulle istanze AdGroup. Viene restituito un elemento AdBuilderSpace che crea dei builder per i tipi di annuncio 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 in una Ad, ad esempio l'ID e lo stato di approvazione di un annuncio. Inoltre, qualsiasi annuncio può essere messo in pausa, attivato o rimosso.

Per accedere a campi specifici per il tipo di annuncio, come la descrizione di un annuncio di testo espanso, utilizza il metodo asType() per creare un AdViewSpace. Ciò fornisce l'accesso a una versione estesa di Ad che espone metodi specifici per tipo.

Il seguente snippet restituisce 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 dell'iteratore sia un annuncio di testo espanso. Il tentativo di visualizzare un annuncio di tipo errato causerà un errore che interrompe l'esecuzione dello script, pertanto è importante visualizzare i campi specifici del tipo solo quando il tipo di annuncio è noto.

Lo snippet riportato di seguito 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();
}

Report

La visualizzazione ad_group_ad può essere utilizzata anche per eseguire query su campi di annunci specifici del tipo oltre a 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 "Vendite scontate" 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.