События

add_payment_info

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

Параметры

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

Если это значение задано, то параметр currency на уровне товара игнорируется.
Если нет, то используется валюта первого товара из массива items.

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

*Параметр value обычно требуется для содержательных отчетов. Если событие помечено как конверсия, мы рекомендуем указать значение value.
*Если задан параметр value, то необходимо задать и параметр currency.
coupon string Нет YARKOE_LETO Название или код купона, связанного с событием.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
payment_type string Нет Кредитная карта Выбранный способ оплаты.
items Array<Item> Да Товары, связанные с событием.

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

Имя Тип Обязательно? Пример значения Описание
item_id string Да* SKU_12345

Идентификатор товара.

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

item_name string Да* Футболка с принтом

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

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

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

Параметры affiliation на уровне события и на уровне товара не зависят друг от друга.
coupon string Нет YARKOE_LETO Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
currency string Нет RUB Код валюты в трехбуквенном формате ISO 4217.

Если это значение задано, то параметр currency на уровне события игнорируется.

Для одного события нельзя указать несколько валют. Для всех товаров должна использоваться одна и та же валюта.
creative_name string Нет leto_banner2 Название используемого объявления.

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

Если это значение задано, то параметр creative_slot на уровне события игнорируется.
Если нет, то параметр creative_slot используется (если он присутствует).
discount number Нет 163 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Для взрослых Вторая категория или дополнительный разряд товара.
item_category3 string Нет Футболки Третья категория или дополнительный разряд товара.
item_category4 string Нет Партия Четвертая категория или дополнительный разряд товара.
item_category5 string Нет С коротким рукавом Пятая категория или дополнительный разряд товара.
item_list_id string Нет soputstvuyushchie_tovary Идентификатор списка, в котором пользователь увидел товар.

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

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

Если это значение задано, то параметр location_id на уровне события игнорируется.
Если нет, то параметр location_id используется (если он присутствует).
price number Нет 734 Денежная стоимость товара (в указанной валюте).
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_id на уровне события игнорируется.
Если нет, то параметр promotion_id используется (если он присутствует).
promotion_name string Нет Летняя распродажа Название промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_name на уровне события игнорируется.
Если нет, то параметр promotion_name используется (если он присутствует).
quantity number Нет 1

Количество единиц товара.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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": 7.77,
        "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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

add_shipping_info

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

Параметры

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

Если это значение задано, то параметр currency на уровне товара игнорируется.
Если нет, то используется валюта первого товара из массива items.

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

*Параметр value обычно требуется для содержательных отчетов. Если событие помечено как конверсия, мы рекомендуем указать значение value.
*Если задан параметр value, то необходимо задать и параметр currency.
coupon string Нет YARKOE_LETO Название или код купона, связанного с событием.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
shipping_tier string Нет Наземная Категория доставки (например, Ground, Air или Next-day), выбранная для купленного товара.
items Array<Item> Да Товары, связанные с событием.

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

Имя Тип Обязательно? Пример значения Описание
item_id string Да* SKU_12345

Идентификатор товара.

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

item_name string Да* Футболка с принтом

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

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

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

Параметры affiliation на уровне события и на уровне товара не зависят друг от друга.
coupon string Нет YARKOE_LETO Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
currency string Нет RUB Код валюты в трехбуквенном формате ISO 4217.

Если это значение задано, то параметр currency на уровне события игнорируется.

Для одного события нельзя указать несколько валют. Для всех товаров должна использоваться одна и та же валюта.
creative_name string Нет leto_banner2 Название используемого объявления.

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

Если это значение задано, то параметр creative_slot на уровне события игнорируется.
Если нет, то параметр creative_slot используется (если он присутствует).
discount number Нет 163 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Для взрослых Вторая категория или дополнительный разряд товара.
item_category3 string Нет Футболки Третья категория или дополнительный разряд товара.
item_category4 string Нет Партия Четвертая категория или дополнительный разряд товара.
item_category5 string Нет С коротким рукавом Пятая категория или дополнительный разряд товара.
item_list_id string Нет soputstvuyushchie_tovary Идентификатор списка, в котором пользователь увидел товар.

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

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

