Eventos personalizados e recomendados do Google Analytics

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

Confira Enviar eventos para mais detalhes.

Se você estiver fazendo upgrade do Measurement Protocol do Google Analytics, consulte Fazer upgrade do Measurement Protocol para a API Data Manager e veja as instruções.

Casos de uso

Confira alguns casos de uso para enviar eventos recomendados e personalizados 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

É possível enviar seus próprios dados do cliente, como endereços de e-mail, números de telefone e endereços físicos com hash, no campo userData 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 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 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 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, é necessário usar userId.

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 os identificadores de publicidade (como GBRAID ou WBRAID) coletados durante as 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 objeto consent.

Informações geográficas e do dispositivo

O Google Analytics combina automaticamente as mais recentes informações geográficas e de dispositivo 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 de dispositivo.

Se você quiser que um evento da API Data Manager reflita informações geográficas e de 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. Envie o evento em até 24 horas após o início da sessão.

É possível 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 é aumentar 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.