Рекомендуемые события Google Аналитики

Ниже приведен список рекомендуемых событий. Вы также можете создавать и отправлять собственные специальные события.

При создании названий специальных событий необходимо:

  1. Соблюдайте правила именования событий.
  2. Не используйте зарезервированные названия и префиксы.
  3. Соблюдайте ограничения на сбор событий, например на длину названий событий и параметров (не более 40 символов).

Подробности – в статье Начало работы.

Если вы переходите с Measurement Protocol, ознакомьтесь с инструкциями по обновлению.

Для всех ресурсов

ad_impression

Это событие доступно только для потоков данных приложений.

Используйте это событие, когда пользователь видит показ объявления.

  • ad_impression, отправленный с помощью Measurement Protocol, не будет включен в экспорт на другие рекламные платформы, например в Google Рекламу.
  • Отправка событий ad_impression с помощью Measurement Protocol может привести к дублированию показов, если вы настроили теги или SDK для связанных рекламных продуктов Google. Отправляйте событие ad_impression с помощью Measurement Protocol, только если оно не было зарегистрировано с помощью тегов или SDK.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Нет USD Валюта товаров, связанных с событием, в трехбуквенном формате ISO 4217.

*Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Нет 3,99 евро
Ценность показа объявления.
* Параметр conversion_value обычно требуется для содержательных отчетов.
* Если задан параметр conversion_value, то необходимо задать и параметр currency.

Параметры

Имя Тип Обязательно? Пример значения Описание
ad_platform string Нет MoPub Рекламная платформа.
ad_source string Нет AdColony Источник объявлений.
ad_format string Нет Баннер Формат объявления.
ad_unit_name string Нет Banner_03 Название рекламного блока.

Пример

В примере ниже показано, как отправить событие ad_impression с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "ad_impression",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 3.99,
      "additionalEventParameters": [
        {
          "parameterName": "ad_platform",
          "value": "MoPub"
        },
        {
          "parameterName": "ad_source",
          "value": "AdColony"
        },
        {
          "parameterName": "ad_format",
          "value": "Banner"
        },
        {
          "parameterName": "ad_unit_name",
          "value": "Banner_03"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "ad_impression",
      "params": {
        "ad_platform": "MoPub",
        "ad_source": "AdColony",
        "ad_format": "Banner",
        "ad_unit_name": "Banner_03",
        "currency": "USD",
        "value": 3.99
      }
    }]
  })
});

earn_virtual_currency

Это событие означает, что пользователь получил виртуальную валюту в игре в качестве награды. Мы рекомендуем добавить к нему spend_virtual_currency. Это даст вам возможность получать более полные данные о вашей виртуальной экономике.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
conversion_value number Нет 5 Стоимость виртуальной валюты.

Параметры

Имя Тип Обязательно? Пример значения Описание
virtual_currency_name string Нет Драгоценные камни Название виртуальной валюты.

Пример

В примере ниже показано, как отправить событие earn_virtual_currency с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "earn_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "earn_virtual_currency",
      "params": {
        "virtual_currency_name": "Gems",
        "value": 5
      }
    }]
  })
});

join_group

Это событие означает, что пользователь присоединился к группе (например, к гильдии, команде или клану). Оно поможет вам определить популярные группы и социальные функции.

Параметры

Имя Тип Обязательно? Пример значения Описание
group_id string Нет G_12345 Идентификатор группы.

Пример

В примере ниже показано, как отправить событие join_group с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "join_group",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "group_id",
          "value": "G_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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":"join_group",
      "params":{
        "group_id":"G_12345"
      }
    }]
  })
});

login

Это событие означает, что пользователь вошел на сайт или в приложение.

Параметры

Имя Тип Обязательно? Пример значения Описание
method string Нет Google Выбранный способ входа в систему.

Пример

В примере ниже показано, как отправить событие login с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "login",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "login",
      "params": {
        "method": "Google"
      }
    }]
  })
});

screen_view

Это событие доступно только для потоков данных приложений.

Это событие означает, что пользователь перешел на другой экран.

Параметры

Имя Тип Обязательно? Пример значения Описание
screen_class string Нет MainActivity Класс экрана.
screen_name string Нет Информация Название экрана

Пример

В примере ниже показано, как отправить событие screen_view с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "screen_view",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "additionalEventParameters": [
        {
          "parameterName": "screen_class",
          "value": "MainActivity"
        },
        {
          "parameterName": "screen_name",
          "value": "About"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

Это событие означает, что пользователь выполнил поиск. С его помощью можно определить, какой контент ищут пользователи на вашем сайте или в приложении. Например, вы можете отправлять такое событие, когда пользователь выполнит поиск и перейдет на страницу с результатами.

Параметры

Имя Тип Обязательно? Пример значения Описание
search_term string Да футболки Поисковый запрос, введенный пользователем.

Пример

В примере ниже показано, как отправить событие search с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "search",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "t-shirts"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "search",
      "params": {
        "search_term": "t-shirts"
      }
    }]
  })
});

select_content

Это событие означает, что пользователь выбрал контент определенного типа. Оно поможет вам узнать, какие разделы и категории контента в приложении наиболее популярны на вашем сайте или в приложении.

Параметры

Имя Тип Обязательно? Пример значения Описание
content_type string Нет продукт Тип выбранного контента.
content_id string Нет C_12345 Идентификатор выбранного контента. Значение должно содержать хотя бы один нецифровой символ.

Пример

В примере ниже показано, как отправить событие select_content с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_content",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "content_type",
          "value": "product"
        },
        {
          "parameterName": "content_id",
          "value": "C_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "select_content",
      "params": {
        "content_type": "product",
        "content_id": "C_12345"
      }
    }]
  })
});

share

Используйте это событие, когда пользователь делится контентом.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
cart_data.items Item[] Нет Товары, связанные с событием.

Задайте значение поля cart_data.items в объекте Event.

Поля товаров:

Название Тип Обязательно? Пример значения Описание
item_id string Да I_12345 Уникальный идентификатор объекта. Задайте поле item_id в объекте Item.
unit_price number Да 27,67 Цена товара без учета налогов, стоимости доставки и скидок на уровне события (транзакции).

Если на товар действует скидка, укажите цену за единицу с учетом скидки. Например, если цена за единицу товара составляет 27,67, а скидка за единицу товара – 6,66, то в атрибуте "цена со скидкой за единицу товара" unitPrice нужно указать значение 21,01.
quantity number Да 1 Количество единиц товара, приобретенных в рамках этой покупки.

Параметры

Имя Тип Обязательно? Пример значения Описание
method string Нет Твиттер Каким способом пользователь поделился контентом.
content_type string Нет Изображение Тип контента, которым поделился пользователь.

Пример

В примере ниже показано, как отправить событие share с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "share",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "C_12345",
            "quantity": 1,
            "unitPrice": 27.67
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Twitter"
        },
        {
          "parameterName": "content_type",
          "value": "image"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "share",
      "params": {
        "method": "Twitter",
        "content_type": "image",
        "item_id": "C_12345"
      }
    }]
  })
});

sign_up

Это событие означает, что пользователь создал аккаунт. Оно поможет вам проанализировать поведение тех, кто вошел в систему, и тех, кто не вошел в нее.

Параметры

Имя Тип Обязательно? Пример значения Описание
method string Нет Google Выбранный способ регистрации.

Пример

В примере ниже показано, как отправить событие sign_up с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "sign_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "sign_up",
      "params": {
        "method": "Google"
      }
    }]
  })
});

spend_virtual_currency

Это событие позволяет отслеживать продажу виртуальных товаров в приложении и определять наиболее популярные из них.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
conversion_value number Да 5 Стоимость виртуальной валюты.
cart_data.items Item[] Нет Товары, связанные с событием.

Задайте значение поля cart_data.items в объекте Event.

Поля товаров:

