Che cos'è l'API di reporting delle canalizzazioni multicanale - Panoramica

Questo documento fornisce una panoramica generale dell'API di reporting Canalizzazioni multicanale di Google Analytics. Per un riferimento dettagliato dell'API, leggi la Guida di riferimento.

Introduzione

L'API di reporting Canalizzazioni multicanale ti consente di richiedere i dati delle canalizzazioni multicanale per un utente autenticato. I dati derivano dai dati dei percorsi di conversione, che mostrano le interazioni degli utenti con varie sorgenti di traffico in più sessioni prima della conversione. In questo modo puoi analizzare in che modo più canali di marketing influenzano le conversioni nel tempo. Per ulteriori informazioni sui dati disponibili, consulta Informazioni sulle canalizzazioni multicanale e Informazioni sui dati delle canalizzazioni multicanale.

Con l'API di reporting Canalizzazioni multicanale puoi:

  • Crea report personalizzati utilizzando i dati delle canalizzazioni multicanale. Ad esempio, puoi utilizzare i dati dei Principali percorsi di conversione per generare report su attributi come la posizione relativa delle interazioni in un percorso di conversione.
  • Integrare i dati delle canalizzazioni multicanale con i tuoi dati aziendali. Ad esempio, puoi correlare i dati sulle conversioni online con i dati sulle vendite offline e i dati di costo dei media per ottenere un quadro più completo del ROI relativo al marketing.
  • Visualizza le canalizzazioni multicanale in nuovi ambienti. Ad esempio, potresti creare visualizzazioni e altre presentazioni dei dati che comunicano il valore dei diversi canali di marketing nel generare conversioni.

Panoramica concettuale

I concetti fondamentali alla base dell'API di reporting Canalizzazioni multicanale sono:

  • Relazione tra i report e gli utenti e le viste (profili).
  • La struttura di un report e come creare query.
  • Dati del percorso di conversione e concetti di attribuzione.
  • Utilizzo della risposta dell'API.

Report, utenti e visualizzazioni (profili)

Per richiedere i dati del report per un utente, l'applicazione deve identificare l'utente e specificare una vista (profilo) per la quale recuperare i dati. Un utente viene identificato ottenendo le credenziali di autorizzazione e passandole in ogni richiesta API. Una vista (profilo) è identificata da un ID vista (profilo). Le viste (profili), tra le altre entità, fanno parte della gerarchia di configurazione di Google Analytics. L'applicazione può utilizzare l' API di gestione per attraversare questa gerarchia e ottenere un ID vista (profilo).

Esecuzione di query su dimensioni e metriche

Esegui una query nell'API per i dati del report di Google Analytics, che sono costituiti da dimensioni e metriche. Le metriche sono le singole misurazioni dell'attività utente, come i conteggi e i valori delle conversioni. Le dimensioni suddividono le metriche in base ad alcuni criteri comuni e possono essere valori primitivi che rappresentano singoli eventi di interazione su percorsi di conversione oppure sequenze che rappresentano la serie di eventi di interazione di interi percorsi di conversione.

Utilizza la guida di riferimento per dimensioni e metriche per esplorare tutte le dimensioni e metriche esposte tramite l'API. Inoltre, consulta la Guida di riferimento all'API Multi-Channel Channel Reporting API per scoprire di più su come specificare dimensioni e metriche in una query API.

Dati dei percorsi di conversione e concetti di attribuzione

I report Canalizzazioni multicanale vengono generati dai percorsi di conversione, ovvero le sequenze di interazioni (ad es. clic/referral dai canali) che hanno portato a ciascuna conversione e transazione. I percorsi di conversione vengono raccolti tramite il cookie di Google Analytics che registra le interazioni dello stesso browser e della stessa macchina. I dati di Canalizzazioni multicanale combinano i dati sulle conversioni di Google Analytics con la sequenza di interazioni acquisita nel cookie.

Le query del report Canalizzazioni multicanale restituiscono i dati in base a un insieme campione di un milione di percorsi di conversione. Se l'intervallo di date include un conteggio totale delle conversioni pari o inferiore a 1 milione, il report non sarà campionato. In caso contrario, verrà utilizzato un insieme campione di 1 milione per generare i risultati. Ciò è in contrasto con la funzionalità di generazione di report principali, che campiona sulla base delle sessioni. Per ulteriori informazioni sui dati e sui concetti correlati, consulta Informazioni sui dati delle canalizzazioni multicanale. Puoi anche trovare utile leggere l'articolo Analisi dei contributi dei canali, in cui vengono definiti i concetti fondamentali come le conversioni indirette.

Utilizzo dei report

I dati restituiti dall'API possono essere considerati come una tabella con un'intestazione e un elenco di righe. Ogni risposta dell'API è composta da un'intestazione che descrive il nome e il tipo di dati di ogni colonna. La risposta contiene anche un elenco di righe, in cui ogni riga è un elenco di celle con i dati nello stesso ordine delle intestazioni. Per ulteriori informazioni sulla risposta dell'API, consulta la guida di riferimento dell'API di reporting di Canalizzazioni multicanale.

Ogni valore di cella contiene un valore primitivo di tipo stringa o un valore del percorso di conversione. Il valore del percorso di conversione è un array di oggetti che rappresentano tutti i nodi di quel percorso. Possiamo utilizzare le informazioni sul tipo nelle intestazioni di colonna per analizzare il valore di ogni cella in base al tipo appropriato. Ulteriori informazioni sono disponibili qui.

Criteri per le quote

La query dati Canalizzazioni multicanale gestisce milioni di operazioni. Per impedire al sistema di ricevere più operazioni di quante ne possa gestire e per garantire una distribuzione equa delle risorse di sistema, è necessario impiegare un sistema di quote. Per ulteriori dettagli, consulta la guida su limiti e quota.

Passaggi successivi

Ora che sai come funziona l'API, abbiamo una serie di risorse per aiutarti a iniziare: