Che cos'è l'API di reporting Canalizzazioni multicanale - Panoramica

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

Introduzione

L'API di reporting delle 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 dettagli sui dati disponibili, consulta gli articoli 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 di Canalizzazioni multicanale. Ad esempio, puoi utilizzare i dati Principali percorsi di conversione per generare report su attributi come la posizione relativa delle interazioni in un percorso di conversione.
  • Integrare i dati di Canalizzazioni multicanale con i dati aziendali. Ad esempio, potresti correlare i dati sulle conversioni online con i dati sulle vendite offline e i dati sul costo dei media per avere 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 di diversi canali di marketing nel generare conversioni.

Panoramica concettuale

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

  • Correlazione tra i report e gli utenti e le visualizzazioni (profili).
  • La struttura di un report e come creare query.
  • Dati dei percorsi di conversione e concetti di attribuzione.
  • Utilizzo della risposta dell'API.

Report, utenti e visualizzazioni (profili)

Per richiedere i dati dei 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. La tua 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 consistono in 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-ChannelFunnel Reporting per scoprire come specificare dimensioni e metriche in una query API.

Dati del percorso 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 acquisite nel cookie.

Le query del report Canalizzazioni multicanale restituiscono i dati basati su un insieme campione di 1 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, per generare i risultati verrà utilizzato un insieme campione di 1 milione. Ciò è in contrasto con la funzionalità di generazione di report di base, che campiona sulla base delle sessioni. Per ulteriori informazioni sui dati e sui concetti correlati, consulta Informazioni sui dati delle canalizzazioni multicanale. Potresti trovare utile anche leggere l'articolo Analisi dei contributi del canale, 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, dove ogni riga rappresenta un elenco di celle con dati nello stesso ordine delle intestazioni. Per ulteriori informazioni sulla risposta dell'API, leggi la Guida di riferimento dell'API Multi-Channel Canal Reporting API.

Ogni valore di cella contiene un valore primitivo di tipo stringa o un valore del percorso di conversione. Il valore di questo 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. Scopri di più qui.

Criteri per le quote

La query sui dati Canalizzazioni multicanale gestisce milioni di operazioni. Per evitare che il sistema riceva più operazioni di quante ne possa gestire e per garantire una distribuzione equa delle risorse di sistema, è necessario utilizzare un sistema di quote. Per ulteriori dettagli, leggi la guida su limiti e quota.

Passaggi successivi

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