Название Тип Обязательно? Пример значения Описание
item_id string Да I_12345 Уникальный идентификатор объекта. Задайте поле item_id в объекте Item.
unit_price number Да 27,67 Цена товара без учета налогов, стоимости доставки и скидок на уровне события (транзакции).

Если на товар действует скидка, укажите цену за единицу с учетом скидки. Например, если цена за единицу товара составляет 27,67, а скидка за единицу товара – 6,66, то в атрибуте "цена со скидкой за единицу товара" unitPrice нужно указать значение 21,01.
quantity number Да 1 Количество единиц товара, приобретенных в рамках этой покупки.

Параметры товара

Имя Тип Обязательно? Пример значения Описание
item_name string Нет Starter Boost Название объекта, на который тратится виртуальная валюта.

Параметры

Имя Тип Обязательно? Пример значения Описание
virtual_currency_name string Да Драгоценные камни Название виртуальной валюты.

Пример

В примере ниже показано, как отправить событие spend_virtual_currency с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "spend_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "I_12345",
            "quantity": 1,
            "unitPrice": 27.67,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Starter Boost"
              }
            ]
          }
        ]
      },
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "spend_virtual_currency",
      "params": {
        "value": 5,
        "virtual_currency_name": "Gems",
        "item_name": "Starter Boost"
      }
    }]
  })
});

tutorial_begin

Это событие означает, что пользователь начал обучение. Добавьте его в последовательность конверсии вместе с tutorial_complete, чтобы узнать, какой процент пользователей завершил обучение.

Параметры

Для этого события нет рекомендуемых параметров.

Пример

В примере ниже показано, как отправить событие tutorial_begin с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_begin",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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"
    }]
  })
});

tutorial_complete

Это событие означает, что пользователь завершил обучение. Добавьте его в последовательность конверсии вместе с tutorial_begin, чтобы узнать, какой процент пользователей завершил обучение.

Параметры

Для этого события нет рекомендуемых параметров.

Пример

В примере ниже показано, как отправить событие tutorial_complete с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_complete",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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_complete"
    }]
  })
});

view_search_results

Это событие означает, что пользователь просмотрел результаты поиска. Вы можете включить событие view_search_results event для автоматического сбора с помощью улучшенной статистики в Google Аналитике.

Параметры

Имя Тип Обязательно? Пример значения Описание
search_term string Нет Одежда Поисковый запрос, введенный пользователем.

Пример

В примере ниже показано, как отправить событие view_search_results с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_search_results",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "Clothing"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "view_search_results",
      "params": {
        "search_term": "Clothing"
      }
    }]
  })
});

campaign_details

Используйте это событие, чтобы отправлять информацию о компании, которая будет применена к событиям с временной меткой, большей или равной временной метке события campaign_details.

Параметры

Имя Тип Обязательно? Пример значения Описание
campaign_id string Нет google_1234 Идентификатор кампании.
campaign string Нет Summer_fun Название определенной промоакции или стратегической кампании.
source string Нет google Источник трафика кампании, например, Google, электронная почта и т. д.
medium string Нет cpc Канал кампании, например электронная почта, цена за клик и т. д.
term string Нет summer+travel Ключевое слово кампании, по которому объявление показывается в результатах поиска.
content string Нет logolink Контент кампании, который используется при A/B-тестировании и в объявлениях с таргетингом на контент. Позволяет различать объявления или ссылки, ведущие на один и тот же URL.

Пример

В примере ниже показано, как отправить событие campaign_details с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "campaign_details",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "campaign_id",
          "value": "google_1234"
        },
        {
          "parameterName": "campaign",
          "value": "Summer_fun"
        },
        {
          "parameterName": "source",
          "value": "google"
        },
        {
          "parameterName": "medium",
          "value": "cpc"
        },
        {
          "parameterName": "term",
          "value": "summer+travel"
        },
        {
          "parameterName": "content",
          "value": "logolink"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "campaign_details",
      "params": {
        "campaign_id": "google_1234",
        "campaign": "Summer_fun",
        "source": "google",
        "medium": "cpc",
        "term": "summer+travel",
        "content": "logolink"
      }
    }]
  })
});

Онлайн-продажи

add_payment_info

Это событие электронной торговли означает, что в процессе оформления покупки пользователь указал платежные данные.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта товаров, связанных с событием, в трехбуквенном формате ISO 4217.

* Показатели ценности события view_item не учитываются при расчете дохода.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

* Для параметра conversion_value задайте сумму значений (price * quantity) для всех объектов в items. Не указывайте shipping или tax.
* Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое, мы рекомендуем указать значение conversion_value.
* Если задан параметр conversion_value, то необходимо задать и параметр currency.
cart_data.items Item[] Да Товары, связанные с событием.

Задайте значение поля cart_data.items в объекте Event.
cart_data.coupon_codes string[] Нет SUMMER_FUN Код купона, связанного с событием.


Задайте значение поля coupon_codes в объекте CartData.
* В этом списке можно указать только один код купона.
* Этот параметр не зависит от кодов купонов на уровне товара.

Поля товаров:

Название Тип Обязательно? Пример значения Описание
item_id string Да I_12345 Уникальный идентификатор объекта. Задайте поле item_id в объекте Item.
unit_price number Да 27,67 Цена товара без учета налогов, стоимости доставки и скидок на уровне события (транзакции).

Если на товар действует скидка, укажите цену за единицу с учетом скидки. Например, если цена за единицу товара составляет 27,67, а скидка за единицу товара – 6,66, то в атрибуте "цена со скидкой за единицу товара" unitPrice нужно указать значение 21,01.
quantity number Да 1 Количество единиц товара, приобретенных в рамках этой покупки.

Параметры

Имя Тип Обязательно? Пример значения Описание
payment_type string Нет Кредитная карта Выбранный способ оплаты.

Пример

В примере ниже показано, как отправить событие add_payment_info с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_payment_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "payment_type",
          "value": "Credit Card"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "add_payment_info",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "payment_type": "Credit Card",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_shipping_info

Это событие электронной торговли означает, что в процессе оформления покупки пользователь указал сведения о доставке.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта товаров, связанных с событием, в трехбуквенном формате ISO 4217.

* Показатели ценности события view_item не учитываются при расчете дохода.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

* Для параметра conversion_value задайте сумму значений (price * quantity) для всех объектов в items. Не указывайте shipping или tax.
* Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое, мы рекомендуем указать значение conversion_value.
* Если задан параметр conversion_value, то необходимо задать и параметр currency.
cart_data.items Item[] Да Товары, связанные с событием.

Задайте значение поля cart_data.items в объекте Event.
cart_data.coupon_codes string[] Нет SUMMER_FUN Код купона, связанного с событием.


Задайте значение поля coupon_codes в объекте CartData.
* В этом списке можно указать только один код купона.
* Этот параметр не зависит от кодов купонов на уровне товара.

Поля товаров:

Название Тип Обязательно? Пример значения Описание
item_id string Да I_12345 Уникальный идентификатор объекта. Задайте поле item_id в объекте Item.
unit_price number Да 27,67 Цена товара без учета налогов, стоимости доставки и скидок на уровне события (транзакции).

Если на товар действует скидка, укажите цену за единицу с учетом скидки. Например, если цена за единицу товара составляет 27,67, а скидка за единицу товара – 6,66, то в атрибуте "цена со скидкой за единицу товара" unitPrice нужно указать значение 21,01.
quantity number Да 1 Количество единиц товара, приобретенных в рамках этой покупки.

Параметры

Имя Тип Обязательно? Пример значения Описание
shipping_tier string Нет Наземная Категория доставки (например, Ground, Air или Next-day), выбранная для купленного товара.

Пример

В примере ниже показано, как отправить событие add_shipping_info с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_shipping_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping_tier",
          "value": "Ground"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "add_shipping_info",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping_tier": "Ground",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_cart

