Eventos personalizados e recomendados do Google Analytics

Use a API Data Manager para enviar eventos recomendados e personalizados do Google Analytics.

Enviar eventos personalizados e recomendados

Se você estiver fazendo upgrade do Measurement Protocol do Google Analytics confira o artigo Fazer upgrade do Measurement Protocol para a API Data Manager para conferir as instruções.

Visão geral do fluxo de trabalho

Para enviar dados de eventos com a API Data Manager, siga estas etapas:

  1. Preparar destinos: defina os Destination objetos para o destinations campo da solicitação de ingestão para especificar a conta de destino e a conversão ou o destino do evento. Consulte Preparar destinos para mais detalhes.

  2. Preparar dados de eventos e identificadores: preencha os campos Event com detalhes do evento e identificadores obrigatórios (como cliques no anúncio, clientes ou identificadores de instâncias de apps). Se você incluir informações de contato do usuário em userData, normalize e gere hash SHA-256 dos identificadores de acordo com as diretrizes de formatação e, opcionalmente, criptografe os. Consulte Preparar dados de eventos para mais detalhes.

  3. Criar e enviar a solicitação de ingestão:envie uma solicitação events.ingest que contenha seus registros destinations, Event e encryptionInfo se você criptografou userData. Use validateOnly: true para testar seu payload em busca de erros de falha rápida antes de enviar dados de produção. Consulte Enviar eventos para conferir os requisitos de campo e exemplos de código.

  4. Verificar diagnósticos: Recupere diagnósticos de processamento assíncrono e verifique o status da ingestão com requestStatus.retrieve.

Casos de uso

Confira alguns casos de uso para enviar eventos personalizados e recomendados com a API Data Manager:

  • Associar comportamentos on-line e off-line.

  • Medir as interações do lado do cliente e do lado do servidor.

  • Enviar eventos que acontecem fora da interação do usuário padrão, como as conversões off-line.

  • Enviar eventos de dispositivos e apps em que a coleta automática não está disponível, como quiosques e relógios.

Dados fornecidos pelo usuário

Você pode enviar seus próprios dados do cliente, como endereços de e-mail, números de telefone com hash, e endereços físicos, no userData campo de um Event. Isso ajuda a melhorar a medição de conversões, a atribuição e a criação de público-alvo no Google Analytics.

Considere o seguinte ao enviar dados fornecidos pelo usuário:

  • Enviados com eventos: na API Data Manager, os dados fornecidos pelo usuário precisam ser enviados como parte de um Event. Os uploads independentes sem um evento não são aceitos.

  • Formatação e hash: os identificadores pessoais (como endereço de e-mail, número de telefone, nome e endereço) precisam ser normalizados e criptografados com hash usando o algoritmo SHA-256 antes do upload. Outros campos (como cidade, estado ou província, código postal e código do país) são normalizados, mas não criptografados com hash. Siga o guia Formatar dados do usuário para conferir os requisitos específicos.

  • Criptografia: você pode, opcionalmente, criptografar os dados do usuário com hash.

  • User-ID: recomendamos fornecer o userId junto com userData sempre que um identificador de usuário consistente estiver disponível.

  • Implementação: consulte Adicionar dados fornecidos pelo usuário para conferir instruções sobre como criar solicitações.

Considerações sobre a integração

Considere as seguintes informações ao usar a API Data Manager.

Remarketing

O Google Analytics oferece suporte ao remarketing no mesmo dispositivo quando você ativa os indicadores do Google. Para o remarketing entre dispositivos, userId é necessário.

Além disso, você pode enviar dados fornecidos pelo usuário para ativar a correspondência de público-alvo próprio.

Identificadores de publicidade

O Google Analytics combina automaticamente identificadores de publicidade (como GBRAID ou WBRAID) coletados durante interações on-line com eventos da API Data Manager usando clientId ou appInstanceId.

Configurações de privacidade

O Google Analytics combina eventos da API Data Manager com interações on-line usando clientId ou appInstanceId para adotar configurações de privacidade do usuário, como "anúncios não personalizados" e "limitar o rastreamento de anúncios".

Você também pode especificar as configurações de consentimento do usuário diretamente em cada evento usando o consent objeto.

Informações geográficas e do dispositivo

O Google Analytics combina automaticamente as informações geográficas e do dispositivo mais recentes da inclusão de tag com os eventos da API Data Manager usando clientId ou appInstanceId. Isso garante que os eventos da API Data Manager apareçam em relatórios que incluem dimensões geográficas e do dispositivo.

Se você quiser que um evento da API Data Manager reflita informações geográficas e do dispositivo de uma sessão específica em vez das informações mais recentes do clientId ou appInstanceId, inclua uma entrada em additionalEventParameters com parameterName definido como session_id e value definido como o ID da sessão específica, e envie o evento em até 24 horas após o início da sessão.

Você pode fornecer informações geográficas e informações do dispositivo para eventos usando a API Data Manager.

Servidor para servidor completo

Você pode enviar eventos ao Google Analytics usando apenas a API Data Manager, mas, ao fazer isso, talvez só gere relatórios parciais. O objetivo da API Data Manager é melhorar os eventos coletados com a gtag, o Gerenciador de tags ou o Firebase. Alguns nomes de eventos e parâmetros são reservados para uso com a coleta automática e não podem ser enviados pela API Data Manager.

Gerar ou renomear eventos

Os eventos enviados com a API Data Manager não acionam regras para gerar ou renomear eventos. Seu aplicativo precisa implementar a lógica para enviar eventos personalizados pela API Data Manager de forma semelhante às regras configuradas na interface do Google Analytics.

Avançar
Enviar eventos