Rapporti

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

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 e 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 vengono restituiti 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, ognuno 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 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 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.