Это событие означает, что товар был добавлен в корзину покупок.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта товаров, связанных с событием, в трехбуквенном формате ISO 4217.

* Показатели ценности события view_item не учитываются при расчете дохода.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

* Для параметра conversion_value задайте сумму значений (price * quantity) для всех объектов в items. Не указывайте shipping или tax.
* Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое, мы рекомендуем указать значение conversion_value.
* Если задан параметр conversion_value, то необходимо задать и параметр currency.
cart_data.items Item[] Да Товары, связанные с событием.

Задайте значение поля cart_data.items в объекте Event.

Поля товаров:

Название Тип Обязательно? Пример значения Описание
item_id string Да I_12345 Уникальный идентификатор объекта. Задайте поле item_id в объекте Item.
unit_price number Да 27,67 Цена товара без учета налогов, стоимости доставки и скидок на уровне события (транзакции).

Если на товар действует скидка, укажите цену за единицу с учетом скидки. Например, если цена за единицу товара составляет 27,67, а скидка за единицу товара – 6,66, то в атрибуте "цена со скидкой за единицу товара" unitPrice нужно указать значение 21,01.
quantity number Да 1 Количество единиц товара, приобретенных в рамках этой покупки.

Параметры товара

Имя Тип Обязательно? Пример значения Описание
item_name string Да* Stan and Friends Tee

Название товара.

*Должен быть указан один из параметров: item_id или item_name.

affiliation string Нет Google Store Параметр, позволяющий установить принадлежность товара определенному поставщику или магазину.
Примечание. Параметр affiliation доступен только на уровне позиции.
coupon string Нет SUMMER_FUN Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
discount number Нет 2.22 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Adult Вторая категория или дополнительный разряд товара.
item_category3 string Нет Shirts Третья категория или дополнительный разряд товара.
item_category4 string Нет Crew Четвертая категория или дополнительный разряд товара.
item_category5 string Нет Short sleeve Пятая категория или дополнительный разряд товара.
item_list_id string Нет related_products Идентификатор списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_id на уровне события игнорируется.
Если нет, то параметр item_list_id используется (если он присутствует).
item_list_name string Нет Сопутствующие товары Название списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_name на уровне события игнорируется.
Если нет, то параметр item_list_name используется (если он присутствует).
item_variant string Нет зеленый Вариант товара или уникальный код/описание дополнительных сведений о товаре или его разновидности.
location_id string Нет ChIJIQBpAG2ahYAR_6128GcTUEo (идентификатор места Google для Сан-Франциско) Обычный магазин, в котором доступен товар (адрес магазина). Мы рекомендуем указать для связанного с товаром местоположения идентификатор Google, но можно использовать и собственный идентификатор.
Примечание. Параметр location_id доступен только на уровне позиции.
Помимо предписанных параметров, в массив items можно добавить до 27 специальных параметров.

Пример

В примере ниже показано, как отправить событие add_to_cart с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "add_to_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_wishlist

Это событие означает, что товар был добавлен в список желаний. Оно поможет вам определить популярные подарки.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта товаров, связанных с событием, в трехбуквенном формате ISO 4217.

* Показатели ценности события view_item не учитываются при расчете дохода.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

* Для параметра conversion_value задайте сумму значений (price * quantity) для всех объектов в items. Не указывайте shipping или tax.
* Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое, мы рекомендуем указать значение conversion_value.
* Если задан параметр conversion_value, то необходимо задать и параметр currency.
cart_data.items Item[] Да Товары, связанные с событием.

Задайте значение поля cart_data.items в объекте Event.

Поля товаров:

Название Тип Обязательно? Пример значения Описание
item_id string Да I_12345 Уникальный идентификатор объекта. Задайте поле item_id в объекте Item.
unit_price number Да 27,67 Цена товара без учета налогов, стоимости доставки и скидок на уровне события (транзакции).

Если на товар действует скидка, укажите цену за единицу с учетом скидки. Например, если цена за единицу товара составляет 27,67, а скидка за единицу товара – 6,66, то в атрибуте "цена со скидкой за единицу товара" unitPrice нужно указать значение 21,01.
quantity number Да 1 Количество единиц товара, приобретенных в рамках этой покупки.

Параметры товара

Имя Тип Обязательно? Пример значения Описание
item_name string Да* Stan and Friends Tee

Название товара.

*Должен быть указан один из параметров: item_id или item_name.

affiliation string Нет Google Store Параметр, позволяющий установить принадлежность товара определенному поставщику или магазину.
Примечание. Параметр affiliation доступен только на уровне позиции.
coupon string Нет SUMMER_FUN Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
discount number Нет 2.22 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Adult Вторая категория или дополнительный разряд товара.
item_category3 string Нет Shirts Третья категория или дополнительный разряд товара.
item_category4 string Нет Crew Четвертая категория или дополнительный разряд товара.
item_category5 string Нет Short sleeve Пятая категория или дополнительный разряд товара.
item_list_id string Нет related_products Идентификатор списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_id на уровне события игнорируется.
Если нет, то параметр item_list_id используется (если он присутствует).
item_list_name string Нет Сопутствующие товары Название списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_name на уровне события игнорируется.
Если нет, то параметр item_list_name используется (если он присутствует).
item_variant string Нет зеленый Вариант товара или уникальный код/описание дополнительных сведений о товаре или его разновидности.
location_id string Нет ChIJIQBpAG2ahYAR_6128GcTUEo (идентификатор места Google для Сан-Франциско) Обычный магазин, в котором доступен товар (адрес магазина). Мы рекомендуем указать для связанного с товаром местоположения идентификатор Google, но можно использовать и собственный идентификатор.
Примечание. Параметр location_id доступен только на уровне позиции.
Помимо предписанных параметров, в массив items можно добавить до 27 специальных параметров.

Пример

В примере ниже показано, как отправить событие add_to_wishlist с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_wishlist",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "add_to_wishlist",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

begin_checkout

Это событие означает, что пользователь начал оформлять покупку.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта товаров, связанных с событием, в трехбуквенном формате ISO 4217.

* Показатели ценности события view_item не учитываются при расчете дохода.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

* Для параметра conversion_value задайте сумму значений (price * quantity) для всех объектов в items. Не указывайте shipping или tax.
* Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое, мы рекомендуем указать значение conversion_value.
* Если задан параметр conversion_value, то необходимо задать и параметр currency.
cart_data.items Item[] Да Товары, связанные с событием.

Задайте значение поля cart_data.items в объекте Event.
cart_data.coupon_codes string[] Нет SUMMER_FUN Код купона, связанного с событием.


Задайте значение поля coupon_codes в объекте CartData.
* В этом списке можно указать только один код купона.
* Этот параметр не зависит от кодов купонов на уровне товара.

Поля товаров:

Название Тип Обязательно? Пример значения Описание
item_id string Да I_12345 Уникальный идентификатор объекта. Задайте поле item_id в объекте Item.
unit_price number Да 27,67 Цена товара без учета налогов, стоимости доставки и скидок на уровне события (транзакции).

Если на товар действует скидка, укажите цену за единицу с учетом скидки. Например, если цена за единицу товара составляет 27,67, а скидка за единицу товара – 6,66, то в атрибуте "цена со скидкой за единицу товара" unitPrice нужно указать значение 21,01.
quantity number Да 1 Количество единиц товара, приобретенных в рамках этой покупки.

Параметры товара

Имя Тип Обязательно? Пример значения Описание
item_name string Да* Stan and Friends Tee

Название товара.

*Должен быть указан один из параметров: item_id или item_name.

