Tipi di annunci

Google Ads supporta una varietà di tipi di annunci, ad esempio 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 il newAd() metodo sulle AdGroup istanze. Viene restituito un AdBuilderSpace che crea builder per i tipi di annunci supportati.

Il seguente snippet mostra come creare un annuncio adattabile della rete di ricerca:

let adOperation = adGroup.newAd().responsiveSearchAdBuilder()
    .withHeadlines(["Headline 1", "Headline 2", "Headline 3"])
    .withDescriptions(["Description 1", "Description 2"])
    .withFinalUrl("http://www.example.com")
    .withPath1("path1")
    .withPath2("path2")
    .build();

Ispezione

Alcune informazioni associate a tutti i tipi di annunci 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 i titoli di un annuncio adattabile della rete di ricerca, utilizza il asType() metodo per creare un AdViewSpace. In questo modo, puoi accedere a una versione estesa di Ad che espone metodi specifici per il tipo di annuncio.

Il seguente snippet recupera i titoli di tutti gli annunci adattabili della rete di ricerca:

const iterator = AdsApp.ads().withCondition("Type = RESPONSIVE_SEARCH_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
}

Tieni presente che la condizione Type = RESPONSIVE_SEARCH_AD garantisce che ogni annuncio dell'iteratore sia un annuncio adattabile della rete di ricerca. Se tenti di visualizzare un annuncio con un tipo errato, si verifica 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 Ad.isType() metodo:

if (ad.isType().responsiveSearchAd()) {
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
  let descriptions = responsiveSearchAd.getDescriptions();
}

Sebbene non sia possibile filtrare gli annunci in base al testo del titolo utilizzando i selettori standard, puoi filtrarli in JavaScript dopo averli recuperati:

const iterator = AdsApp.ads().withCondition("Type = RESPONSIVE_SEARCH_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
  // Filter for ads containing a specific headline.
  if (headlines.some(h => h.getText().includes("Special Offer"))) {
    console.log(`Found ad with ID ${ad.getId()}`);
  }
}

Report

La visualizzazione ad_group_ad può essere utilizzata per eseguire query sui campi degli annunci oltre alle statistiche regolari. Ad esempio, puoi filtrare in base al tipo di annuncio utilizzando ad_group_ad.ad.type. Il seguente snippet mostra come recuperare le statistiche per tutti gli annunci adattabili della rete di ricerca:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
          "ad_group_ad.ad.id, " +
          "metrics.clicks, " +
          "metrics.impressions, " +
          "metrics.cost " +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.ad.type = 'RESPONSIVE_SEARCH_AD' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let adId = row.adGroupAd.ad.id;
  let clicks = row.metrics.clicks;
  ...
}

Filtrare in base al contenuto degli asset

Per filtrare gli annunci adattabili della rete di ricerca in base al contenuto dei titoli o delle descrizioni su larga scala, utilizza la ad_group_ad_asset_view risorsa. Questa visualizzazione tratta ogni titolo e descrizione come una riga separata, consentendoti di filtrare in base al testo dell'asset.

Il seguente snippet recupera le statistiche per tutti gli annunci adattabili della rete di ricerca che contengono un titolo specifico:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad.id, " +
          "asset.text_asset.text, " +
          "metrics.clicks, " +
          "metrics.impressions " +
  "FROM ad_group_ad_asset_view " +
  "WHERE asset.text_asset.text LIKE '%Special Offer%' " +
    "AND ad_group_ad_asset_view.field_type = 'HEADLINE'");

while (results.hasNext()) {
  let row = results.next();
  let adId = row.adGroupAd.ad.id;
  let text = row.asset.textAsset.text;
  let clicks = row.metrics.clicks;
  console.log(`Ad ID ${adId} with headline "${text}" had ${clicks} clicks.`);
}

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