Если это значение задано, то параметр location_id на уровне события игнорируется.
Если нет, то параметр location_id используется (если он присутствует).
price number Нет 734 Денежная стоимость товара (в указанной валюте).
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_id на уровне события игнорируется.
Если нет, то параметр promotion_id используется (если он присутствует).
promotion_name string Нет Летняя распродажа Название промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_name на уровне события игнорируется.
Если нет, то параметр promotion_name используется (если он присутствует).
quantity number Нет 1

Количество единиц товара.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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": 7.77,
        "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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

add_to_cart

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

Параметры

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

Если это значение задано, то параметр currency на уровне товара игнорируется.
Если нет, то используется валюта первого товара из массива items.

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

*Параметр value обычно требуется для содержательных отчетов. Если событие помечено как конверсия, мы рекомендуем указать значение value.
*Если задан параметр value, то необходимо задать и параметр currency.
items Array<Item> Да Товары, связанные с событием.

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

Имя Тип Обязательно? Пример значения Описание
item_id string Да* SKU_12345

Идентификатор товара.

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

item_name string Да* Футболка с принтом

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

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

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

Параметры affiliation на уровне события и на уровне товара не зависят друг от друга.
coupon string Нет YARKOE_LETO Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
currency string Нет RUB Код валюты в трехбуквенном формате ISO 4217.

Если это значение задано, то параметр currency на уровне события игнорируется.

Для одного события нельзя указать несколько валют. Для всех товаров должна использоваться одна и та же валюта.
creative_name string Нет leto_banner2 Название используемого объявления.

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

Если это значение задано, то параметр creative_slot на уровне события игнорируется.
Если нет, то параметр creative_slot используется (если он присутствует).
discount number Нет 163 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Для взрослых Вторая категория или дополнительный разряд товара.
item_category3 string Нет Футболки Третья категория или дополнительный разряд товара.
item_category4 string Нет Партия Четвертая категория или дополнительный разряд товара.
item_category5 string Нет С коротким рукавом Пятая категория или дополнительный разряд товара.
item_list_id string Нет soputstvuyushchie_tovary Идентификатор списка, в котором пользователь увидел товар.

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

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

Если это значение задано, то параметр location_id на уровне события игнорируется.
Если нет, то параметр location_id используется (если он присутствует).
price number Нет 734 Денежная стоимость товара (в указанной валюте).
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_id на уровне события игнорируется.
Если нет, то параметр promotion_id используется (если он присутствует).
promotion_name string Нет Летняя распродажа Название промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_name на уровне события игнорируется.
Если нет, то параметр promotion_name используется (если он присутствует).
quantity number Нет 1

Количество единиц товара.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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": 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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

add_to_wishlist

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

Параметры

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

Если это значение задано, то параметр currency на уровне товара игнорируется.
Если нет, то используется валюта первого товара из массива items.

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

*Параметр value обычно требуется для содержательных отчетов. Если событие помечено как конверсия, мы рекомендуем указать значение value.
*Если задан параметр value, то необходимо задать и параметр currency.
items Array<Item> Да Товары, связанные с событием.

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

Имя Тип Обязательно? Пример значения Описание
item_id string Да* SKU_12345

Идентификатор товара.

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

item_name string Да* Футболка с принтом

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

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

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

Параметры affiliation на уровне события и на уровне товара не зависят друг от друга.
coupon string Нет YARKOE_LETO Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
currency string Нет RUB Код валюты в трехбуквенном формате ISO 4217.

Если это значение задано, то параметр currency на уровне события игнорируется.

Для одного события нельзя указать несколько валют. Для всех товаров должна использоваться одна и та же валюта.
creative_name string Нет leto_banner2 Название используемого объявления.

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

Если это значение задано, то параметр creative_slot на уровне события игнорируется.
Если нет, то параметр creative_slot используется (если он присутствует).
discount number Нет 163 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Для взрослых Вторая категория или дополнительный разряд товара.
item_category3 string Нет Футболки Третья категория или дополнительный разряд товара.
item_category4 string Нет Партия Четвертая категория или дополнительный разряд товара.
item_category5 string Нет С коротким рукавом Пятая категория или дополнительный разряд товара.
item_list_id string Нет soputstvuyushchie_tovary Идентификатор списка, в котором пользователь увидел товар.

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

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

