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

В этом руководстве объясняется, как отправлять веб- события и потоки приложений протокола измерений Google Analytics на сервер Google Analytics, чтобы можно было просматривать события протокола измерений в отчетах 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 SECRET , сгенерированный в пользовательском интерфейсе Google Analytics.

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

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

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

Для протокола измерений необходимо предоставить тело запроса в формате JSON POST . Вот пример: 

  {
   "client_id": "CLIENT_ID",
   "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 . Узнайте, как подсчитываются сеансы .

Попробуй это

Вот пример, который можно использовать для отправки нескольких событий одновременно. В этом примере на сервер Google Analytics отправляются события tutorial_begin и join_group , а также добавляется географическая информация с помощью поля user_location и информация об устройстве с помощью поля device . 

const measurementId = "MEASUREMENT_ID";
const apiSecret = "API_SECRET";

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    client_id: "CLIENT_ID",
    events: [
      {
        name: "tutorial_begin",
        params: {
          "session_id": "SESSION_ID",
          "engagement_time_msec": 100
        }
      },
      {
        name: "join_group",
        params: {
          "group_id": "G_12345",
          "session_id": "SESSION_ID",
          "engagement_time_msec": 150
        }
      }
    ],
    user_location: {
      city: "Mountain View",
      region_id: "US-CA",
      country_id: "US",
      subcontinent_id: "021",
      continent_id: "019"
    },
    device: {
      category: "mobile",
      language: "en",
      screen_resolution: "1280x2856",
      operating_system: "Android",
      operating_system_version: "14",
      model: "Pixel 9 Pro",
      brand: "Google",
      browser: "Chrome",
      browser_version: "136.0.7103.60"
    }
  })
});

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

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

  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 КБ.
  • События App Measurement Protocol, отправляемые в Google Analytics, не заполняют поисковую аудиторию в Google Ads для пользователей приложения.

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