Rapporti

I report forniscono informazioni su tutte le diverse risorse del tuo account. Puoi recuperare informazioni su campagne, gruppi di annunci e relative statistiche, modificare la cronologia del 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 che vuoi impostare.

Report e ricerca

Esistono due meccanismi principali per la segnalazione. 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()

Verrà restituita 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 nativo in cui vengono restituiti i risultati dall'API Google Ads, quindi 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 dei sottocampi. 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 in modo programmatico e alcuni campi potrebbero essere disponibili solo nel formato search se non possono essere convertiti in una rappresentazione semplice.

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

Per informazioni dettagliate sull'utilizzo di questa visualizzazione, consulta la documentazione AdsApp.report.

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