Если это значение задано, то параметр location_id на уровне события игнорируется.
Если нет, то параметр location_id используется (если он присутствует).
price number Нет 734 Денежная стоимость товара (в указанной валюте).
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_id на уровне события игнорируется.
Если нет, то параметр promotion_id используется (если он присутствует).
promotion_name string Нет Летняя распродажа Название промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_name на уровне события игнорируется.
Если нет, то параметр promotion_name используется (если он присутствует).
quantity number Нет 1

Количество единиц товара.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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": 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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

begin_checkout

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

Параметры

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

Если это значение задано, то параметр currency на уровне товара игнорируется.
Если нет, то используется валюта первого товара из массива items.

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

*Параметр value обычно требуется для содержательных отчетов. Если событие помечено как конверсия, мы рекомендуем указать значение value.
*Если задан параметр value, то необходимо задать и параметр currency.
coupon string Нет YARKOE_LETO Название или код купона, связанного с событием.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
items Array<Item> Да Товары, связанные с событием.

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

Имя Тип Обязательно? Пример значения Описание
item_id string Да* SKU_12345

Идентификатор товара.

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

item_name string Да* Футболка с принтом

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

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

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

Параметры affiliation на уровне события и на уровне товара не зависят друг от друга.
coupon string Нет YARKOE_LETO Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
currency string Нет RUB Код валюты в трехбуквенном формате ISO 4217.

Если это значение задано, то параметр currency на уровне события игнорируется.

Для одного события нельзя указать несколько валют. Для всех товаров должна использоваться одна и та же валюта.
creative_name string Нет leto_banner2 Название используемого объявления.

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

Если это значение задано, то параметр creative_slot на уровне события игнорируется.
Если нет, то параметр creative_slot используется (если он присутствует).
discount number Нет 163 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Для взрослых Вторая категория или дополнительный разряд товара.
item_category3 string Нет Футболки Третья категория или дополнительный разряд товара.
item_category4 string Нет Партия Четвертая категория или дополнительный разряд товара.
item_category5 string Нет С коротким рукавом Пятая категория или дополнительный разряд товара.
item_list_id string Нет soputstvuyushchie_tovary Идентификатор списка, в котором пользователь увидел товар.

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

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

Если это значение задано, то параметр location_id на уровне события игнорируется.
Если нет, то параметр location_id используется (если он присутствует).
price number Нет 734 Денежная стоимость товара (в указанной валюте).
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_id на уровне события игнорируется.
Если нет, то параметр promotion_id используется (если он присутствует).
promotion_name string Нет Летняя распродажа Название промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_name на уровне события игнорируется.
Если нет, то параметр promotion_name используется (если он присутствует).
quantity number Нет 1

Количество единиц товара.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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": 7.77,
        "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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

earn_virtual_currency

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

Параметры

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

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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
      }
    }]
  })
});

generate_lead

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

Параметры

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

Если это значение задано, то параметр currency на уровне товара игнорируется.
Если нет, то используется валюта первого товара из массива items.

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

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

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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": 99.99
      }
    }]
  })
});

join_group

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

Параметры

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

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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"
      }
    }]
  })
});

level_up

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

Параметры

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

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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"
      }
    }]
  })
});

login

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

Параметры

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

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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"
      }
    }]
  })
});

post_score

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

Параметры

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

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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"
      }
    }]
  })
});

purchase

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

Параметры

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

Если это значение задано, то параметр currency на уровне товара игнорируется.
Если нет, то используется валюта первого товара из массива items.

*Если задан параметр value, то необходимо задать и параметр currency. Это позволит точно рассчитать показатели дохода.
transaction_id string Да T_12345 Уникальный идентификатор транзакции.

С помощью параметра transaction_id можно избежать дублирования события при покупке.
value number Да* 987 Денежная ценность события.

*Параметр value требуется для содержательных отчетов, а также для заполнения прогнозируемой аудитории Покупатели.
*Если задан параметр value, то необходимо задать и параметр currency.
affiliation string Нет Google Store Параметр, позволяющий установить принадлежность товара определенному поставщику или магазину.

Параметры affiliation на уровне события и на уровне товара не зависят друг от друга.
coupon string Нет YARKOE_LETO Название или код купона, связанного с событием.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
shipping number Нет 243 Стоимость доставки, связанной с транзакцией.
tax number Нет 81 Сумма налога, связанного с транзакцией.
items Array<Item> Да Товары, связанные с событием.

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

