Referência do Measurement Protocol

Visão geral

O envio de dados ao Google Analytics com o Measurement Protocol é feito em duas etapas:

  1. Transporte: para onde e como você envia os dados.
  2. Payload: os dados que você envia.

Neste documento, descrevemos como o transporte e o payload são formatados.

Transporte

Endpoint do URL

Você envia dados pelo Measurement Protocol fazendo solicitações POST HTTP para o seguinte endpoint:

https://www.google-analytics.com/mp/collect

Para transmitir um evento, envie a seguinte solicitação POST:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>
  • O BODY da solicitação. Consulte Payload.

Códigos de resposta

O Measurement Protocol sempre retornará um código de status 2xx se a solicitação HTTP tiver sido recebida. O Measurement Protocol não retornará um código de erro se os dados de payload tiverem a formatação incorreta, se estiverem errados ou não tiverem sido processados pelo Google Analytics.

Payload

O envio dos dados ao Google Analytics pelo Measurement Protocol ocorre em duas etapas:

  1. Parâmetros de consulta
  2. Corpo JSON POST

Parâmetros de consulta

Nome do parâmetro Descrição

api_secret

Obrigatório. Uma API Secret gerada na IU do Google Analytics.

Para criar um novo secret, navegue na IU do Google Analytics até:
Administrador > Fluxos de dados > escolha seu fluxo > Measurement Protocol > Criar

Recomendamos que você mantenha essas informações privadas na sua organização. Se você implantar o Measurement Protocol no lado do cliente, alterne api_secrets regularmente para evitar excesso de spam.

firebase_app_id

Obrigatório. ID do app do Firebase. Identificador de um app do Firebase. Encontrado no Console do Firebase em:
Configurações do projeto > Geral > Seus apps > ID do app

measurement_id

ID de métricas. Identificador de um fluxo de dados. Encontrado na IU do Google Analytics em:
Administrador > Fluxos de dados > escolha seu fluxo > ID de métricas

Corpo da postagem JSON

Chave Tipo Descrição

app_instance_id

string

Obrigatório. Identifica de forma exclusiva uma instalação específica de um app do Firebase. Esse valor precisa ser recuperado com o SDK do Firebase.

client_id

string

Obrigatório. Identifica de forma exclusiva uma instância de usuário de um cliente da Web. Consulte Enviar evento para o Measurement Protocol.

user_id

string

Opcional. Identificador exclusivo de um usuário. Para mais informações sobre esse identificador, consulte User-ID para análise multiplataforma.

timestamp_micros

number

Opcional. Carimbo de data/hora Unix (em microssegundos) para o horário a ser associado ao evento. Só pode ser definido para registrar eventos que aconteceram no passado. Esse valor pode ser modificado com user_property ou carimbos de data/hora de eventos. Os eventos podem ser atualizados em até três dias corridos com base no fuso horário da propriedade.

user_properties

object Opcional. Propriedades do usuário para a medição. Consulte Propriedades do usuário para mais informações.

non_personalized_ads

boolean Opcional. Defina como true para indicar que esses eventos não podem ser usados para anúncios personalizados.

events[]

array Obrigatório. Matriz de itens de evento. Até 25 eventos podem ser enviados por solicitação. Consulte a referência de eventos para todos os eventos válidos.

events[].name

string Obrigatório. Nome do evento. Consulte a referência de eventos para todas as opções.

events[].params

object Opcional. Parâmetros do evento. Veja os parâmetros sugeridos para cada evento.

Alguns eventos têm parâmetros recomendados. Consulte eventos e veja os parâmetros recomendados para todos os eventos compatíveis.

Nomes reservados

Nomes de eventos reservados

Os nomes de evento a seguir estão reservados e não podem ser usados:

  • ad_activeview
  • ad_click
  • ad_exposure
  • ad_impression
  • ad_query
  • adunit_exposure
  • app_clear_data
  • app_install
  • app_update
  • app_remove
  • error
  • first_open
  • first_visit
  • in_app_purchase
  • notification_dismiss
  • notification_foreground
  • notification_open
  • notification_receive
  • os_update
  • screen_view
  • session_start
  • user_engagement

Nomes de parâmetros reservados

Os nomes de parâmetro a seguir estão reservados e não podem ser usados:

  • firebase_conversion

Além disso, eles não podem começar com:

  • google_
  • ga_
  • firebase_

Nomes de propriedades do usuário reservados

Os seguintes nomes de propriedades do usuário são reservados e não podem ser usados:

  • first_open_time
  • first_visit_time
  • last_deep_link_referrer
  • user_id
  • first_open_after_install

Além disso, eles não podem começar com:

  • google_
  • ga_
  • firebase_