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 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.