Имя Тип Обязательно? Пример значения Описание
item_id string Да* SKU_12345

Идентификатор товара.

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

item_name string Да* Футболка с принтом

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

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

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

Параметры affiliation на уровне события и на уровне товара не зависят друг от друга.
coupon string Нет YARKOE_LETO Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
currency string Нет RUB Код валюты в трехбуквенном формате ISO 4217.

Если это значение задано, то параметр currency на уровне события игнорируется.

Для одного события нельзя указать несколько валют. Для всех товаров должна использоваться одна и та же валюта.
creative_name string Нет leto_banner2 Название используемого объявления.

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

Если это значение задано, то параметр creative_slot на уровне события игнорируется.
Если нет, то параметр creative_slot используется (если он присутствует).
discount number Нет 163 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Для взрослых Вторая категория или дополнительный разряд товара.
item_category3 string Нет Футболки Третья категория или дополнительный разряд товара.
item_category4 string Нет Партия Четвертая категория или дополнительный разряд товара.
item_category5 string Нет С коротким рукавом Пятая категория или дополнительный разряд товара.
item_list_id string Нет soputstvuyushchie_tovary Идентификатор списка, в котором пользователь увидел товар.

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

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

Если это значение задано, то параметр location_id на уровне события игнорируется.
Если нет, то параметр location_id используется (если он присутствует).
price number Нет 734 Денежная стоимость товара (в указанной валюте).
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_id на уровне события игнорируется.
Если нет, то параметр promotion_id используется (если он присутствует).
promotion_name string Нет Летняя распродажа Название промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_name на уровне события игнорируется.
Если нет, то параметр promotion_name используется (если он присутствует).
quantity number Нет 1

Количество единиц товара.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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": 12.21,
        "affiliation": "Google Store",
        "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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

refund

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

Параметры

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

Если это значение задано, то параметр currency на уровне товара игнорируется.
Если нет, то используется валюта первого товара из массива items.

*Если задан параметр value, то необходимо задать и параметр currency. Это позволит точно рассчитать показатели дохода.
transaction_id string Да T_12345 Уникальный идентификатор транзакции.
value number Да* 570 Денежная ценность события.

*Параметр value обычно требуется для содержательных отчетов. Если событие помечено как конверсия, мы рекомендуем указать значение value.
*Если задан параметр value, то необходимо задать и параметр currency.
affiliation string Нет Google Store Параметр, позволяющий установить принадлежность товара определенному поставщику или магазину.

Параметры affiliation на уровне события и на уровне товара не зависят друг от друга.
coupon string Нет YARKOE_LETO Название или код купона, связанного с событием.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
shipping number Нет 243 Стоимость доставки, связанной с транзакцией.
tax number Нет 81 Сумма налога, связанного с транзакцией.
items Array<Item> Нет* Товары, связанные с событием.

*Параметр items требуется для частичного возврата средств, но может быть опущен при полном возврате.

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

Имя Тип Обязательно? Пример значения Описание
item_id string Да* SKU_12345

Идентификатор товара.

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

item_name string Да* Футболка с принтом

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

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

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

Параметры affiliation на уровне события и на уровне товара не зависят друг от друга.
coupon string Нет YARKOE_LETO Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
currency string Нет RUB Код валюты в трехбуквенном формате ISO 4217.

Если это значение задано, то параметр currency на уровне события игнорируется.

Для одного события нельзя указать несколько валют. Для всех товаров должна использоваться одна и та же валюта.
creative_name string Нет leto_banner2 Название используемого объявления.

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

Если это значение задано, то параметр creative_slot на уровне события игнорируется.
Если нет, то параметр creative_slot используется (если он присутствует).
discount number Нет 163 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Для взрослых Вторая категория или дополнительный разряд товара.
item_category3 string Нет Футболки Третья категория или дополнительный разряд товара.
item_category4 string Нет Партия Четвертая категория или дополнительный разряд товара.
item_category5 string Нет С коротким рукавом Пятая категория или дополнительный разряд товара.
item_list_id string Нет soputstvuyushchie_tovary Идентификатор списка, в котором пользователь увидел товар.

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

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

