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"]
erow["metrics.impressions"]
direttamente. Utilizzando questo formato, puoi esportare i risultati direttamente in un foglio di lavoro con il metodoexportToSheet()
. 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 invecesearch
. AdsApp.search()
- Verrà restituito un elenco di oggetti
GoogleAdsRow
, che hanno vari campi, ognuno dei quali può avere campi secondari. Di conseguenza, accedi arow.campaign.id
erow.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 formatosearch
se non possono essere convertiti in una rappresentazione semplice.
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.