Casos de uso do Measurement Protocol

O Measurement Protocol do Google Analytics permite enviar dados off-line para seu fluxo da Web ou de apps, além dos dados que você já coleta com a inclusão de tags ou o SDK do Firebase.

Este guia descreve casos de uso comuns do Measurement Protocol do Google Analytics e os requisitos deles.

Resumo dos requisitos

Esta tabela oferece uma referência rápida dos requisitos para cada caso de uso. Tenha em mente as seguintes práticas recomendadas:

1. O timestamp_micros de eventos e propriedades do usuário é definido como o horário da solicitação por padrão. Ao enviar um evento ou uma mudança de propriedade do usuário que ocorreu no passado, substitua o carimbo de data/hora conforme descrito no guia de envio de eventos e no guia de propriedades do usuário.

2. Para relatórios em tempo real e métricas de engajamento precisos, inclua o parâmetro de evento engagement_time_msec definido como os milissegundos decorridos desde o evento anterior.

Atribuir ID de usuário a eventos

Use o Measurement Protocol para fornecer eventos on-line ou off-line com um ID de usuário.

Confira alguns exemplos de casos de uso para adicionar um ID de usuário a um evento:

1. Sua medição on-line não tem as informações necessárias para pesquisar o ID de usuário de eventos on-line, mas você tem um pipeline de processamento de eventos que pode fazer a associação entre uma sessão on-line e um ID de usuário.

   Nesse cenário, você está usando o Measurement Protocol para fornecer eventos on-line com um ID de usuário.

2. Você não tem o ID de usuário dos eventos que está enviando com o Measurement Protocol, mas quer que esses eventos sejam associados a um ID de usuário se o usuário tiver feito login on-line durante a sessão.

   Nesse cenário, você está usando eventos on-line para fornecer eventos do Measurement Protocol com um ID de usuário.

Confira os requisitos para adicionar um ID de usuário a um evento:

• Inclua o session_id na lista de parâmetros do evento.
• Envie os eventos do Measurement Protocol no mesmo dia útil da sessão on-line.
• Se você substituir timestamp_micros, defina-o como um carimbo de data/hora entre o horário de início e término da sessão on-line.
• Se o objetivo for fornecer o ID de usuário para eventos on-line, defina o user_id na solicitação.
• Se o objetivo for que cada evento do Measurement Protocol tenha o ID de usuário da sessão on-line correspondente, não é necessário definir user_id.

Atribuição de sessão

Os eventos do Measurement Protocol que atendem a requisitos específicos aparecem nos relatórios com os mesmos atributos de sessão (como informações geográficas, origem, mídia e campanha) que os eventos on-line da mesma sessão.

Confira os requisitos para atribuição de sessão:

• Inclua o session_id na lista de parâmetros do evento.

• Envie a solicitação em até 24 horas após o início da sessão on-line.

  Por exemplo, se a sessão começou às 11h15 de segunda-feira no fuso horário da sua propriedade, envie a solicitação antes das 11h15 de terça-feira.

• Se você substituir timestamp_micros, defina-o como um carimbo de data/hora entre o horário de início e término da sessão on-line.

Exportar eventos para plataformas de publicidade

O Google Analytics inclui os eventos enviados usando o Measurement Protocol em exportações para produtos de publicidade vinculados, como o Google Ads ou o Campaign Manager 360.

Alguns cenários comuns em que isso é útil incluem:

• Sua empresa tem eventos off-line que você quer incluir na atribuição e nos relatórios de publicidade.
• Você tem outros eventos em um sistema que não está disponível para a inclusão de tags ou o SDK do Firebase, mas ainda quer incluir esses eventos em produtos vinculados.

Confira os requisitos para exportar eventos para plataformas de publicidade:

• Envie a solicitação em até 63 dias após o evento on-line mais recente, mesmo que a janela de atribuição do evento principal seja maior que 63 dias. O evento também precisa chegar dentro da janela de atribuição do evento principal. Saiba como configurar as definições da janela de atribuição.

  Por exemplo, se o evento on-line mais recente para o client_id ou app_instance_id ocorreu em 1º de março, envie o evento do Measurement Protocol até 3 de maio.

• Se você substituir timestamp_micros, defina-o como um carimbo de data/hora nas últimas 72 horas.

Enviar eventos ou propriedades do usuário para a criação de públicos-alvo

Os eventos e as propriedades do usuário enviados usando o Measurement Protocol são incluídos na avaliação das condições do público-alvo se você seguir alguns requisitos.

Confira os requisitos para enviar eventos ou propriedades do usuário para a criação de públicos-alvo:

• Envie a solicitação para um fluxo da Web em até 30 dias após o evento on-line mais recente para o mesmo client_id.

  Por exemplo, se o evento on-line mais recente para o client_id ocorreu em 1º de março, envie o evento do Measurement Protocol até 31 de março.

• Envie a solicitação para um fluxo de apps em até 42 dias após o evento on-line mais recente para o mesmo app_instance_id.

  Por exemplo, se o evento on-line mais recente para o app_instance_id ocorreu em 1º de março, envie o evento do Measurement Protocol até 12 de abril.

• Se você substituir timestamp_micros, defina-o como um carimbo de data/hora nas últimas 72 horas.