Если это значение задано, то параметр location_id на уровне события игнорируется.
Если нет, то параметр location_id используется (если он присутствует).
price number Нет 734 Денежная стоимость товара (в указанной валюте).
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_id на уровне события игнорируется.
Если нет, то параметр promotion_id используется (если он присутствует).
promotion_name string Нет Летняя распродажа Название промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_name на уровне события игнорируется.
Если нет, то параметр promotion_name используется (если он присутствует).
quantity number Нет 1

Количество единиц товара.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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": 12.21,
        "affiliation": "Google Store",
        "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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

remove_from_cart

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

Параметры

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

Если это значение задано, то параметр currency на уровне товара игнорируется.
Если нет, то используется валюта первого товара из массива items.

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

*Параметр value обычно требуется для содержательных отчетов. Если событие помечено как конверсия, мы рекомендуем указать значение value.
*Если задан параметр value, то необходимо задать и параметр currency.
items Array<Item> Да Товары, связанные с событием.

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

Имя Тип Обязательно? Пример значения Описание
item_id string Да* SKU_12345

Идентификатор товара.

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

item_name string Да* Футболка с принтом

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

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

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

Параметры affiliation на уровне события и на уровне товара не зависят друг от друга.
coupon string Нет YARKOE_LETO Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
currency string Нет RUB Код валюты в трехбуквенном формате ISO 4217.

Если это значение задано, то параметр currency на уровне события игнорируется.

Для одного события нельзя указать несколько валют. Для всех товаров должна использоваться одна и та же валюта.
creative_name string Нет leto_banner2 Название используемого объявления.

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

Если это значение задано, то параметр creative_slot на уровне события игнорируется.
Если нет, то параметр creative_slot используется (если он присутствует).
discount number Нет 163 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Для взрослых Вторая категория или дополнительный разряд товара.
item_category3 string Нет Футболки Третья категория или дополнительный разряд товара.
item_category4 string Нет Партия Четвертая категория или дополнительный разряд товара.
item_category5 string Нет С коротким рукавом Пятая категория или дополнительный разряд товара.
item_list_id string Нет soputstvuyushchie_tovary Идентификатор списка, в котором пользователь увидел товар.

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

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

Если это значение задано, то параметр location_id на уровне события игнорируется.
Если нет, то параметр location_id используется (если он присутствует).
price number Нет 734 Денежная стоимость товара (в указанной валюте).
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_id на уровне события игнорируется.
Если нет, то параметр promotion_id используется (если он присутствует).
promotion_name string Нет Летняя распродажа Название промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_name на уровне события игнорируется.
Если нет, то параметр promotion_name используется (если он присутствует).
quantity number Нет 1

Количество единиц товара.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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": 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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

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

Параметры

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

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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 Нет продукт Тип выбранного контента.
item_id string Нет I_12345 Идентификатор выбранного объекта.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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",
        "item_id": "I_12345"
      }
    }]
  })
});

select_item

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

Параметры

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

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

Игнорируется, если задано на уровне товара.
items Array<Item> Да* Товары, связанные с событием.

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

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

Имя Тип Обязательно? Пример значения Описание
item_id string Да* SKU_12345

Идентификатор товара.

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

item_name string Да* Футболка с принтом

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

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

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

Параметры affiliation на уровне события и на уровне товара не зависят друг от друга.
coupon string Нет YARKOE_LETO Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
currency string Нет RUB Код валюты в трехбуквенном формате ISO 4217.

Если это значение задано, то параметр currency на уровне события игнорируется.

Для одного события нельзя указать несколько валют. Для всех товаров должна использоваться одна и та же валюта.
creative_name string Нет leto_banner2 Название используемого объявления.

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

Если это значение задано, то параметр creative_slot на уровне события игнорируется.
Если нет, то параметр creative_slot используется (если он присутствует).
discount number Нет 163 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Для взрослых Вторая категория или дополнительный разряд товара.
item_category3 string Нет Футболки Третья категория или дополнительный разряд товара.
item_category4 string Нет Партия Четвертая категория или дополнительный разряд товара.
item_category5 string Нет С коротким рукавом Пятая категория или дополнительный разряд товара.
item_list_id string Нет soputstvuyushchie_tovary Идентификатор списка, в котором пользователь увидел товар.

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

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

