Registros de alterações da API de relatórios de funis multicanal do Google Analytics

Atualizamos periodicamente a API de relatórios de funis multicanal do Google Analytics para oferecer novos recursos e reparar defeitos descobertos nas versões anteriores. Na maioria dos casos, essas alterações ficarão evidentes para os desenvolvedores de API. No entanto, às vezes precisamos fazer alterações que exigem que os desenvolvedores modifiquem os aplicativos existentes.

Esta página documenta todas as alterações feitas na API de relatórios de funis multicanal do Google Analytics que possam afetar seu aplicativo. Recomendamos que os desenvolvedores de API consultem regularmente esta lista para ficarem atentos aos novos anúncios. Você também pode se inscrever para receber as alterações por meio dos feeds listados na seção Inscrever-se abaixo.

Inscrever-se nos registros de alterações relacionados

Todos os registros de alterações da API Google Analytics
–
Fazer inscrição rss

Inclui todas as APIs de coleta, configuração e relatórios.

Todos os registros de alterações da API Reporting
–
Fazer inscrição rss

Inclui as APIs de relatórios principais, de relatórios de funis multicanal e de relatórios em tempo real.

Registro de alterações da API MCF Reporting
–
Fazer inscrição rss

Nesta versão, adicionamos uma nova dimensão à API Leia a referência das dimensões e métricas para ver todas as definições.

ID da transação

  • Dimensão mcf:transactionId – ID da transação informado pelo método de acompanhamento de e-commerce para a compra no carrinho.

Nesta versão, adicionamos novas dimensões e métricas à API. Leia a referência das dimensões e métricas para ver todas as definições.

Caminhos de conversão

  • Dimensão mcf:dcmAd – Nome do anúncio do DCM do evento (impressão ou clique) correspondente à conversão do Google Analytics.
  • Dimensão mcf:dcmAdPath – caminho de conversão em que as interações são representadas pelos anúncios do DCM.
  • Dimensão mcf:dcmAdType – Nome do tipo de anúncio do DCM do evento (impressão ou clique) correspondente à conversão do Google Analytics.
  • Dimensão mcf:dcmAdvertiser – Nome do anunciante do DCM do evento (impressão ou clique) correspondente à conversão do Google Analytics.
  • Dimensão mcf:dcmAdvertiserPath – caminho de conversão em que as interações são representadas pelos anunciantes do DCM.
  • Dimensão mcf:dcmCampaign – Nome da campanha do DCM do evento (impressão ou clique) correspondente à conversão do Google Analytics.
  • Dimensão mcf:dcmCampaignPath – caminho de conversão em que as interações são representadas pelas campanhas do DCM.
  • Dimensão mcf:dcmCreative – Nome do criativo do DCM do evento (impressão ou clique) correspondente à conversão do Google Analytics.
  • Dimensão mcf:dcmCreativePath – caminho de conversão em que as interações são representadas pelos criativos do DCM.
  • Dimensão mcf:dcmCreativeVersion – Versão do criativo do DCM do evento (impressão ou clique) correspondente à conversão do Google Analytics.
  • Dimensão mcf:dcmCreativeVersionPath – caminho de conversão em que as interações são representadas pelas versões do criativo do DCM.
  • Dimensão mcf:dcmNetwork – Rede usada.
  • Dimensão mcf:dcmPlacement – Nome do canal do site do DCM do evento (impressão ou clique) correspondente à conversão do Google Analytics.
  • Dimensão mcf:dcmPlacementPath – caminho de conversão em que as interações são representadas pelos canais do DCM.
  • Dimensão mcf:dcmSite – Nome do site do DCM em que o criativo foi mostrado no evento (impressão ou clique) associado à conversão do Google Analytics.
  • Dimensão mcf:dcmSitePath – caminho de conversão em que as interações são representadas pelos sites do DCM.
  • Métrica mcf:firstImpressionConversions – Número de conversões em que uma impressão de campanha do DCM foi a primeira interação em uma janela de lookback de 30 dias. Essa dimensão inclui conclusões de meta e transações.
  • Métrica mcf:firstImpressionValue – Valor das conversões em que uma impressão de campanha do DCM foi a primeira interação em uma janela de lookback de 30 dias. Essa dimensão inclui conclusões de meta e transações.
  • Métrica mcf:impressionAssistedConversions – Número de conversões em que uma impressão de campanha do DCM apareceu no caminho de conversão, mas não foi a interação final. Essa dimensão inclui conclusões de meta e transações.
  • Métrica mcf:impressionAssistedValue – Valor das conversões em que uma impressão de campanha do DCM apareceu no caminho de conversão, mas não foi a interação final. Essa dimensão inclui conclusões de meta e transações.