affiliation string Нет Google Store Параметр, позволяющий установить принадлежность товара определенному поставщику или магазину.
Примечание. Параметр affiliation доступен только на уровне позиции.
coupon string Нет SUMMER_FUN Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
discount number Нет 2.22 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Adult Вторая категория или дополнительный разряд товара.
item_category3 string Нет Shirts Третья категория или дополнительный разряд товара.
item_category4 string Нет Crew Четвертая категория или дополнительный разряд товара.
item_category5 string Нет Short sleeve Пятая категория или дополнительный разряд товара.
item_list_id string Нет related_products Идентификатор списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_id на уровне события игнорируется.
Если нет, то параметр item_list_id используется (если он присутствует).
item_list_name string Нет Сопутствующие товары Название списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_name на уровне события игнорируется.
Если нет, то параметр item_list_name используется (если он присутствует).
item_variant string Нет зеленый Вариант товара или уникальный код/описание дополнительных сведений о товаре или его разновидности.
location_id string Нет ChIJIQBpAG2ahYAR_6128GcTUEo (идентификатор места Google для Сан-Франциско) Обычный магазин, в котором доступен товар (адрес магазина). Мы рекомендуем указать для связанного с товаром местоположения идентификатор Google, но можно использовать и собственный идентификатор.
Примечание. Параметр location_id доступен только на уровне позиции.
Помимо предписанных параметров, в массив items можно добавить до 27 специальных параметров.

Пример

В примере ниже показано, как отправить событие begin_checkout с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "begin_checkout",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "begin_checkout",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

in_app_purchase

Это событие доступно только для потоков данных приложений.

Используйте это событие, когда пользователь совершает покупку в приложении.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта conversion_value события в трехбуквенном формате ISO 4217.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

*Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое событие, мы рекомендуем указать значение conversion_value.
*Если задан параметр conversion_value, то необходимо задать и параметр currency.
transaction_id string Нет T_12345 Уникальный идентификатор транзакции.

С помощью параметра transaction_id можно избежать дублирования события при покупке. Задайте поле transaction_id в объекте Event.
cart_data.items Item[] Нет Товары, связанные с событием.

Задайте значение поля cart_data.items в объекте Event.

Поля товаров:

Название Тип Обязательно? Пример значения Описание
item_id string Да I_12345 Уникальный идентификатор объекта. Задайте поле item_id в объекте Item.
unit_price number Да 27,67 Цена товара без учета налогов, стоимости доставки и скидок на уровне события (транзакции).

Если на товар действует скидка, укажите цену за единицу с учетом скидки. Например, если цена за единицу товара составляет 27,67, а скидка за единицу товара – 6,66, то в атрибуте "цена со скидкой за единицу товара" unitPrice нужно указать значение 21,01.
quantity number Да 1 Количество единиц товара, приобретенных в рамках этой покупки.

Параметры

Имя Тип Обязательно? Пример значения Описание
product_id string Нет ABC123456789 Идентификатор товара.
subscription boolean Нет true

Указывает, является ли покупка подпиской.
Если не задано, по умолчанию используется false.
free_trial boolean Нет true

Указывает, относится ли событие к бесплатной пробной подписке.
Если не задано, по умолчанию используется false.
price_is_discounted boolean Нет false

Указывает, предоставляется ли скидка на price.
Если не задано, по умолчанию используется false.

Пример

