Segnalazione

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

Confronto tra report e ricerca

Esistono due meccanismi principali per la segnalazione. Entrambi accettano gli stessi tipi di query e si differenziano 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 tuoi 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 con il metodo exportToSheet(). Non si tratta del formato nativo i cui risultati vengono restituiti dall'API Google Ads. Pertanto, in alcuni casi, alcuni campi potrebbero non essere disponibili in questo formato. In questo caso, dovrai utilizzare invece search.

AdsApp.search()

Verrà restituito un elenco di oggetti GoogleAdsRow, che hanno vari campi, ognuno dei quali può avere campi secondari. Di conseguenza, accedi a row.campaign.id e row.metrics.impressions per recuperare i dati. In genere, questa operazione è 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 della 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 di 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 completa di Adsapp.search per tutte le impostazioni possibili.