Reporting

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

Confronto tra report e ricerca

I meccanismi principali per la segnalazione sono due. Entrambi accettano gli stessi tipi di query e si differenziano principalmente nella modalità di restituzione dei 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 della tua ricerca, simile a un dizionario che consentono di analizzare i dati e visualizzare i risultati. Puoi accedere ai campi come se stessi usando un dizionario, ad esempio row["campaign.id"] e row["metrics.impressions"] direttamente. Utilizzando questo puoi esportare i risultati direttamente in un foglio di lavoro utilizzando exportToSheet(). Questo non è il formato nativo che genera restituiti dall'API Google Ads; pertanto, in alcuni casi alcuni campi potrebbero non essere disponibili in questo formato. In questo caso, devi usare invece il criterio search.

AdsApp.search()

Viene restituito un elenco di GoogleAdsRow oggetti con vari campi, ognuno dei quali può avere sottocampi. Quindi, accedi a row.campaign.id e row.metrics.impressions per recuperare i dati. Questo è generalmente più utile se intendi elaborare i dati in modo programmatico. Alcuni campi possono essere disponibili nel formato search se non possono essere convertiti in un flat una rappresentazione visiva.

di Gemini Advanced.

.

Nota: quando utilizzi AdsApp.search, i campi restituiti saranno in lowerCamelCase anche se sono specificati in underscore_case nel query. Ad esempio, se il campo della query è campaign.start_date, per recuperare il risultato dalla riga, devi usare 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"];
}

Dai un'occhiata AdsApp.report documentazione per i dettagli completi sull'utilizzo di questa visualizzazione.

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