Como enviar eventos

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Visão geral

Neste guia, explicamos como formatar e enviar solicitações ao Measurement Protocol do Google Analytics.

Como enviar eventos

Para enviar um evento, faça uma solicitação HTTP POST para o seguinte endpoint:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

Parâmetros obrigatórios

Uma solicitação válida requer dois conjuntos de parâmetros que variam quando você usa o Firebase ou a gtag.js:

  1. Parâmetros de URL

    • api_secret: obrigatório. Uma API SECRET gerada na IU do Google Analytics. Para criar uma nova chave secreta, navegue até:
      Admin > Fluxos de dados > escolha seu fluxo > Measurement Protocol > Criar

    Veja os parâmetros de consulta para a referência completa.

  2. Corpo JSON

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

    • events: obrigatório. Matriz de itens de evento.

    Veja JSON POST BODY para a referência completa.

Para que a atividade do usuário seja mostrada em relatórios padrão, como o Relatório de tempo real, é necessário enviar engagement_time_msec e session_id como parte dos params para um event.

Exemplo:

{
"client_id": "x",
"events": [
  {
    "name": "offline_purchase",
    "params": {
      "engagement_time_msec": "100",
      "session_id": "123"
    }
  }
]
}

Embora session_start seja um nome de evento reservado, criar um novo session_id vai gerar uma nova sessão sem a necessidade de enviar session_start.

Enviar um evento

Para enviar um evento tutorial_begin, faça a seguinte solicitação:

Limitações

  • As solicitações podem ter no máximo 25 eventos.
  • Os eventos podem ter no máximo 25 parâmetros.
  • Os eventos podem ter até 25 propriedades do usuário.
  • Os nomes das propriedades precisam ter, no máximo, 24 caracteres.
  • Os valores de propriedades do usuário precisam ter, no máximo, 36 caracteres.
  • Os nomes dos eventos precisam ter no máximo 40 caracteres, podem conter apenas caracteres alfanuméricos e sublinhados e precisam começar com um caractere alfabético.
  • Os nomes dos parâmetros (incluindo os parâmetros de item) precisam ter, no máximo, 40 caracteres alfanuméricos e sublinhados, além de começar com um caractere alfabético.
  • Os valores de parâmetros (incluindo aqueles de itens) podem ter, no máximo, 100 caracteres.
  • Os parâmetros de itens podem ter, no máximo, 10 parâmetros personalizados.
  • O corpo da postagem precisa ter menos de 130 KB.