Tipi di annunci

Google Ads supporta una serie di tipi di annunci, come 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 annuncio supportati da Google Ads, consulta la guida API.

Creazione

Gli script possono creare annunci utilizzando il metodo newAd() sulle istanze AdGroup. Viene restituito un AdBuilderSpace che crea 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 da un 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 ai campi specifici di un tipo di annuncio, ad esempio la descrizione di un annuncio di testo espanso, utilizza il metodo asType() per creare un AdViewSpace. In questo modo si accede a una versione estesa dell'API Ad che espone metodi specifici per il tipo.

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

Il seguente snippet 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 regolari, ad esempio ad_group_ad.expanded_text_ad.headline_part1. Il seguente snippet mostra come recuperare le statistiche di tutti gli annunci di testo espansi che contengono "Vendite con sconto" 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 sulla generazione di report negli script, consulta la guida ai report.