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 o fluxo da Web ou do app, além dos dados que você já coleta 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. Considere as seguintes práticas recomendadas:

O timestamp_micros de eventos e propriedades do usuário é padrão no momento 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 no guia Enviar eventos e no guia Propriedades do usuário.
Para relatórios precisos em tempo real e métricas de engajamento, 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 `timestamp_micros`
Atribuir o User-ID a eventos	Obrigatório	<= dia útil de 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 publicitárias	Não obrigatório	<= dia útil da última sessão + 63 dias	>= tempo de solicitação menos dois dias úteis e <= tempo de solicitação
Enviar eventos ou propriedades do usuário para a criação de público-alvo	Não obrigatório	Web: <= data do último evento on-line + 30 dias App: <= data do último evento on-line + 42 dias	>= tempo de solicitação menos dois dias úteis e <= tempo de solicitação

Atribuir o User-ID a 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:

Sua medição on-line não tem as informações necessárias para procurar o ID do usuário para 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 do usuário.

Nesse cenário, você está usando o Measurement Protocol para fornecer eventos on-line com um User-ID.
Você não tem o ID do usuário para os eventos que está enviando com o Measurement Protocol, mas quer que esses eventos sejam associados a um ID do 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 User-ID.

Estes são os requisitos para adicionar um ID do 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 de término da sessão on-line.
Se o objetivo é fornecer o ID do usuário para eventos on-line, defina user_id na solicitação.
Se o objetivo é que cada evento do Protocolo de medição tenha o User-ID 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.

Estes são 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 de término da sessão on-line.

Exportar eventos para plataformas publicitárias

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

Confira alguns cenários comuns em que isso é útil:

Sua empresa tem eventos off-line que você quer incluir na atribuição de publicidade e nos relatórios.
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 publicitárias:

Envie a solicitação até o fim 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 do que 63 dias.

Por exemplo, se o evento on-line mais recente do client_id ou app_instance_id ocorreu em 1º de março, envie o evento do Measurement Protocol até o fim do dia útil de 3 de maio.
Se você substituir timestamp_micros, defina-o como um carimbo de data/hora nos últimos três dias úteis.

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 do público-alvo se você cumprir 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 fim do dia útil 30 dias após o último evento on-line 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 fim do dia útil em 31 de março.
Envie a solicitação para um fluxo de app até o fim 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 em 12 de abril.
Se você substituir timestamp_micros, defina-o como um carimbo de data/hora nos últimos três dias úteis.