Как отправлять события Measurement Protocol в Google Аналитику

В этом руководстве объясняется, как отправлять события потоков веб-страниц и приложений Google Analytics Measurement Protocol на сервер Google Analytics, чтобы вы могли просматривать события Measurement Protocol в своих отчетах Google Analytics .

Выберите платформу, которую вы хотите видеть в этом руководстве:

Форматирование запроса

Протокол измерения Google Analytics поддерживает только запросы HTTP POST .

Чтобы отправить событие, используйте следующий формат:

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

В URL-адресе запроса необходимо указать следующее:

  • api_secret : СЕКРЕТ API , созданный в пользовательском интерфейсе Google Analytics.

    Чтобы создать новый секрет, перейдите в «Администратор» > «Потоки данных» > выберите поток > «Протокол измерения» > «Создать» .

  • measurement_id : идентификатор измерения, связанный с потоком, который можно найти в пользовательском интерфейсе Google Analytics в разделе «Администратор» > «Потоки данных» > выберите свой поток > «Идентификатор измерения» .

    measurement_id не является идентификатором вашего потока .

Полную информацию см. в параметрах запроса .

В теле запроса необходимо указать следующее:

  • client_id : уникальный идентификатор клиента. Это отличается от app_instance_id в Firebase. Используйте gtag.js('get') .

  • user_id : Необязательно. Уникальный идентификатор пользователя. Может содержать только символы UTF-8. Дополнительную информацию об этом идентификаторе см. в разделе User-ID для кросс-платформенного анализа .

  • consent : Необязательно. Узнайте, как настроить параметры согласия .

  • timestamp_micros : необязательно. Время эпохи Unix в микросекундах для событий и свойств пользователя в запросе. Если не указано, по умолчанию используется время запроса .

  • events : Массив элементов событий. Вы можете включить несколько событий в один запрос.

    Чтобы активность пользователя отображалась в таких отчетах, как Realtime , engagement_time_msec и session_id должны быть указаны как часть params event . Параметр engagement_time_msec должен отражать время взаимодействия с событием в миллисекундах.

    Вот пример: 

  {
   "client_id": "123456.7654321",
   "events": [
     {
        "name": "campaign_details",
        "params": {
          "campaign_id": "google_1234",
          "campaign": "Summer_fun",
          "source": "google",
          "medium": "cpc",
          "term": "summer+travel",
          "content": "logolink",
          "session_id": "123",
          "engagement_time_msec": "100"
        }
     }
   ]
  }

Хотя session_start является зарезервированным именем события , создание нового session_id создает новый сеанс без необходимости отправлять session_start . Узнайте, как подсчитываются сеансы .

Попробуйте это

Вот пример, который вы можете использовать для отправки tutorial_begin на ваш сервер Google Analytics: 

const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    client_id: 'XXXXXXXXXX.YYYYYYYYYY',
    events: [{
      name: 'tutorial_begin',
      params: {},
    }]
  })
});

Переопределить временную метку

Протокол измерения использует первую временную метку, которую он находит в следующем списке, для каждого события в запросе:

  1. timestamp_micros события.
  2. timestamp_micros запроса.
  3. Время, когда протокол измерения получает запрос.

В следующем примере отправляется временная метка уровня запроса, которая применяется ко всем событиям в запросе. В результате протокол измерения присваивает событиям tutorial_begin и join_group временную метку requestUnixEpochTimeInMicros .

{
  "timestamp_micros": requestUnixEpochTimeInMicros,
  "events": [
    {
      "name": "tutorial_begin"
    },
    {
      "name": "join_group",
      "params": {
        "group_id": "G_12345",
      }
    }
  ]
}

В следующем примере отправляется как метка времени на уровне запроса, так и метка времени на уровне события. В результате протокол измерения присваивает событию tutorial_begin временную метку tutorialBeginUnixEpochTimeInMicros , а событию join_group — временную метку requestUnixEpochTimeInMicros .

{
  "timestamp_micros": requestUnixEpochTimeInMicros,
  "events": [
    {
      "name": "tutorial_begin",
      "timestamp_micros": tutorialBeginUnixEpochTimeInMicros
    },
    {
      "name": "join_group",
      "params": {
        "group_id": "G_12345",
      }
    }
  ]
}

Ограничения

Следующие ограничения применяются к отправке событий Measurement Protocol в Google Analytics:

  • Запросы могут содержать максимум 25 событий.
  • События могут иметь максимум 25 параметров.
  • События могут иметь максимум 25 пользовательских свойств.
  • Имена пользовательских свойств должны содержать не более 24 символов.
  • Значения свойств пользователя должны содержать не более 36 символов.
  • Имена событий должны содержать не более 40 символов, могут содержать только буквенно-цифровые символы и знаки подчеркивания и должны начинаться с буквенного символа.
  • Имена параметров, включая параметры элементов, должны содержать не более 40 символов, могут содержать только буквенно-цифровые символы и знаки подчеркивания и должны начинаться с буквенного символа.
  • Значения параметров, включая значения параметров элементов, должны содержать не более 100 символов для стандартного ресурса Google Analytics и не более 500 символов для ресурса Google Analytics 360.
  • Параметры элемента могут иметь максимум 10 пользовательских параметров.
  • Тело сообщения должно быть меньше 130 КБ.
  • События протокола измерения приложений, отправляемые в Google Analytics, не заполняют поисковые аудитории в Google Рекламе для пользователей приложения.

Дополнительные требования для каждого варианта использования см. в разделе «Общие варианты использования» .