Esta página foi traduzida pela API Cloud Translation.

Casos de uso do Measurement Protocol

Com o Measurement Protocol do Google Analytics, você pode enviar dados off-line para seu fluxo da Web ou do app na além dos dados que você já está coletando com a inclusão de tag 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 uso caso. Lembre-se das seguintes práticas recomendadas:

O timestamp_micros dos eventos e das propriedades do usuário é padronizado para a solicitação tempo de resposta. Ao enviar um evento ou uma alteração de propriedade do usuário que ocorreu no passado, substitua o carimbo de data/hora conforme descrito no guia de envio de eventos e o guia de propriedades do usuário.
Para ter acesso a Relatórios de tempo real e métricas de engajamento precisos, inclua o Parâmetro de evento engagement_time_msec definido para os milissegundos decorridos desde o evento anterior.

Caso de uso	ID da sessão	Requisito de tempo de solicitação	`timestamp_micros` requisito
Atribuir o User-ID a eventos	Obrigatório	<= fim do dia útil de início da sessão	>= início e <= término da sessão
Atribuição de sessão	Obrigatório	<= início da sessão + 24 horas	>= início e <= término 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
Enviar eventos ou propriedades do usuário para o público-alvo criação	Não obrigatório	Web: <= horário do evento on-line mais recente + 30 dias Aplicativo: <= horário mais recente do evento on-line + 42 dias	<= tempo da solicitação

Atribuir o User-ID a eventos

Use o Measurement Protocol para oferecer eventos on-line ou off-line com uma 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 User-ID para eventos on-line, mas você tem um pipeline de processamento de eventos que consegue 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 Measurement Protocol, mas quiser que esses eventos sejam associados a uma User-ID se o usuário tiver feito login on-line durante a sessão.

Neste 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 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 que o sessão on-line.
Se você substituir timestamp_micros, defina-o como um carimbo de data/hora entre as horário de início e término da sessão on-line.
Se sua meta for fornecer User-ID para eventos on-line, defina o user_id em da solicitação.
Se sua 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) como eventos on-line na mesma sessão.

Estes são 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.

Por exemplo, se a sessão começou às 11h15 na segunda-feira na sua propriedade fuso horário, envie a solicitação antes das 11h15 na terça-feira.
Se você substituir timestamp_micros, defina-o como um carimbo de data/hora entre as 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 em exportações para produtos de publicidade vinculados, como o Google Ads ou o Campaign Manager 360

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

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

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 mais de 63 dias.

Por exemplo, se o evento on-line mais recente do dia client_id ou app_instance_id ocorreu em 1o de março, envie o Measurement Protocol até o final do dia útil do dia 3 de maio.
Se você substituir timestamp_micros, defina-o como um carimbo de data/hora menor ou igual a ao horário da solicitação.

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

Os eventos e as propriedades do usuário enviados com o Measurement Protocol estão incluídos a avaliação das condições de público-alvo se você cumprir alguns requisitos.

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

Enviar a solicitação para um fluxo da Web até o final do dia útil 30 dias após o último evento on-line do mesmo client_id.

Por exemplo, se o último evento on-line de client_id ocorreu em 1o de março, envie o evento do Measurement Protocol até o fim do dia útil de 31 de março.
Envie a solicitação para um fluxo do app até o fim do dia útil. 42 dias após o último evento on-line do mesmo app_instance_id.

Por exemplo, se o último evento on-line de app_instance_id ocorreu em 1o de março, envie o evento do Measurement Protocol até o fim do no dia útil de 12 de abril.
Se você substituir timestamp_micros, defina-o como um carimbo de data/hora menor ou igual a ao horário da solicitação.