В примере ниже показано, как отправить событие in_app_purchase с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "in_app_purchase",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "transactionId": "T_12345",
      "conversionValue": 30.03,
      "cartData": {
        "items": [
          {
            "itemId": "ABC123456789",
            "quantity": 3,
            "unitPrice": 10.01
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "subscription",
          "value": true
        },
        {
          "parameterName": "free_trial",
          "value": false
        },
        {
          "parameterName": "price_is_discounted",
          "value": false
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events":[{
      "name":"in_app_purchase",
      "params":{
        "currency": "USD",
        "value": 30.03,
        "quantity": 3,
        "transaction_id": "T_12345",
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

purchase

Это событие регистрируется, когда пользователь приобретает один или несколько товаров.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта товаров, связанных с событием, в трехбуквенном формате ISO 4217.

* Показатели ценности события view_item не учитываются при расчете дохода.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

* Для параметра conversion_value задайте сумму значений (price * quantity) для всех объектов в items. Не указывайте shipping или tax.
* Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое, мы рекомендуем указать значение conversion_value.
* Если задан параметр conversion_value, то необходимо задать и параметр currency.
transaction_id string Да T_12345 Уникальный идентификатор транзакции.

С помощью параметра transaction_id можно избежать дублирования события при покупке. Задайте поле transaction_id в объекте Event.
user_properties.customer_type CustomerType Нет NEW Является ли клиент, совершивший конверсию, NEW или RETURNING.
cart_data.items Item[] Да Товары, связанные с событием.

Задайте значение поля cart_data.items в объекте Event.
cart_data.coupon_codes string[] Нет SUMMER_FUN Код купона, связанного с событием.


Задайте значение поля coupon_codes в объекте CartData.
* В этом списке можно указать только один код купона.
* Этот параметр не зависит от кодов купонов на уровне товара.

Поля товаров:

Название Тип Обязательно? Пример значения Описание
item_id string Да I_12345 Уникальный идентификатор объекта. Задайте поле item_id в объекте Item.
unit_price number Да 27,67 Цена товара без учета налогов, стоимости доставки и скидок на уровне события (транзакции).

Если на товар действует скидка, укажите цену за единицу с учетом скидки. Например, если цена за единицу товара составляет 27,67, а скидка за единицу товара – 6,66, то в атрибуте "цена со скидкой за единицу товара" unitPrice нужно указать значение 21,01.
quantity number Да 1 Количество единиц товара, приобретенных в рамках этой покупки.

Параметры

Имя Тип Обязательно? Пример значения Описание
shipping number Нет 243 Стоимость доставки, связанной с транзакцией.
tax number Нет 81 Сумма налога, связанного с транзакцией.

Параметры товара

Имя Тип Обязательно? Пример значения Описание
item_name string Да* Stan and Friends Tee

Название товара.

*Должен быть указан один из параметров: item_id или item_name.

affiliation string Нет Google Store Параметр, позволяющий установить принадлежность товара определенному поставщику или магазину.
Примечание. Параметр affiliation доступен только на уровне позиции.
coupon string Нет SUMMER_FUN Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
discount number Нет 2.22 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Adult Вторая категория или дополнительный разряд товара.
item_category3 string Нет Shirts Третья категория или дополнительный разряд товара.
item_category4 string Нет Crew Четвертая категория или дополнительный разряд товара.
item_category5 string Нет Short sleeve Пятая категория или дополнительный разряд товара.
item_list_id string Нет related_products Идентификатор списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_id на уровне события игнорируется.
Если нет, то параметр item_list_id используется (если он присутствует).
item_list_name string Нет Сопутствующие товары Название списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_name на уровне события игнорируется.
Если нет, то параметр item_list_name используется (если он присутствует).
item_variant string Нет зеленый Вариант товара или уникальный код/описание дополнительных сведений о товаре или его разновидности.
location_id string Нет ChIJIQBpAG2ahYAR_6128GcTUEo (идентификатор места Google для Сан-Франциско) Обычный магазин, в котором доступен товар (адрес магазина). Мы рекомендуем указать для связанного с товаром местоположения идентификатор Google, но можно использовать и собственный идентификатор.
Примечание. Параметр location_id доступен только на уровне позиции.
Помимо предписанных параметров, в массив items можно добавить до 27 специальных параметров.

Пример

В примере ниже показано, как отправить событие purchase с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "purchase",
      "transactionId": "TRANSACTION_ID",
      "conversionValue": 83.99,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "userProperties": {
        "customerType": "RETURNING"
      },
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 3,
            "unitPrice": 10.01,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Stan and Friends Tee"
              },
              {
                "parameterName": "affiliation",
                "value": "Google Merchandise Store"
              },
              {
                "parameterName": "discount",
                "value": "2.22"
              },
              {
                "parameterName": "index",
                "value": "0"
              },
              {
                "parameterName": "item_brand",
                "value": "Google"
              },
              {
                "parameterName": "item_category",
                "value": "Apparel"
              },
              {
                "parameterName": "item_category2",
                "value": "Adult"
              },
              {
                "parameterName": "item_category3",
                "value": "Shirts"
              },
              {
                "parameterName": "item_category4",
                "value": "Crew"
              },
              {
                "parameterName": "item_category5",
                "value": "Short sleeve"
              },
              {
                "parameterName": "item_list_id",
                "value": "related_products"
              },
              {
                "parameterName": "item_list_name",
                "value": "Related Products"
              },
              {
                "parameterName": "item_variant",
                "value": "green"
              },
              {
                "parameterName": "location_id",
                "value": "ChIJIQBpAG2ahYAR_6128GcTUEo"
              },
              {
                "parameterName": "google_business_vertical",
                "value": "retail"
              }
            ]
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": "3.33"
        },
        {
          "parameterName": "tax",
          "value": "1.11"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "purchase",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
            {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

refund

Это событие регистрируется, когда пользователь возвращает один или несколько товаров.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта товаров, связанных с событием, в трехбуквенном формате ISO 4217.

* Показатели ценности события view_item не учитываются при расчете дохода.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

* Для параметра conversion_value задайте сумму значений (price * quantity) для всех объектов в items. Не указывайте shipping или tax.
* Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое, мы рекомендуем указать значение conversion_value.
* Если задан параметр conversion_value, то необходимо задать и параметр currency.
transaction_id string Да T_12345 Уникальный идентификатор транзакции.
cart_data.items Item[] Нет Товары, связанные с событием.

Задайте значение поля cart_data.items в объекте Event.
cart_data.coupon_codes string[] Нет SUMMER_FUN Код купона, связанного с событием.


Задайте значение поля coupon_codes в объекте CartData.
* В этом списке можно указать только один код купона.
* Этот параметр не зависит от кодов купонов на уровне товара.

Поля товаров:

Название Тип Обязательно? Пример значения Описание
item_id string Да I_12345 Уникальный идентификатор объекта. Задайте поле item_id в объекте Item.
unit_price number Да 27,67 Цена товара без учета налогов, стоимости доставки и скидок на уровне события (транзакции).

Если на товар действует скидка, укажите цену за единицу с учетом скидки. Например, если цена за единицу товара составляет 27,67, а скидка за единицу товара – 6,66, то в атрибуте "цена со скидкой за единицу товара" unitPrice нужно указать значение 21,01.
quantity number Да 1 Количество единиц товара, приобретенных в рамках этой покупки.

Параметры

Имя Тип Обязательно? Пример значения Описание
shipping number Нет 243 Стоимость доставки, связанной с транзакцией.
tax number Нет 81 Сумма налога, связанного с транзакцией.

Параметры товара

Имя Тип Обязательно? Пример значения Описание
item_name string Да* Stan and Friends Tee

Название товара.

*Должен быть указан один из параметров: item_id или item_name.

affiliation string Нет Google Store Параметр, позволяющий установить принадлежность товара определенному поставщику или магазину.
Примечание. Параметр affiliation доступен только на уровне позиции.
coupon string Нет SUMMER_FUN Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
discount number Нет 2.22 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Adult Вторая категория или дополнительный разряд товара.
item_category3 string Нет Shirts Третья категория или дополнительный разряд товара.
item_category4 string Нет Crew Четвертая категория или дополнительный разряд товара.
item_category5 string Нет Short sleeve Пятая категория или дополнительный разряд товара.
item_list_id string Нет related_products Идентификатор списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_id на уровне события игнорируется.
Если нет, то параметр item_list_id используется (если он присутствует).
item_list_name string Нет Сопутствующие товары Название списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_name на уровне события игнорируется.
Если нет, то параметр item_list_name используется (если он присутствует).
item_variant string Нет зеленый Вариант товара или уникальный код/описание дополнительных сведений о товаре или его разновидности.
location_id string Нет ChIJIQBpAG2ahYAR_6128GcTUEo (идентификатор места Google для Сан-Франциско) Обычный магазин, в котором доступен товар (адрес магазина). Мы рекомендуем указать для связанного с товаром местоположения идентификатор Google, но можно использовать и собственный идентификатор.
Примечание. Параметр location_id доступен только на уровне позиции.
Помимо предписанных параметров, в массив items можно добавить до 27 специальных параметров.

Пример

В примере ниже показано, как отправить событие refund с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "refund",
      "conversionValue": 30.03,
      "currency": "USD",
      "transactionId": "T_12345",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": 3.33
        },
        {
          "parameterName": "tax",
          "value": 1.11
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

remove_from_cart

Это событие означает, что товар был удален из корзины.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта товаров, связанных с событием, в трехбуквенном формате ISO 4217.

* Показатели ценности события view_item не учитываются при расчете дохода.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

* Для параметра conversion_value задайте сумму значений (price * quantity) для всех объектов в items. Не указывайте shipping или tax.
* Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое, мы рекомендуем указать значение conversion_value.
* Если задан параметр conversion_value, то необходимо задать и параметр currency.
cart_data.items Item[] Да Товары, связанные с событием.

Задайте значение поля cart_data.items в объекте Event.

Поля товаров:

Название Тип Обязательно? Пример значения Описание
item_id string Да I_12345 Уникальный идентификатор объекта. Задайте поле item_id в объекте Item.
unit_price number Да 27,67 Цена товара без учета налогов, стоимости доставки и скидок на уровне события (транзакции).

Если на товар действует скидка, укажите цену за единицу с учетом скидки. Например, если цена за единицу товара составляет 27,67, а скидка за единицу товара – 6,66, то в атрибуте "цена со скидкой за единицу товара" unitPrice нужно указать значение 21,01.
quantity number Да 1 Количество единиц товара, приобретенных в рамках этой покупки.

Параметры товара

Имя Тип Обязательно? Пример значения Описание
item_name string Да* Stan and Friends Tee

Название товара.

*Должен быть указан один из параметров: item_id или item_name.

affiliation string Нет Google Store Параметр, позволяющий установить принадлежность товара определенному поставщику или магазину.
Примечание. Параметр affiliation доступен только на уровне позиции.
coupon string Нет SUMMER_FUN Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
discount number Нет 2.22 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Adult Вторая категория или дополнительный разряд товара.
item_category3 string Нет Shirts Третья категория или дополнительный разряд товара.
item_category4 string Нет Crew Четвертая категория или дополнительный разряд товара.
item_category5 string Нет Short sleeve Пятая категория или дополнительный разряд товара.
item_list_id string Нет related_products Идентификатор списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_id на уровне события игнорируется.
Если нет, то параметр item_list_id используется (если он присутствует).
item_list_name string Нет Сопутствующие товары Название списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_name на уровне события игнорируется.
Если нет, то параметр item_list_name используется (если он присутствует).
item_variant string Нет зеленый Вариант товара или уникальный код/описание дополнительных сведений о товаре или его разновидности.
location_id string Нет ChIJIQBpAG2ahYAR_6128GcTUEo (идентификатор места Google для Сан-Франциско) Обычный магазин, в котором доступен товар (адрес магазина). Мы рекомендуем указать для связанного с товаром местоположения идентификатор Google, но можно использовать и собственный идентификатор.
Примечание. Параметр location_id доступен только на уровне позиции.
Помимо предписанных параметров, в массив items можно добавить до 27 специальных параметров.

Пример

В примере ниже показано, как отправить событие remove_from_cart с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "remove_from_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "remove_from_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_item

Это событие означает, что товар был выбран из списка.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
cart_data.items Item[] Да* Товары, связанные с событием.

*В массиве items должен быть один элемент, представляющий выбранный товар. Если элементов несколько, то будет использоваться только первый элемент массива items.

Задайте значение поля cart_data.items в объекте Event.

Параметры

Имя Тип Обязательно? Пример значения Описание
item_list_id string Нет related_products Идентификатор списка, в котором пользователь увидел товар.

Игнорируется, если задан на уровне товара.
item_list_name string Нет Сопутствующие товары Название списка, в котором пользователь увидел товар.

Игнорируется, если задано на уровне товара.

Параметры товара

Имя Тип Обязательно? Пример значения Описание
item_name string Да* Stan and Friends Tee

Название товара.

*Должен быть указан один из параметров: item_id или item_name.

affiliation string Нет Google Store Параметр, позволяющий установить принадлежность товара определенному поставщику или магазину.
Примечание. Параметр affiliation доступен только на уровне позиции.
coupon string Нет SUMMER_FUN Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
discount number Нет 2.22 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Adult Вторая категория или дополнительный разряд товара.
item_category3 string Нет Shirts Третья категория или дополнительный разряд товара.
item_category4 string Нет Crew Четвертая категория или дополнительный разряд товара.
item_category5 string Нет Short sleeve Пятая категория или дополнительный разряд товара.
item_list_id string Нет related_products Идентификатор списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_id на уровне события игнорируется.
Если нет, то параметр item_list_id используется (если он присутствует).
item_list_name string Нет Сопутствующие товары Название списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_name на уровне события игнорируется.
Если нет, то параметр item_list_name используется (если он присутствует).
item_variant string Нет зеленый Вариант товара или уникальный код/описание дополнительных сведений о товаре или его разновидности.
location_id string Нет ChIJIQBpAG2ahYAR_6128GcTUEo (идентификатор места Google для Сан-Франциско) Обычный магазин, в котором доступен товар (адрес магазина). Мы рекомендуем указать для связанного с товаром местоположения идентификатор Google, но можно использовать и собственный идентификатор.
Примечание. Параметр location_id доступен только на уровне позиции.
Помимо предписанных параметров, в массив items можно добавить до 27 специальных параметров.

Пример

В примере ниже показано, как отправить событие select_item с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_item",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "select_item",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_promotion

Это событие означает, что промоакция была выбрана из списка.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
cart_data.items Item[] Нет Товары, связанные с событием.

Задайте значение поля cart_data.items в объекте Event.

Поля товаров:

Название Тип Обязательно? Пример значения Описание
item_id string Да I_12345 Уникальный идентификатор объекта. Задайте поле item_id в объекте Item.
unit_price number Да 27,67 Цена товара без учета налогов, стоимости доставки и скидок на уровне события (транзакции).

Если на товар действует скидка, укажите цену за единицу с учетом скидки. Например, если цена за единицу товара составляет 27,67, а скидка за единицу товара – 6,66, то в атрибуте "цена со скидкой за единицу товара" unitPrice нужно указать значение 21,01.
quantity number Да 1 Количество единиц товара, приобретенных в рамках этой покупки.

Параметры

Имя Тип Обязательно? Пример значения Описание
creative_name string Нет summer_banner2 Название используемого объявления.
creative_slot string Нет featured_app_1 Название рекламного места, связанного с событием.
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с событием.
promotion_name string Нет Summer Sale Название промоакции, связанной с событием.

Параметры товара

Имя Тип Обязательно? Пример значения Описание
item_name string Да* Stan and Friends Tee

Название товара.

*Должен быть указан один из параметров: item_id или item_name.

affiliation string Нет Google Store Параметр, позволяющий установить принадлежность товара определенному поставщику или магазину.
Примечание. Параметр affiliation доступен только на уровне позиции.
coupon string Нет SUMMER_FUN Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
creative_name string Нет summer_banner2 Название используемого объявления.

Если не задано, по умолчанию используется параметр creative_name на уровне события.
creative_slot string Нет featured_app_1 Название рекламного места, связанного с товаром.

Если не задано, по умолчанию используется параметр creative_slot на уровне события.
discount number Нет 2.22 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Adult Вторая категория или дополнительный разряд товара.
item_category3 string Нет Shirts Третья категория или дополнительный разряд товара.
item_category4 string Нет Crew Четвертая категория или дополнительный разряд товара.
item_category5 string Нет Short sleeve Пятая категория или дополнительный разряд товара.
item_list_id string Нет related_products Идентификатор списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_id на уровне события игнорируется.
Если нет, то параметр item_list_id используется (если он присутствует).
item_list_name string Нет Сопутствующие товары Название списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_name на уровне события игнорируется.
Если нет, то параметр item_list_name используется (если он присутствует).
item_variant string Нет зеленый Вариант товара или уникальный код/описание дополнительных сведений о товаре или его разновидности.
location_id string Нет ChIJIQBpAG2ahYAR_6128GcTUEo (идентификатор места Google для Сан-Франциско) Обычный магазин, в котором доступен товар (адрес магазина). Мы рекомендуем указать для связанного с товаром местоположения идентификатор Google, но можно использовать и собственный идентификатор.
Примечание. Параметр location_id доступен только на уровне позиции.
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с товаром.

Если не задано, по умолчанию используется параметр promotion_id на уровне события.
promotion_name string Нет Summer Sale Название промоакции, связанной с товаром.

Если не задано, по умолчанию используется параметр promotion_name на уровне события.
Помимо предписанных параметров, в массив items можно добавить до 27 специальных параметров.

Пример

В примере ниже показано, как отправить событие select_promotion с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "select_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_cart

Это событие означает, что пользователь посмотрел корзину.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта товаров, связанных с событием, в трехбуквенном формате ISO 4217.

* Показатели ценности события view_item не учитываются при расчете дохода.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

* Для параметра conversion_value задайте сумму значений (price * quantity) для всех объектов в items. Не указывайте shipping или tax.
* Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое, мы рекомендуем указать значение conversion_value.
* Если задан параметр conversion_value, то необходимо задать и параметр currency.
cart_data.items Item[] Да Товары, связанные с событием.

Задайте значение поля cart_data.items в объекте Event.

Поля товаров:

Название Тип Обязательно? Пример значения Описание
item_id string Да I_12345 Уникальный идентификатор объекта. Задайте поле item_id в объекте Item.
unit_price number Да 27,67 Цена товара без учета налогов, стоимости доставки и скидок на уровне события (транзакции).

Если на товар действует скидка, укажите цену за единицу с учетом скидки. Например, если цена за единицу товара составляет 27,67, а скидка за единицу товара – 6,66, то в атрибуте "цена со скидкой за единицу товара" unitPrice нужно указать значение 21,01.
quantity number Да 1 Количество единиц товара, приобретенных в рамках этой покупки.

Параметры товара

Имя Тип Обязательно? Пример значения Описание
item_name string Да* Stan and Friends Tee

Название товара.

*Должен быть указан один из параметров: item_id или item_name.

affiliation string Нет Google Store Параметр, позволяющий установить принадлежность товара определенному поставщику или магазину.
Примечание. Параметр affiliation доступен только на уровне позиции.
coupon string Нет SUMMER_FUN Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
discount number Нет 2.22 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Adult Вторая категория или дополнительный разряд товара.
item_category3 string Нет Shirts Третья категория или дополнительный разряд товара.
item_category4 string Нет Crew Четвертая категория или дополнительный разряд товара.
item_category5 string Нет Short sleeve Пятая категория или дополнительный разряд товара.
item_list_id string Нет related_products Идентификатор списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_id на уровне события игнорируется.
Если нет, то параметр item_list_id используется (если он присутствует).
item_list_name string Нет Сопутствующие товары Название списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_name на уровне события игнорируется.
Если нет, то параметр item_list_name используется (если он присутствует).
item_variant string Нет зеленый Вариант товара или уникальный код/описание дополнительных сведений о товаре или его разновидности.
location_id string Нет ChIJIQBpAG2ahYAR_6128GcTUEo (идентификатор места Google для Сан-Франциско) Обычный магазин, в котором доступен товар (адрес магазина). Мы рекомендуем указать для связанного с товаром местоположения идентификатор Google, но можно использовать и собственный идентификатор.
Примечание. Параметр location_id доступен только на уровне позиции.
Помимо предписанных параметров, в массив items можно добавить до 27 специальных параметров.

Пример

В примере ниже показано, как отправить событие view_cart с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_cart",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "view_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_item

Это событие означает, что пользователю был показан определенный контент. Оно поможет вам определить наиболее популярные разделы.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта товаров, связанных с событием, в трехбуквенном формате ISO 4217.

* Показатели ценности события view_item не учитываются при расчете дохода.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

* Для параметра conversion_value задайте сумму значений (price * quantity) для всех объектов в items. Не указывайте shipping или tax.
* Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое, мы рекомендуем указать значение conversion_value.
* Если задан параметр conversion_value, то необходимо задать и параметр currency.
cart_data.items Item[] Да Товары, связанные с событием.

Задайте значение поля cart_data.items в объекте Event.

Поля товаров:

Название Тип Обязательно? Пример значения Описание
item_id string Да I_12345 Уникальный идентификатор объекта. Задайте поле item_id в объекте Item.
unit_price number Да 27,67 Цена товара без учета налогов, стоимости доставки и скидок на уровне события (транзакции).

Если на товар действует скидка, укажите цену за единицу с учетом скидки. Например, если цена за единицу товара составляет 27,67, а скидка за единицу товара – 6,66, то в атрибуте "цена со скидкой за единицу товара" unitPrice нужно указать значение 21,01.
quantity number Да 1 Количество единиц товара, приобретенных в рамках этой покупки.

Параметры товара

Имя Тип Обязательно? Пример значения Описание
item_name string Да* Stan and Friends Tee

Название товара.

*Должен быть указан один из параметров: item_id или item_name.

affiliation string Нет Google Store Параметр, позволяющий установить принадлежность товара определенному поставщику или магазину.
Примечание. Параметр affiliation доступен только на уровне позиции.
coupon string Нет SUMMER_FUN Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
discount number Нет 2.22 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Adult Вторая категория или дополнительный разряд товара.
item_category3 string Нет Shirts Третья категория или дополнительный разряд товара.
item_category4 string Нет Crew Четвертая категория или дополнительный разряд товара.
item_category5 string Нет Short sleeve Пятая категория или дополнительный разряд товара.
item_list_id string Нет related_products Идентификатор списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_id на уровне события игнорируется.
Если нет, то параметр item_list_id используется (если он присутствует).
item_list_name string Нет Сопутствующие товары Название списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_name на уровне события игнорируется.
Если нет, то параметр item_list_name используется (если он присутствует).
item_variant string Нет зеленый Вариант товара или уникальный код/описание дополнительных сведений о товаре или его разновидности.
location_id string Нет ChIJIQBpAG2ahYAR_6128GcTUEo (идентификатор места Google для Сан-Франциско) Обычный магазин, в котором доступен товар (адрес магазина). Мы рекомендуем указать для связанного с товаром местоположения идентификатор Google, но можно использовать и собственный идентификатор.
Примечание. Параметр location_id доступен только на уровне позиции.
Помимо предписанных параметров, в массив items можно добавить до 27 специальных параметров.

Пример

В примере ниже показано, как отправить событие view_item с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "view_item",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ],
      }
    }]
  })
});

