Casos de uso do Measurement Protocol

Com o Measurement Protocol do Google Analytics, você pode enviar dados off-line ao seu fluxo da Web ou do app, além dos dados que já está coletando com a inclusão de tags ou o SDK do Firebase.

Neste guia, descrevemos os casos de uso comuns do Measurement Protocol do Google Analytics e os requisitos deles.

Resumo dos requisitos

Esta tabela fornece uma referência rápida dos requisitos para cada caso de uso. Lembre-se das seguintes práticas recomendadas:

1. O timestamp_micros de eventos e propriedades do usuário é definido por padrão como o horário da solicitaçã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 nos guias de envio de eventos e de propriedades do usuário.

2. Para ter relatórios de 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 o User-ID aos eventos

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

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

1. Sua medição on-line não tem as informações necessárias para pesquisa rápida do User-ID em 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 User-ID.

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

2. Você não tem o User-ID para os eventos que está enviando com o Measurement Protocol, mas quer que eles sejam associados a um User-ID se o usuário fizer login on-line durante a sessão.

   Nesse cenário, você usa eventos on-line para fornecer eventos do Measurement Protocol com um User-ID.

Confira os requisitos para adicionar um User-ID 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 é fornecer o User-ID para eventos on-line, defina o user_id na solicitação.
• Se o objetivo é que cada evento do Measurement Protocol tenha o ID do 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 a atribuição de sessão:

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

• Envie a solicitação 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 que você envia usando o Measurement Protocol nas 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 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 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 definir as configurações da janela de atribuição.

  Por exemplo, se o evento on-line mais recente para 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 criar públicos-alvo

Os eventos e as propriedades do usuário enviados pelo Measurement Protocol são incluídos na avaliação das condições do público-alvo se você atender a 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 do 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 espelhamento de app 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 do 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.