Log delle modifiche all'API multicanale per i report sulle canalizzazioni multicanale di Google Analytics

Aggiorniamo periodicamente l' API di reporting Canalizzazioni multicanale di Google Analytics per offrire nuove funzionalità e correggere i difetti rilevati nelle versioni precedenti. Nella maggior parte dei casi, queste modifiche saranno trasparenti per gli sviluppatori di API. Tuttavia, a volte dobbiamo apportare modifiche che richiedono agli sviluppatori di modificare le loro applicazioni esistenti.

Questa pagina documenta le eventuali modifiche apportate all'API di reporting Canalizzazioni multicanale di Google Analytics che potrebbero influire sulla tua applicazione. Consigliamo agli sviluppatori di API di controllare periodicamente questo elenco per verificare la presenza di eventuali nuovi annunci. Puoi anche iscriverti alle modifiche tramite i feed elencati nella sezione Iscriviti di seguito.

Iscriviti ai log delle modifiche correlati

Include tutte le API di raccolta, configurazione e reporting.

Include API Core Reporting, API di reporting delle canalizzazioni multicanale e API di reporting in tempo reale.

Questa release aggiunge una nuova dimensione all'API. Consulta la Guida di riferimento a dimensioni e metriche per l'elenco completo delle definizioni.

ID transazione

  • dimensione - mcf:transactionId: l'ID transazione, fornito dal metodo di monitoraggio e-commerce, per l'acquisto nel carrello degli acquisti.

In questa release sono state aggiunte nuove dimensioni e metriche all'API. Consulta la Guida di riferimento a dimensioni e metriche per l'elenco completo delle definizioni.

Percorsi di conversione

  • dimensione - mcf:dcmAd - Nome dell'annuncio DCM dell'evento DCM (impressione o clic) corrispondente alla conversione di Google Analytics.
  • dimensione - mcf:dcmAdPath - Il percorso di conversione in cui le interazioni sul percorso sono rappresentate dagli annunci DCM.
  • dimensione - mcf:dcmAdType - Il nome del tipo di annuncio DCM dell'evento DCM (impressione o clic) corrispondente alla conversione di Google Analytics.
  • dimensione - mcf:dcmAdvertiser - Il nome dell'inserzionista DCM dell'evento DCM (impressione o clic) corrispondente alla conversione di Google Analytics.
  • dimensione - mcf:dcmAdvertiserPath. Il percorso di conversione in cui le interazioni sul percorso sono rappresentate dagli inserzionisti DCM.
  • dimensione - mcf:dcmCampaign - Il nome della campagna DCM dell'evento DCM (impressione o clic) corrispondente alla conversione di Google Analytics.
  • dimensione - mcf:dcmCampaignPath - Il percorso di conversione in cui le interazioni sul percorso sono rappresentate dalle campagne DCM.
  • dimensione - mcf:dcmCreative - Il nome della creatività DCM dell'evento DCM (impressione o clic) corrispondente alla conversione di Google Analytics.
  • dimensione - mcf:dcmCreativePath - Il percorso di conversione in cui le interazioni sul percorso sono rappresentate dalle creatività DCM.
  • dimensione - mcf:dcmCreativeVersion - La versione della creatività DCM dell'evento DCM (impressione o clic) corrispondente alla conversione di Google Analytics.
  • dimensione - mcf:dcmCreativeVersionPath: il percorso di conversione in cui le interazioni sul percorso sono rappresentate dalle versioni della creatività DCM.
  • dimensione - mcf:dcmNetwork - La rete utilizzata.
  • dimensione - mcf:dcmPlacement: il nome del posizionamento del sito DCM dell'evento DCM (impressione o clic) corrispondente alla conversione di Google Analytics.
  • dimensione - mcf:dcmPlacementPath - Il percorso di conversione in cui le interazioni sul percorso sono rappresentate dai posizionamenti DCM.
  • dimensione - mcf:dcmSite - Nome del sito DCM in cui è stata pubblicata la creatività DCM per l'evento DCM (impressione o clic) corrispondente alla conversione di Google Analytics.
  • dimensione - mcf:dcmSitePath: il percorso di conversione in cui le interazioni sul percorso sono rappresentate dai siti DCM.
  • - mcf:firstImpressionConversions - Il numero di conversioni per cui un'impressione di una campagna DCM ha rappresentato la prima interazione di conversione in una finestra temporale di 30 giorni. Questa dimensione include sia i completamenti obiettivo sia le transazioni.
  • - mcf:firstImpressionValue: il valore delle conversioni per cui un'impressione della campagna DCM è stata la prima interazione di conversione in una finestra temporale di 30 giorni. Questa dimensione include sia i completamenti obiettivo sia le transazioni.
  • - mcf:impressionAssistedConversions - Il numero di conversioni per le quali un'impressione di una campagna DCM è apparsa nel percorso di conversione, ma non ha rappresentato l'interazione finale con la conversione. Questa dimensione include sia i completamenti obiettivo sia le transazioni.
  • - mcf:impressionAssistedValue: il valore delle conversioni per le quali un'impressione della campagna DCM è stata visualizzata nel percorso di conversione, ma non è stata l'interazione di conversione finale. Questa dimensione include sia i completamenti obiettivo sia le transazioni.