view_item_list

Это событие означает, что пользователю показан список товаров определенной категории.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта товаров, связанных с событием, в трехбуквенном формате ISO 4217.

* Показатели ценности события view_item не учитываются при расчете дохода.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
cart_data.items Item[] Да Товары, связанные с событием.

Задайте значение поля cart_data.items в объекте Event.

Поля товаров:

Название Тип Обязательно? Пример значения Описание
item_id string Да I_12345 Уникальный идентификатор объекта. Задайте поле item_id в объекте Item.
unit_price number Да 27,67 Цена товара без учета налогов, стоимости доставки и скидок на уровне события (транзакции).

Если на товар действует скидка, укажите цену за единицу с учетом скидки. Например, если цена за единицу товара составляет 27,67, а скидка за единицу товара – 6,66, то в атрибуте "цена со скидкой за единицу товара" unitPrice нужно указать значение 21,01.
quantity number Да 1 Количество единиц товара, приобретенных в рамках этой покупки.

Параметры товара

Имя Тип Обязательно? Пример значения Описание
item_name string Да* Stan and Friends Tee

Название товара.

*Должен быть указан один из параметров: item_id или item_name.

affiliation string Нет Google Store Параметр, позволяющий установить принадлежность товара определенному поставщику или магазину.
Примечание. Параметр affiliation доступен только на уровне позиции.
coupon string Нет SUMMER_FUN Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
discount number Нет 2.22 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Adult Вторая категория или дополнительный разряд товара.
item_category3 string Нет Shirts Третья категория или дополнительный разряд товара.
item_category4 string Нет Crew Четвертая категория или дополнительный разряд товара.
item_category5 string Нет Short sleeve Пятая категория или дополнительный разряд товара.
item_list_id string Нет related_products Идентификатор списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_id на уровне события игнорируется.
Если нет, то параметр item_list_id используется (если он присутствует).
item_list_name string Нет Сопутствующие товары Название списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_name на уровне события игнорируется.
Если нет, то параметр item_list_name используется (если он присутствует).
item_variant string Нет зеленый Вариант товара или уникальный код/описание дополнительных сведений о товаре или его разновидности.
location_id string Нет ChIJIQBpAG2ahYAR_6128GcTUEo (идентификатор места Google для Сан-Франциско) Обычный магазин, в котором доступен товар (адрес магазина). Мы рекомендуем указать для связанного с товаром местоположения идентификатор Google, но можно использовать и собственный идентификатор.
Примечание. Параметр location_id доступен только на уровне позиции.
Помимо предписанных параметров, в массив items можно добавить до 27 специальных параметров.

