Casos de uso do Measurement Protocol

O Measurement Protocol do Google Analytics permite enviar dados off-line para seu fluxo da Web ou de app, além dos dados que você já coleta com 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. Lembre-se das seguintes práticas recomendadas:

  1. O timestamp_micros de eventos e propriedades do usuário é definido como padrão para 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 Envio de eventos e 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.

Caso de uso ID da sessão Requisito de tempo de solicitação Requisito do timestamp_micros
Atribuir User-ID a eventos Obrigatório <= fim do dia útil de início da sessão >= início da sessão e <= fim da sessão
Atribuição da sessão Obrigatório <= início da sessão + 24 horas >= início da sessão e <= fim da sessão
Exportar eventos para plataformas de publicidade Não obrigatório <= dia da última sessão + 63 dias >= hora da solicitação menos 72 horas e <= hora da solicitação
Enviar eventos ou propriedades do usuário para a criação de públicos-alvo Não obrigatório Web: <= horário do último evento on-line + 30 dias
App: <= horário do último evento on-line + 42 dias		 >= hora da solicitação menos 72 horas e <= hora da solicitação

Atribuir User-ID a eventos

Use o Measurement Protocol para fornecer eventos on-line ou off-line com um User-ID.

Confira alguns exemplos de casos de uso para adicionar um User-ID a um evento:

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

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

  2. Você não tem o User-ID para eventos enviados 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ê está usando 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 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 um User-ID para eventos on-line, defina o user_id na solicitação.
  • Se a meta for que cada evento do Measurement Protocol tenha o User-ID da sessão on-line correspondente, não será necessário definir user_id.

Atribuição da 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) dos 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 o pedido 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 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 inclusão de tag ou 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 último evento on-line, 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 janelas 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 um carimbo de data/hora nas últimas 72 horas.

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

Os eventos e as propriedades do usuário enviados usando o Measurement Protocol são incluídos na avaliação das condições de 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úblico-alvo:

  • Envie a solicitação para um fluxo da Web no prazo de 30 dias após o último evento on-line do mesmo client_id.

    Por exemplo, se o último evento on-line 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 stream de app no máximo 42 dias após o último evento on-line 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 um carimbo de data/hora nas últimas 72 horas.