Если это значение задано, то параметр location_id на уровне события игнорируется.
Если нет, то параметр location_id используется (если он присутствует).
price number Нет 734 Денежная стоимость товара (в указанной валюте).
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_id на уровне события игнорируется.
Если нет, то параметр promotion_id используется (если он присутствует).
promotion_name string Нет Летняя распродажа Название промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_name на уровне события игнорируется.
Если нет, то параметр promotion_name используется (если он присутствует).
quantity number Нет 1

Количество единиц товара.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

select_promotion

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

Параметры

Имя Тип Обязательно? Пример значения Описание
creative_name string Нет leto_banner2 Название используемого объявления.

Игнорируется, если задано на уровне товара.
creative_slot string Нет glavnoe_prilozhenie_1 Название рекламного места, связанного с событием.

Игнорируется, если задано на уровне товара.
location_id string Нет L_12345 Идентификатор местоположения.

Игнорируется, если задан на уровне товара.
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с событием.

Игнорируется, если задан на уровне товара.
promotion_name string Нет Летняя распродажа Название промоакции, связанной с событием.

Игнорируется, если задано на уровне товара.
items Array<Item> Нет Товары, связанные с событием.

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

Имя Тип Обязательно? Пример значения Описание
item_id string Да* SKU_12345

Идентификатор товара.

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

item_name string Да* Футболка с принтом

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

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

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

Параметры affiliation на уровне события и на уровне товара не зависят друг от друга.
coupon string Нет YARKOE_LETO Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
currency string Нет RUB Код валюты в трехбуквенном формате ISO 4217.

Если это значение задано, то параметр currency на уровне события игнорируется.

Для одного события нельзя указать несколько валют. Для всех товаров должна использоваться одна и та же валюта.
creative_name string Нет leto_banner2 Название используемого объявления.

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

Если это значение задано, то параметр creative_slot на уровне события игнорируется.
Если нет, то параметр creative_slot используется (если он присутствует).
discount number Нет 163 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Для взрослых Вторая категория или дополнительный разряд товара.
item_category3 string Нет Футболки Третья категория или дополнительный разряд товара.
item_category4 string Нет Партия Четвертая категория или дополнительный разряд товара.
item_category5 string Нет С коротким рукавом Пятая категория или дополнительный разряд товара.
item_list_id string Нет soputstvuyushchie_tovary Идентификатор списка, в котором пользователь увидел товар.

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

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

Если это значение задано, то параметр location_id на уровне события игнорируется.
Если нет, то параметр location_id используется (если он присутствует).
price number Нет 734 Денежная стоимость товара (в указанной валюте).
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_id на уровне события игнорируется.
Если нет, то параметр promotion_id используется (если он присутствует).
promotion_name string Нет Летняя распродажа Название промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_name на уровне события игнорируется.
Если нет, то параметр promotion_name используется (если он присутствует).
quantity number Нет 1

Количество единиц товара.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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",
        "location_id": "L_12345",
        "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": "L_12345",
            "price": 9.99,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 1
          }
        ]
      }
    }]
  })
});

share

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

Параметры

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

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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 Выбранный способ регистрации.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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

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

Параметры

Имя Тип Обязательно? Пример значения Описание
value number Да 5 Стоимость виртуальной валюты.
virtual_currency_name string Да Кристаллы Название виртуальной валюты.
item_name string Нет Повышенные бонусы Название товара, на который тратится виртуальная валюта.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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, чтобы узнать, какой процент пользователей завершил обучение.

Параметры

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

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

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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, чтобы узнать, какой процент пользователей завершил обучение.

Параметры

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

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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"
    }]
  })
});

unlock_achievement

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

Параметры

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

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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"
      }
    }]
  })
});

view_cart

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

Параметры

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

Если это значение задано, то параметр currency на уровне товара игнорируется.
Если нет, то используется валюта первого товара из массива items.

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

*Параметр value обычно требуется для содержательных отчетов. Если событие помечено как конверсия, мы рекомендуем указать значение value.
*Если задан параметр value, то необходимо задать и параметр currency.
items Array<Item> Да Товары, связанные с событием.

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

Имя Тип Обязательно? Пример значения Описание
item_id string Да* SKU_12345

Идентификатор товара.

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

item_name string Да* Футболка с принтом

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

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

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

Параметры affiliation на уровне события и на уровне товара не зависят друг от друга.
coupon string Нет YARKOE_LETO Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
currency string Нет RUB Код валюты в трехбуквенном формате ISO 4217.