Пример

В примере ниже показано, как отправить событие view_item_list с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item_list",
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "view_item_list",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_promotion

Это событие означает, что промоакция из списка была просмотрена.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
cart_data.items Item[] Да* Товары, связанные с событием.

*В массиве items должен быть один элемент, представляющий товар, связанный с промоакцией. Если элементов несколько, то будет использоваться только первый элемент массива items.

Задайте значение поля cart_data.items в объекте Event.

Поля товаров:

Название Тип Обязательно? Пример значения Описание
item_id string Да I_12345 Уникальный идентификатор объекта. Задайте поле item_id в объекте Item.
unit_price number Да 27,67 Цена товара без учета налогов, стоимости доставки и скидок на уровне события (транзакции).

Если на товар действует скидка, укажите цену за единицу с учетом скидки. Например, если цена за единицу товара составляет 27,67, а скидка за единицу товара – 6,66, то в атрибуте "цена со скидкой за единицу товара" unitPrice нужно указать значение 21,01.
quantity number Да 1 Количество единиц товара, приобретенных в рамках этой покупки.

Параметры

Имя Тип Обязательно? Пример значения Описание
creative_name string Нет summer_banner2 Название используемого объявления.
creative_slot string Нет featured_app_1 Название рекламного места, связанного с событием.
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с событием.
promotion_name string Нет Summer Sale Название промоакции, связанной с событием.

Параметры товара

Имя Тип Обязательно? Пример значения Описание
item_name string Да* Stan and Friends Tee

Название товара.

*Должен быть указан один из параметров: item_id или item_name.

affiliation string Нет Google Store Параметр, позволяющий установить принадлежность товара определенному поставщику или магазину.
Примечание. Параметр affiliation доступен только на уровне позиции.
coupon string Нет SUMMER_FUN Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
creative_name string Нет summer_banner2 Название используемого объявления.