In questa release sono state aggiunte nuove dimensioni e metriche all'API. Consulta la Guida di riferimento a dimensioni e metriche per l'elenco completo delle definizioni.

Percorsi di conversione

  • Dimensione - mcf:adwordsCustomerIDPath - Sequenza di ID cliente AdWords lungo i percorsi di conversione.

Interazioni

  • Dimensione - mcf:adwordsCustomerID - Corrisponde all'API AdWords Customer.id.

In questa release sono state aggiunte nuove dimensioni e metriche all'API. Consulta la Guida di riferimento a dimensioni e metriche per l'elenco completo delle definizioni.

Percorsi di conversione

  • Dimensione - mcf:adwordsAdGroupIDPath - Sequenza di ID gruppo di annunci AdWords lungo i percorsi di conversione.
  • Dimensione - mcf:adwordsCampaignIDPath - Sequenza di ID campagna AdWords lungo i percorsi di conversione.
  • Dimensione - mcf:adwordsCreativeIDPath - Sequenza di ID creatività AdWords lungo i percorsi di conversione.
  • Dimensione - mcf:adwordsCriteriaIDPath - Sequenza di ID criteri di AdWords lungo i percorsi di conversione.

Interazioni

  • Dimensione - mcf:adwordsAdGroupID - Corrisponde all'API AdWords AdGroup.id.
  • Dimensione - mcf:adwordsCampaignID - Corrisponde all'API AdWords Campaign.id.
  • Dimensione - mcf:adwordsCreativeID - Corrisponde all'API AdWords Ad.id.
  • Dimensione - mcf:adwordsCriteriaID - Corrisponde all'API AdWords Criterion.id.

Nuove funzionalità di controllo delle dimensioni e date relative dei campioni

Date relative
  • Nell'API MCF Reporting è stato aggiunto il supporto per le date relative. today, yesterday e NdaysAgo sono ora valori validi per i parametri di query start-date e end-date.
  • L'utilizzo di questi valori determinerà automaticamente l'intervallo di date in base alla data corrente al momento in cui viene eseguita la query e al fuso orario della vista (profilo) specificata nella query. Per ulteriori dettagli, consulta la documentazione di riferimento API.
Livello di campionamento
  • È stato introdotto un nuovo parametro, samplingLevel, che consente di impostare il livello di campionamento (ovvero il numero di visite utilizzato per calcolare il risultato) per una query di report. I valori consentiti sono: DEFAULT, FASTER e HIGHER_PRECISION.
  • Sono stati aggiunti 2 nuovi campi alla risposta dell'API: sampleSize e sampleSpace. Puoi utilizzare questi valori per calcolare la percentuale di visite utilizzate per una risposta campionata.
  • Per ulteriori dettagli, consulta la Riferimento API e il Campionamento.

Questa è la versione iniziale dell'API Multi-ChannelFunnel Reporting:

  • Questa nuova API 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 nell'arco di più visite precedenti alla conversione. In questo modo, puoi analizzare il modo in cui più canali di marketing influenzano le conversioni nel tempo. Per ulteriori dettagli sui dati disponibili e su come utilizzare l'API, consulta l'articolo sull'API di reporting delle canalizzazioni multicanale.