Если это значение задано, то параметр currency на уровне события игнорируется.

Для одного события нельзя указать несколько валют. Для всех товаров должна использоваться одна и та же валюта.
creative_name string Нет leto_banner2 Название используемого объявления.

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

Если это значение задано, то параметр creative_slot на уровне события игнорируется.
Если нет, то параметр creative_slot используется (если он присутствует).
discount number Нет 163 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Для взрослых Вторая категория или дополнительный разряд товара.
item_category3 string Нет Футболки Третья категория или дополнительный разряд товара.
item_category4 string Нет Партия Четвертая категория или дополнительный разряд товара.
item_category5 string Нет С коротким рукавом Пятая категория или дополнительный разряд товара.
item_list_id string Нет soputstvuyushchie_tovary Идентификатор списка, в котором пользователь увидел товар.

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

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

Если это значение задано, то параметр location_id на уровне события игнорируется.
Если нет, то параметр location_id используется (если он присутствует).
price number Нет 734 Денежная стоимость товара (в указанной валюте).
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_id на уровне события игнорируется.
Если нет, то параметр promotion_id используется (если он присутствует).
promotion_name string Нет Летняя распродажа Название промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_name на уровне события игнорируется.
Если нет, то параметр promotion_name используется (если он присутствует).
quantity number Нет 1

Количество единиц товара.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_item

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

Параметры

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

Если это значение задано, то параметр currency на уровне товара игнорируется.
Если нет, то используется валюта первого товара из массива items.

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

*Параметр value обычно требуется для содержательных отчетов. Если событие помечено как конверсия, мы рекомендуем указать значение value.
*Если задан параметр value, то необходимо задать и параметр currency.
items Array<Item> Да Товары, связанные с событием.

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

Имя Тип Обязательно? Пример значения Описание
item_id string Да* SKU_12345

Идентификатор товара.

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

item_name string Да* Футболка с принтом

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

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

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

Параметры affiliation на уровне события и на уровне товара не зависят друг от друга.
coupon string Нет YARKOE_LETO Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
currency string Нет RUB Код валюты в трехбуквенном формате ISO 4217.

Если это значение задано, то параметр currency на уровне события игнорируется.

Для одного события нельзя указать несколько валют. Для всех товаров должна использоваться одна и та же валюта.
creative_name string Нет leto_banner2 Название используемого объявления.

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

Если это значение задано, то параметр creative_slot на уровне события игнорируется.
Если нет, то параметр creative_slot используется (если он присутствует).
discount number Нет 163 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Для взрослых Вторая категория или дополнительный разряд товара.
item_category3 string Нет Футболки Третья категория или дополнительный разряд товара.
item_category4 string Нет Партия Четвертая категория или дополнительный разряд товара.
item_category5 string Нет С коротким рукавом Пятая категория или дополнительный разряд товара.
item_list_id string Нет soputstvuyushchie_tovary Идентификатор списка, в котором пользователь увидел товар.

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

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

Если это значение задано, то параметр location_id на уровне события игнорируется.
Если нет, то параметр location_id используется (если он присутствует).
price number Нет 734 Денежная стоимость товара (в указанной валюте).
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_id на уровне события игнорируется.
Если нет, то параметр promotion_id используется (если он присутствует).
promotion_name string Нет Летняя распродажа Название промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_name на уровне события игнорируется.
Если нет, то параметр promotion_name используется (если он присутствует).
quantity number Нет 1

Количество единиц товара.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ],
      }
    }]
  })
});

view_item_list

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

Параметры

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

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

Игнорируется, если задано на уровне товара.
items Array<Item> Да Товары, связанные с событием.

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

Имя Тип Обязательно? Пример значения Описание
item_id string Да* SKU_12345

Идентификатор товара.

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

item_name string Да* Футболка с принтом

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

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

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

Параметры affiliation на уровне события и на уровне товара не зависят друг от друга.
coupon string Нет YARKOE_LETO Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
currency string Нет RUB Код валюты в трехбуквенном формате ISO 4217.

Если это значение задано, то параметр currency на уровне события игнорируется.

Для одного события нельзя указать несколько валют. Для всех товаров должна использоваться одна и та же валюта.
creative_name string Нет leto_banner2 Название используемого объявления.

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

