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 del tuo account e altro ancora. L'infrastruttura di generazione dei report è supportata da l'API Google Ads e utilizza GAQL per specificare i campi, le metriche e le condizioni che vuoi impostare.

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.

In 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()
Restituirà una rappresentazione piatta, simile a un dizionario, dei risultati di ricerca. Puoi accedere ai campi come se utilizzassi un dizionario, ad esempio row["campaign.id"] e row["metrics.impressions"] direttamente. Utilizzando questo formato, puoi esportare i risultati direttamente in un foglio di lavoro utilizzando il metodo exportToSheet(). Questo non è il formato predefinito in cui l'API Google Ads restituisce i risultati, pertanto in alcuni casi alcuni campi potrebbero non essere disponibili in questo formato. In questo caso, devi utilizzare search invece.
AdsApp.search()
Restituirà un elenco di oggetti GoogleAdsRow, che hanno vari campi, ognuno dei quali può avere sotto-campi. Pertanto, per recuperare i dati, devi accedere a row.campaign.id e row.metrics.impressions. In genere, questo formato è più utile se prevedi di elaborare i dati a livello di programmazione e alcuni campi potrebbero essere disponibili solo nel formato search se non possono essere convertiti in una rappresentazione piatta.

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"];
}

Per tutti i dettagli sull'utilizzo di questa visualizzazione, consulta la AdsApp.report documentazione.

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 per tutte le impostazioni possibili.Adsapp.search