Если не задано, по умолчанию используется параметр creative_name на уровне события.
creative_slot string Нет featured_app_1 Название рекламного места, связанного с товаром.

Если не задано, по умолчанию используется параметр creative_slot на уровне события.
discount number Нет 2.22 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Adult Вторая категория или дополнительный разряд товара.
item_category3 string Нет Shirts Третья категория или дополнительный разряд товара.
item_category4 string Нет Crew Четвертая категория или дополнительный разряд товара.
item_category5 string Нет Short sleeve Пятая категория или дополнительный разряд товара.
item_list_id string Нет related_products Идентификатор списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_id на уровне события игнорируется.
Если нет, то параметр item_list_id используется (если он присутствует).
item_list_name string Нет Сопутствующие товары Название списка, в котором пользователь увидел товар.

Если это значение задано, то параметр item_list_name на уровне события игнорируется.
Если нет, то параметр item_list_name используется (если он присутствует).
item_variant string Нет зеленый Вариант товара или уникальный код/описание дополнительных сведений о товаре или его разновидности.
location_id string Нет ChIJIQBpAG2ahYAR_6128GcTUEo (идентификатор места Google для Сан-Франциско) Обычный магазин, в котором доступен товар (адрес магазина). Мы рекомендуем указать для связанного с товаром местоположения идентификатор Google, но можно использовать и собственный идентификатор.
Примечание. Параметр location_id доступен только на уровне позиции.
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с товаром.

Если не задано, по умолчанию используется параметр promotion_id на уровне события.
promotion_name string Нет Summer Sale Название промоакции, связанной с товаром.

Если не задано, по умолчанию используется параметр promotion_name на уровне события.
Помимо предписанных параметров, в массив items можно добавить до 27 специальных параметров.

Пример

В примере ниже показано, как отправить событие view_promotion с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "view_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

Игры

level_up

Это событие означает, что игрок достиг следующего уровня. Оно позволяет отслеживать распределение пользователей по уровням и определять те из них, которые трудно пройти.

Параметры

Имя Тип Обязательно? Пример значения Описание
level number Нет 5 Уровень персонажа.
character string Нет Player 1 Персонаж, который перешел на следующий уровень.

Пример

В примере ниже показано, как отправить событие level_up с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "level_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "level_up",
      "params": {
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

post_score

Это событие регистрируется, когда пользователь публикует свой счет. Оно поможет вам проанализировать результаты игроков, а также оценить связь рекордных показателей с поведением и свойствами аудиторий.

Параметры

Имя Тип Обязательно? Пример значения Описание
score number Да 10 000 Опубликованный счет.
level number Нет 5 Уровень, на котором получен счет.
character string Нет Player 1 Персонаж, который получил счет.

Пример

В примере ниже показано, как отправить событие post_score с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "post_score",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "score",
          "value": 10000
        },
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "post_score",
      "params": {
        "score": 10000,
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

unlock_achievement

Это событие означает, что разблокировано достижение. Оно поможет вам проанализировать взаимодействие пользователей с игрой.

Параметры

Имя Тип Обязательно? Пример значения Описание
achievement_id string Да A_12345 Идентификатор разблокированного достижения.

Пример

В примере ниже показано, как отправить событие unlock_achievement с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "unlock_achievement",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "achievement_id",
          "value": "A_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "unlock_achievement",
      "params": {
        "achievement_id": "A_12345"
      }
    }]
  })
});

Лидогенерация

close_convert_lead

Это событие означает, что квалифицированный лид успешно преобразован в клиента. Обычно это означает завершение процесса привлечения потенциальных клиентов, например подписание контракта, начало платной подписки или совершение окончательной продажи.

  • Примечание. Чтобы отслеживать привлечение лидов, например отправку форм, подписку на новостную рассылку или запрос демоверсии, используйте событие generate_lead.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта conversion_value события в трехбуквенном формате ISO 4217.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

*Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое событие, мы рекомендуем указать значение conversion_value.
*Если задан параметр conversion_value, то необходимо задать и параметр currency.

Пример

В примере ниже показано, как отправить событие close_convert_lead с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_convert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "close_convert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

close_unconvert_lead

Это событие регистрируется, когда пользователь отмечается как не ставший конвертированным лидом, а также указывается причина.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта conversion_value события в трехбуквенном формате ISO 4217.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

*Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое событие, мы рекомендуем указать значение conversion_value.
*Если задан параметр conversion_value, то необходимо задать и параметр currency.

Параметры

Имя Тип Обязательно? Пример значения Описание
unconvert_lead_reason string Нет Нет ответа Причина, по которой лид не осуществил конверсию.

Пример

В примере ниже показано, как отправить событие close_unconvert_lead с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_unconvert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "unconvert_lead_reason",
          "value": "Never responded"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded"
      }
    }]
  })
});

disqualify_lead

Это событие регистрируется, когда пользователь отмечен как неподходящий в качестве клиента, а также указывается причина дисквалификации.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта conversion_value события в трехбуквенном формате ISO 4217.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

*Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое событие, мы рекомендуем указать значение conversion_value.
*Если задан параметр conversion_value, то необходимо задать и параметр currency.

Параметры

Имя Тип Обязательно? Пример значения Описание
disqualified_lead_reason string Нет Не хочу покупать Причина, по которой лид обозначен как дисквалифицированный.

Пример

В примере ниже показано, как отправить событие disqualify_lead с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "disqualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "disqualified_lead_reason",
          "value": "Not looking to buy"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "disqualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "disqualified_lead_reason": "Not looking to buy"
      }
    }]
  })
});

generate_lead

Это событие означает, что был зарегистрирован потенциальный клиент (например, через форму). Регистрируя такие события, вы сможете оценивать эффективность кампаний и получать данные о том, сколько клиентов удалось повторно привлечь с помощью ремаркетинга.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта conversion_value события в трехбуквенном формате ISO 4217.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

*Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое событие, мы рекомендуем указать значение conversion_value.
*Если задан параметр conversion_value, то необходимо задать и параметр currency.

Параметры

Имя Тип Обязательно? Пример значения Описание
lead_source string Нет Выставка Источник лида.

Пример

В примере ниже показано, как отправить событие generate_lead с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "generate_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_source",
          "value": "Trade show"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_source": "Trade show"
      }
    }]
  })
});

qualify_lead

Это событие означает, что пользователь отмечен как соответствующий критериям для регистрации в качестве квалифицированного лида.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта conversion_value события в трехбуквенном формате ISO 4217.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

*Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое событие, мы рекомендуем указать значение conversion_value.
*Если задан параметр conversion_value, то необходимо задать и параметр currency.

Пример

В примере ниже показано, как отправить событие qualify_lead с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "qualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "qualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

working_lead

Это событие регистрируется, когда пользователь связывается с представителем компании и наоборот.

Поля типа обращения event

Название Тип Обязательно? Пример значения Описание
currency string Да* USD Валюта conversion_value события в трехбуквенном формате ISO 4217.

* Если задан параметр conversion_value, то необходимо задать и параметр currency. Это позволит точно рассчитывать показатели дохода.
conversion_value number Да* 30.03 Денежная ценность события.

*Параметр conversion_value обычно требуется для содержательных отчетов. Если событие помечено как ключевое событие, мы рекомендуем указать значение conversion_value.
*Если задан параметр conversion_value, то необходимо задать и параметр currency.

Параметры

Имя Тип Обязательно? Пример значения Описание
lead_status string Нет Начатые чаты Статус потенциального клиента.

Пример

В примере ниже показано, как отправить событие working_lead с помощью Data Manager API. Если вы переходите с Measurement Protocol, используйте вкладки, чтобы перенести запросы в Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "working_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_status",
          "value": "Started conversations"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations"
      }
    }]
  })
});