Если это значение задано, то параметр creative_slot на уровне события игнорируется.
Если нет, то параметр creative_slot используется (если он присутствует).
discount number Нет 163 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Для взрослых Вторая категория или дополнительный разряд товара.
item_category3 string Нет Футболки Третья категория или дополнительный разряд товара.
item_category4 string Нет Партия Четвертая категория или дополнительный разряд товара.
item_category5 string Нет С коротким рукавом Пятая категория или дополнительный разряд товара.
item_list_id string Нет soputstvuyushchie_tovary Идентификатор списка, в котором пользователь увидел товар.

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

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

Если это значение задано, то параметр location_id на уровне события игнорируется.
Если нет, то параметр location_id используется (если он присутствует).
price number Нет 734 Денежная стоимость товара (в указанной валюте).
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_id на уровне события игнорируется.
Если нет, то параметр promotion_id используется (если он присутствует).
promotion_name string Нет Летняя распродажа Название промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_name на уровне события игнорируется.
Если нет, то параметр promotion_name используется (если он присутствует).
quantity number Нет 1

Количество единиц товара.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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": "L_12345",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_promotion

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

Параметры

Имя Тип Обязательно? Пример значения Описание
creative_name string Нет leto_banner2 Название используемого объявления.

Игнорируется, если задано на уровне товара.
creative_slot string Нет glavnoe_prilozhenie_1 Название рекламного места, связанного с событием.

Игнорируется, если задано на уровне товара.
location_id string Нет L_12345 Идентификатор местоположения.

Игнорируется, если задан на уровне товара.
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с событием.

Игнорируется, если задан на уровне товара.
promotion_name string Нет Летняя распродажа Название промоакции, связанной с событием.

Игнорируется, если задано на уровне товара.
items Array<Item> Да* Товары, связанные с событием.

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

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

Имя Тип Обязательно? Пример значения Описание
item_id string Да* SKU_12345

Идентификатор товара.

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

item_name string Да* Футболка с принтом

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

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

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

Параметры affiliation на уровне события и на уровне товара не зависят друг от друга.
coupon string Нет YARKOE_LETO Название или код купона, связанного с товаром.

Параметры coupon на уровне события и на уровне товара не зависят друг от друга.
currency string Нет RUB Код валюты в трехбуквенном формате ISO 4217.

Если это значение задано, то параметр currency на уровне события игнорируется.

Для одного события нельзя указать несколько валют. Для всех товаров должна использоваться одна и та же валюта.
creative_name string Нет leto_banner2 Название используемого объявления.

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

Если это значение задано, то параметр creative_slot на уровне события игнорируется.
Если нет, то параметр creative_slot используется (если он присутствует).
discount number Нет 163 Денежное значение скидки, связанной с товаром.
index number Нет 5 Номер или позиция товара в списке.
item_brand string Нет Google Бренд товара.
item_category string Нет Одежда Категория товара. Если она входит в иерархию категорий, то занимает первую позицию.
item_category2 string Нет Для взрослых Вторая категория или дополнительный разряд товара.
item_category3 string Нет Футболки Третья категория или дополнительный разряд товара.
item_category4 string Нет Партия Четвертая категория или дополнительный разряд товара.
item_category5 string Нет С коротким рукавом Пятая категория или дополнительный разряд товара.
item_list_id string Нет soputstvuyushchie_tovary Идентификатор списка, в котором пользователь увидел товар.

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

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

Если это значение задано, то параметр location_id на уровне события игнорируется.
Если нет, то параметр location_id используется (если он присутствует).
price number Нет 734 Денежная стоимость товара (в указанной валюте).
promotion_id string Нет P_12345 Идентификатор промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_id на уровне события игнорируется.
Если нет, то параметр promotion_id используется (если он присутствует).
promotion_name string Нет Летняя распродажа Название промоакции, связанной с товаром.

Если это значение задано, то параметр promotion_name на уровне события игнорируется.
Если нет, то параметр promotion_name используется (если он присутствует).
quantity number Нет 1

Количество единиц товара.

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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",
        "location_id": "L_12345",
        "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": "L_12345",
            "price": 9.99,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_search_results

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

Параметры

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

Отправка события

Добавьте это событие в сборщике событий для ресурсов "Google Аналитика 4".

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"
      }
    }]
  })
});