Tipi di annunci

Google Ads supporta diversi tipi di annunci, ad esempio annunci di testo, illustrati e mobile. 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 il metodo newAd() sugli oggetti AdGroup. Viene restituito un AdBuilderSpace che crea generatori per i 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, come l'ID e lo stato di approvazione di un annuncio, sono immediatamente disponibili in una Ad. Inoltre, qualsiasi annuncio può essere messo in pausa, attivato o 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. In questo modo, puoi accedere a una versione estesa di Ad che espone metodi specifici per tipo.

Lo snippet seguente recupera 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 garantisce che ogni annuncio dello iteratore sia 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. Lo snippet seguente mostra come recuperare le statistiche di 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.