O que é a Reporting API de funis multicanal: visão geral

Este documento fornece uma visão geral de alto nível da Reporting API de funis multicanal do Google Analytics. Para uma referência detalhada da API, leia o Guia de referência.

Introdução

A Reporting API de funis multicanal do Google Analytics permite solicitar os dados de funis multicanal de um usuário autenticado. Os dados são derivados dos dados do caminho de conversão, que mostram as interações do usuário com várias origens de tráfego durante diversas sessões antes da 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, leia Sobre os funis multicanal e Sobre os dados de funis multicanal.

Com a Reporting API de funis multicanal, você pode:

  • Criar relatórios personalizados utilizando dados de funis multicanal. Por exemplo, é possível usar dados dos caminhos de conversão mais comuns para coletar informações sobre atributos como a posição relativa das interações em um caminho de conversão.
  • Integrar dados de funis multicanal com seus dados de negócios. Por exemplo, é possível correlacionar dados de conversão on-line com dados de vendas off-line e de custo de mídia para chegar a uma visão mais completa do ROI (retorno do investimento) de marketing.
  • Exibir funis multicanal em novos ambientes. Por exemplo, é possível criar visualizações e outras apresentações dos dados que comunicam o valor de diferentes canais de marketing para gerar conversões.

Visão geral conceitual

Os conceitos fundamentais subjacentes à Reporting API de funis multicanal são:

  • Como os relatórios estão relacionados aos usuários e às vistas (perfis).
  • A estrutura de um relatório e como criar consultas.
  • Conceitos de atribuição e dados de caminho de conversão
  • Trabalho com a resposta da API.

Relatórios, usuários e vistas (perfis)

Para solicitar os dados de relatório de um usuário, seu aplicativo precisa identificar o usuário e especificar uma vista (perfil) para a qual recuperar os dados. Um usuário é identificado pela obtenção das credenciais de autorização e envio dessas credenciais em cada solicitação de API. Uma vista (perfil) é identificada por um ID de vista (perfil). As vistas (perfis), entre outras entidades, fazem parte da hierarquia de configuração do Google Analytics. Seu aplicativo pode usar a Management API para atravessar essa hierarquia e obter um ID de vista (perfil).

Consulta de dimensões e métricas

Você consulta a API para encontrar dados de relatório do Google Analytics, que consistem em dimensões e métricas. As métricas são avaliações individuais das atividades dos usuários, como valores e contagens de conversões. As dimensões detalham as métricas com alguns critérios comuns e podem ser valores primitivos, que representam eventos individuais de interação em caminhos de conversão, ou sequências, que representam a série de eventos de interação de caminhos de conversão inteiros.

Use o Guia de referência de dimensões e métricas para explorar todas as dimensões e métricas expostas pela API. Além disso, leia o Guia de referência da Reporting API de funis multicanal para saber como especificar dimensões e métricas em uma consulta de API.

Conceitos de atribuição e dados de caminho de conversão

Os Relatórios de funis multicanal são gerados a partir de caminhos de conversão: as sequências de interações (por exemplo, cliques/referências de canais) que levaram a cada conversão e transação. Os caminhos de conversão são coletados por meio do cookie do Google Analytics, que registra interações do mesmo navegador e máquina. Os dados de funis multicanal combinam os dados de conversão do Google Analytics com a sequência de interações capturadas no cookie.

As consultas do Relatório de funis multicanal retornam dados com base em um conjunto de amostra de 1 milhão de caminhos de conversão. Se o período incluir uma contagem total de conversões de até 1 milhão, o relatório não conterá dados de amostra. Caso contrário, um conjunto de amostra com 1 milhão de conversões será utilizado para gerar os resultados. Isso contrasta com a funcionalidade dos relatórios principais, que utilizam dados de amostra com base nas sessões. Para mais informações sobre os dados e conceitos relacionados, leia Sobre os dados de funis multicanal. Também pode ser proveitoso ler o artigo Análise de contribuições de canal, que define conceitos fundamentais, como as conversões assistidas.

Trabalho com relatórios

Os dados retornados da API podem ser considerados como uma tabela com um cabeçalho e diversas linhas. Cada resposta de API consiste em um cabeçalho que descreve o nome e o tipo dos dados de cada coluna. A resposta também inclui uma lista de linhas, em que cada linha é uma lista de células com dados na mesma ordem que os cabeçalhos. Leia o Guia de referência da Reporting API de funis multicanal para mais informações sobre a resposta da API.

Cada valor de célula contém um valor primitivo de tipo de string ou um valor de caminho de conversão. Esse valor de caminho de conversão é um conjunto de objetos que representa todos os nós do caminho. Podemos usar as informações de tipo nos cabeçalhos das colunas para analisar o valor de cada célula de acordo com o tipo apropriado. Encontre mais informações sobre esse assunto aqui.

Política de cotas

A consulta de dados de funis multicanal lida com milhões de operações. Para impedir que o sistema receba mais operações do que pode processar e para garantir uma distribuição equitativa dos respectivos recursos, é necessário empregar um sistema de cotas. Consulte o guia Limites e cota para mais detalhes.

Próximas etapas

Agora que você entende como a API funciona, existem vários recursos para ajudar a dar os primeiros passos: