Esta página foi traduzida pela API Cloud Translation.

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. Considere as práticas recomendadas a seguir:

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 nos guias Envio de eventos e Propriedades do usuário.
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 do início da sessão	>= início da sessão e <= fim da sessão
Atribuição de 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	<= último dia útil da sessão + 63 dias	>= tempo da solicitação menos dois dias úteis e <= tempo 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	>= tempo da solicitação menos dois dias úteis e <= tempo 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:

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ê usa o Measurement Protocol para fornecer eventos on-line com um User-ID.
Você não tem o User-ID para eventos enviados com o protocolo de medição, 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 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 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) 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 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 inclusão de tags ou para 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é o final do dia útil 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.

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é o final do dia útil de 3 de maio.
Se você substituir timestamp_micros, defina um carimbo de data/hora nos últimos três dias úteis.

Enviar eventos ou propriedades do usuário para criar 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 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 até o final do dia útil 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é o final do dia útil de 31 de março.
Envie a solicitação para um stream de app até o final do dia útil 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é o fim do dia útil de 12 de abril.
Se você substituir timestamp_micros, defina um carimbo de data/hora nos últimos três dias úteis.