Nesta versão, adicionamos novas dimensões e métricas à API. Leia a referência das dimensões e métricas para ver todas as definições.

Caminhos de conversão

  • Dimensão mcf:adwordsCustomerIDPath – Sequência do ID de cliente do Google AdWords nos caminhos de conversão.

Interações

  • Dimensão mcf:adwordsCustomerID – corresponde à API Customer.id do Google AdWords.

Nesta versão, adicionamos novas dimensões e métricas à API. Leia a referência das dimensões e métricas para ver todas as definições.

Caminhos de conversão

  • Dimensão mcf:adwordsAdGroupIDPath – sequência do código do grupo de anúncios do Google AdWords nos caminhos de conversão.
  • Dimensão mcf:adwordsCampaignIDPath – Sequência do ID da campanha do Google AdWords nos caminhos de conversão.
  • Dimensão mcf:adwordsCreativeIDPath – Sequência do ID do criativo do Google AdWords nos caminhos de conversão.
  • Dimensão mcf:adwordsCriteriaIDPath – Sequência do código dos critérios do Google AdWords nos caminhos de conversão.

Interações

  • Dimensão mcf:adwordsAdGroupID – Corresponde à API AdGroup.id do Google AdWords.
  • Dimensão mcf:adwordsCampaignID – Corresponde à API Campaign.id do Google AdWords.
  • Dimensão mcf:adwordsCreativeID – Corresponde à API Ad.id do Google AdWords.
  • Dimensão mcf:adwordsCriteriaID – corresponde à API Criterion.id do Google AdWords.

Novos recursos de controle de tamanho da amostra e datas relativas

Datas relativas
  • Adicionamos suporte para datas relativas à API MCF Reporting. Agora, today, yesterday e NdaysAgo são valores válidos para os parâmetros de consulta start-date e end-date.
  • O uso desses valores determinará automaticamente o período com base na data atual no momento em que a consulta é feita e no fuso horário da vista (perfil) especificada na consulta. Consulte a Referência da API para mais detalhes.
Nível de amostragem
  • Adicionamos um novo parâmetro, samplingLevel, que permite definir o nível de amostragem (ou seja, o número de visitas usadas para calcular o resultado) em uma consulta de relatório. Os valores permitidos são DEFAULT, FASTER e HIGHER_PRECISION.
  • Adicionamos dois novos campos à resposta da API: sampleSize e sampleSpace. Você pode usar esses valores para calcular a porcentagem de visitas que foram usadas em uma resposta com amostragem.
  • Consulte a Referência da API e a amostragem para mais detalhes.

Esta é a versão inicial da API Multi-Channel Funnels Reporting:

  • Com essa nova API, você pode solicitar dados de funis multicanal para um usuário autenticado, derivados das informações do caminho de conversão que mostram as interações do usuário com várias origens de tráfego durante visitas anteriores à conversão. Isso permite analisar como vários canais de marketing influenciam as conversões ao longo do tempo. Para mais detalhes sobre quais dados estão disponíveis e como usar a API, consulte API Multi-Channel Funnels Reporting.