Rapporti

I report forniscono informazioni su tutte le diverse risorse del tuo account. Puoi recuperare informazioni su campagne, gruppi di annunci e relative statistiche, sulla cronologia delle modifiche per il tuo account e altro ancora. L'infrastruttura di generazione dei report è supportata dall'API Google Ads e utilizza GAQL per specificare i campi, le metriche e le condizioni da impostare.

Report e ricerca

Esistono due meccanismi principali per la generazione di report. Entrambi accettano gli stessi tipi di query e differiscono principalmente per il modo in cui restituiscono i risultati.

Per entrambi i casi, utilizzeremo la seguente query:

SELECT
  campaign.id,
  campaign.status,
  metrics.clicks,
  metrics.impressions,
  customer.id
FROM campaign
WHERE
  metrics.impressions > 0

AdsApp.report()

Verrà restituita una rappresentazione piatta, simile a un dizionario, dei risultati di ricerca. Puoi accedere ai campi come se utilizzassi un dizionario, ad esempio direttamente row["campaign.id"] e row["metrics.impressions"]. Utilizzando questo formato, puoi esportare i risultati direttamente in un foglio di lavoro utilizzando il metodo exportToSheet(). Non si tratta del formato nativo in cui vengono riportati i risultati dall'API Google Ads, pertanto in alcuni casi alcuni campi potrebbero non essere disponibili in questo formato. In questo caso, dovresti utilizzare search.

AdsApp.search()

Verrà restituito un elenco di oggetti GoogleAdsRow, che hanno vari campi, ciascuno dei quali può avere sottocampi. Dovresti quindi accedere a row.campaign.id e row.metrics.impressions per recuperare i dati. In genere, questo è più utile se prevedi di elaborare i dati in modo programmatico e alcuni campi potrebbero essere disponibili solo nel formato search se non possono essere convertiti in una rappresentazione piatta.

Nota: quando utilizzi AdsApp.search, i campi restituiti saranno in lowerCamelCase anche se sono specificati in underscore_case nella query. Ad esempio, se il campo nella query è campaign.start_date, per recuperare il risultato dalla riga devi utilizzare campaign.startDate.

Esempio di report

let report = AdsApp.report(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

let rows = report.rows();
while (rows.hasNext()) {
    let row = rows.next();
    let query = row["search_term_view.search_term"];
    let impressions = row["metrics.impressions"];
}

Consulta la documentazione di AdsApp.report per informazioni dettagliate sull'utilizzo di questa visualizzazione.

Esempio di ricerca

let search = AdsApp.search(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

while (search.hasNext()) {
    let row = search.next();
    let query = row.searchTermView.searchTerm;
    let impressions = row.metrics.impressions;
}

Consulta la documentazione completa di Adsapp.search per tutte le impostazioni possibili.