События

add_payment_info

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

Параметры

Имя Тип Необходимый Пример значения Описание
currency string Да* доллар США Валюта элементов, связанных с событием, в трехбуквенном формате ISO 4217 .

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

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

* value обычно требуется для содержательной отчетности. Если вы отмечаете событие как конверсию , рекомендуется установить value .
* требуется currency , если вы устанавливаете value .
coupon string Нет ЛЕТНЕЕ ВЕСЕЛЬЕ Название/код купона, связанные с событием.

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

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

Имя Тип Необходимый Пример значения Описание
item_id string Да* Артикул_12345

Идентификатор элемента.

* Требуется один из item_id или item_name .

item_name string Да* Футболка Стэн и друзья

Название предмета.

* Требуется один из item_id или item_name .

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

Параметры affiliation уровня события и элемента являются независимыми.
coupon string Нет ЛЕТНЕЕ ВЕСЕЛЬЕ Название/код купона, связанный с товаром.

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

Если установлено, currency уровня события игнорируется.

Использование нескольких валют для одного события не поддерживается. Для каждого элемента должна быть установлена ​​одна и та же валюта.
discount number Нет 2,22 Денежная скидка, связанная с товаром.
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 Нет сопутствующие товары Идентификатор списка, в котором элемент был представлен пользователю.

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

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

Если установлено, location_id уровня события игнорируется.
Если не задано, используется location_id на уровне события, если он присутствует.
price number Нет 9,99 Денежная цена предмета в единицах указанного параметра валюты.
quantity number Нет 1

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

Если не задано, quantity устанавливается равным 1.

Отправить событие

Попробуйте это событие в Редакторе событий GA4.

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

add_shipping_info

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

Параметры

Имя Тип Необходимый Пример значения Описание
currency string Да* доллар США Валюта элементов, связанных с событием, в трехбуквенном формате ISO 4217 .

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

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

* value обычно требуется для содержательной отчетности. Если вы отмечаете событие как конверсию , рекомендуется установить value .
* требуется currency , если вы устанавливаете value .
coupon string Нет ЛЕТНЕЕ ВЕСЕЛЬЕ Название/код купона, связанные с событием.

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

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

Имя Тип Необходимый Пример значения Описание
item_id string Да* Артикул_12345

Идентификатор элемента.

* Требуется один из item_id или item_name .

item_name string Да* Футболка Стэн и друзья

Название предмета.

* Требуется один из item_id или item_name .

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

Параметры affiliation уровня события и элемента являются независимыми.
coupon string Нет ЛЕТНЕЕ ВЕСЕЛЬЕ Название/код купона, связанный с товаром.

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

Если установлено, currency уровня события игнорируется.

Использование нескольких валют для одного события не поддерживается. Для каждого элемента должна быть установлена ​​одна и та же валюта.
discount number Нет 2,22 Денежная скидка, связанная с товаром.
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 Нет сопутствующие товары Идентификатор списка, в котором элемент был представлен пользователю.

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

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

Если установлено, location_id уровня события игнорируется.
Если не задано, используется location_id на уровне события, если он присутствует.
price number Нет 9,99 Денежная цена предмета в единицах указанного параметра валюты.
quantity number Нет 1

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

Если не задано, quantity устанавливается равным 1.

Отправить событие

Попробуйте это событие в Редакторе событий GA4.

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

добавить в корзину

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

Параметры

Имя Тип Необходимый Пример значения Описание
currency string Да* доллар США Валюта элементов, связанных с событием, в трехбуквенном формате ISO 4217 .

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

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

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

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

Имя Тип Необходимый Пример значения Описание
item_id string Да* Артикул_12345

Идентификатор элемента.

* Требуется один из item_id или item_name .

item_name string Да* Футболка Стэн и друзья

Название предмета.

* Требуется один из item_id или item_name .

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

Параметры affiliation уровня события и элемента являются независимыми.
coupon string Нет ЛЕТНЕЕ ВЕСЕЛЬЕ Название/код купона, связанный с товаром.

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

Если установлено, currency уровня события игнорируется.

Использование нескольких валют для одного события не поддерживается. Для каждого элемента должна быть установлена ​​одна и та же валюта.
discount number Нет 2,22 Денежная скидка, связанная с товаром.
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 Нет сопутствующие товары Идентификатор списка, в котором элемент был представлен пользователю.

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

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

Если установлено, location_id уровня события игнорируется.
Если не задано, используется location_id на уровне события, если он присутствует.
price number Нет 9,99 Денежная цена предмета в единицах указанного параметра валюты.
quantity number Нет 1

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

Если не задано, quantity устанавливается равным 1.

Отправить событие

Попробуйте это событие в Редакторе событий GA4.

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

добавить в список желаний

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

Параметры

Имя Тип Необходимый Пример значения Описание
currency string Да* доллар США Валюта элементов, связанных с событием, в трехбуквенном формате ISO 4217 .

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

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

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

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

Имя Тип Необходимый Пример значения Описание
item_id string Да* Артикул_12345

Идентификатор элемента.

* Требуется один из item_id или item_name .

item_name string Да* Футболка Стэн и друзья

Название предмета.

* Требуется один из item_id или item_name .

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

Параметры affiliation уровня события и элемента являются независимыми.
coupon string Нет ЛЕТНЕЕ ВЕСЕЛЬЕ Название/код купона, связанный с товаром.

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

Если установлено, currency уровня события игнорируется.

Использование нескольких валют для одного события не поддерживается. Для каждого элемента должна быть установлена ​​одна и та же валюта.
discount number Нет 2,22 Денежная скидка, связанная с товаром.
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 Нет сопутствующие товары Идентификатор списка, в котором элемент был представлен пользователю.

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

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

Если установлено, location_id уровня события игнорируется.
Если не задано, используется location_id на уровне события, если он присутствует.
price number Нет 9,99 Денежная цена предмета в единицах указанного параметра валюты.
quantity number Нет 1

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

Если не задано, quantity устанавливается равным 1.

Отправить событие

Попробуйте это событие в Редакторе событий GA4.

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

begin_checkout

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

Параметры

Имя Тип Необходимый Пример значения Описание
currency string Да* доллар США Валюта элементов, связанных с событием, в трехбуквенном формате ISO 4217 .

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

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

* value обычно требуется для содержательной отчетности. Если вы отмечаете событие как конверсию , рекомендуется установить value .
* требуется currency , если вы устанавливаете value .
coupon string Нет ЛЕТНЕЕ ВЕСЕЛЬЕ Название/код купона, связанные с событием.

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

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

Имя Тип Необходимый Пример значения Описание
item_id string Да* Артикул_12345

Идентификатор элемента.

* Требуется один из item_id или item_name .

item_name string Да* Футболка Стэн и друзья

Название предмета.

* Требуется один из item_id или item_name .

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

Параметры affiliation уровня события и элемента являются независимыми.
coupon string Нет ЛЕТНЕЕ ВЕСЕЛЬЕ Название/код купона, связанный с товаром.

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

Если установлено, currency уровня события игнорируется.

Использование нескольких валют для одного события не поддерживается. Для каждого элемента должна быть установлена ​​одна и та же валюта.
discount number Нет 2,22 Денежная скидка, связанная с товаром.
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 Нет сопутствующие товары Идентификатор списка, в котором элемент был представлен пользователю.

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

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

Если установлено, location_id уровня события игнорируется.
Если не задано, используется location_id на уровне события, если он присутствует.
price number Нет 9,99 Денежная цена предмета в единицах указанного параметра валюты.
quantity number Нет 1

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

Если не задано, quantity устанавливается равным 1.

Отправить событие

Попробуйте это событие в Редакторе событий GA4.

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

Earn_virtual_currency

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

Параметры

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

Отправить событие

Попробуйте это событие в Редакторе событий GA4.

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 Да* доллар США Валюта элементов, связанных с событием, в трехбуквенном формате ISO 4217 .

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

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

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

Отправить событие

Попробуйте это событие в Редакторе событий GA4.

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

вступить в группу

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

Параметры

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

Отправить событие

Попробуйте это событие в Редакторе событий GA4.

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 number Нет 5 Уровень персонажа.
character string Нет Игрок 1 Персонаж, уровень которого повысился.

Отправить событие

Попробуйте это событие в Редакторе событий GA4.

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

авторизоваться

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

Параметры

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

Отправить событие

Попробуйте это событие в Редакторе событий GA4.

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 Да 10000 Оценка для публикации.
level number Нет 5 Уровень для оценки.
character string Нет Игрок 1 Персонаж, набравший очки.

Отправить событие

Попробуйте это событие в Редакторе событий GA4.

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

покупка

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

Параметры

Имя Тип Необходимый Пример значения Описание
currency string Да* доллар США Валюта элементов, связанных с событием, в трехбуквенном формате ISO 4217 .

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

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

Параметр transaction_id помогает избежать дублирования событий для покупки.
value number Да* 12.21 Денежная стоимость мероприятия.

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

Параметры affiliation уровня события и элемента являются независимыми.
coupon string Нет ЛЕТНЕЕ ВЕСЕЛЬЕ Название/код купона, связанные с событием.

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

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

Имя Тип Необходимый Пример значения Описание
item_id string Да* Артикул_12345

Идентификатор элемента.

* Требуется один из item_id или item_name .

item_name string Да* Футболка Стэн и друзья

Название предмета.

* Требуется один из item_id или item_name .

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

Параметры affiliation уровня события и элемента являются независимыми.
coupon string Нет ЛЕТНЕЕ ВЕСЕЛЬЕ Название/код купона, связанный с товаром.

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

Если установлено, currency уровня события игнорируется.

Использование нескольких валют для одного события не поддерживается. Для каждого элемента должна быть установлена ​​одна и та же валюта.
discount number No 2.22 The monetary discount value associated with the item.
index number No 5 The index/position of the item in a list.
item_brand string No Google The brand of the item.
item_category string No Apparel The category of the item. If used as part of a category hierarchy or taxonomy then this will be the first category.
item_category2 string No Adult The second category hierarchy or additional taxonomy for the item.
item_category3 string No Shirts The third category hierarchy or additional taxonomy for the item.
item_category4 string No Crew The fourth category hierarchy or additional taxonomy for the item.
item_category5 string No Short sleeve The fifth category hierarchy or additional taxonomy for the item.
item_list_id string No related_products The ID of the list in which the item was presented to the user.

If set, event-level item_list_id is ignored.
If not set, event-level item_list_id is used, if present.
item_list_name string No Related products The name of the list in which the item was presented to the user.

If set, event-level item_list_name is ignored.
If not set, event-level item_list_name is used, if present.
item_variant string No green The item variant or unique code or description for additional item details/options.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (the Google Place ID for San Francisco) The physical location associated with the item (eg the physical store location). It's recommended to use the Google Place ID that corresponds to the associated item. A custom location ID can also be used.

If set, event-level location_id is ignored.
If not set, event-level location_id is used, if present.
price number No 9.99 The monetary price of the item, in units of the specified currency parameter.
quantity number No 1

Item quantity.

If not set, quantity is set to 1.

Send Event

Try this event in the GA4 Event Builder

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

refund

This event signifies when one or more items is refunded to a user.

Parameters

Name Type Required Example value Описание
currency string Yes* USD Currency of the items associated with the event, in 3-letter ISO 4217 format.

If set, item-level currency is ignored.
If not set, currency from the first item in items is used.

* If you set value then currency is required for revenue metrics to be computed accurately.
transaction_id string Yes T_12345 The unique identifier of a transaction.
value number Yes* 7.77 The monetary value of the event.

* value is typically required for meaningful reporting. If you mark the event as a conversion then it's recommended you set value .
* currency is required if you set value .
affiliation string No Google Store A product affiliation to designate a supplying company or brick and mortar store location.

Event-level and item-level affiliation parameters are independent.
coupon string No SUMMER_FUN The coupon name/code associated with the event.

Event-level and item-level coupon parameters are independent.
shipping number No 3.33 Shipping cost associated with a transaction.
tax number No 1.11 Tax cost associated with a transaction.
items Array<Item> No* The items for the event.

Item parameters

Name Type Required Example value Описание
item_id string Yes* SKU_12345

The ID of the item.

*One of item_id or item_name is required.

item_name string Yes* Stan and Friends Tee

The name of the item.

*One of item_id or item_name is required.

affiliation string No Google Store A product affiliation to designate a supplying company or brick and mortar store location.

Event-level and item-level affiliation parameters are independent.
coupon string No SUMMER_FUN The coupon name/code associated with the item.

Event-level and item-level coupon parameters are independent.
currency string No USD The currency, in 3-letter ISO 4217 format.

If set, event-level currency is ignored.

Multiple currencies per event is not supported. Each item should set the same currency.
discount number No 2.22 The monetary discount value associated with the item.
index number No 5 The index/position of the item in a list.
item_brand string No Google The brand of the item.
item_category string No Apparel The category of the item. If used as part of a category hierarchy or taxonomy then this will be the first category.
item_category2 string No Adult The second category hierarchy or additional taxonomy for the item.
item_category3 string No Shirts The third category hierarchy or additional taxonomy for the item.
item_category4 string No Crew The fourth category hierarchy or additional taxonomy for the item.
item_category5 string No Short sleeve The fifth category hierarchy or additional taxonomy for the item.
item_list_id string No related_products The ID of the list in which the item was presented to the user.

If set, event-level item_list_id is ignored.
If not set, event-level item_list_id is used, if present.
item_list_name string No Related products The name of the list in which the item was presented to the user.

If set, event-level item_list_name is ignored.
If not set, event-level item_list_name is used, if present.
item_variant string No green The item variant or unique code or description for additional item details/options.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (the Google Place ID for San Francisco) The physical location associated with the item (eg the physical store location). It's recommended to use the Google Place ID that corresponds to the associated item. A custom location ID can also be used.

If set, event-level location_id is ignored.
If not set, event-level location_id is used, if present.
price number No 9.99 The monetary price of the item, in units of the specified currency parameter.
quantity number No 1

Item quantity.

If not set, quantity is set to 1.

Send Event

Try this event in the GA4 Event Builder

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

remove_from_cart

This event signifies that an item was removed from a cart.

Parameters

Name Type Required Example value Описание
currency string Yes* USD Currency of the items associated with the event, in 3-letter ISO 4217 format.

If set, item-level currency is ignored.
If not set, currency from the first item in items is used.

* If you set value then currency is required for revenue metrics to be computed accurately.
value number Yes* 7.77 The monetary value of the event.

* value is typically required for meaningful reporting. If you mark the event as a conversion then it's recommended you set value .
* currency is required if you set value .
items Array<Item> Yes The items for the event.

Item parameters

Name Type Required Example value Описание
item_id string Yes* SKU_12345

The ID of the item.

*One of item_id or item_name is required.

item_name string Yes* Stan and Friends Tee

The name of the item.

*One of item_id or item_name is required.

affiliation string No Google Store A product affiliation to designate a supplying company or brick and mortar store location.

Event-level and item-level affiliation parameters are independent.
coupon string No SUMMER_FUN The coupon name/code associated with the item.

Event-level and item-level coupon parameters are independent.
currency string No USD The currency, in 3-letter ISO 4217 format.

If set, event-level currency is ignored.

Multiple currencies per event is not supported. Each item should set the same currency.
discount number No 2.22 The monetary discount value associated with the item.
index number No 5 The index/position of the item in a list.
item_brand string No Google The brand of the item.
item_category string No Apparel The category of the item. If used as part of a category hierarchy or taxonomy then this will be the first category.
item_category2 string No Adult The second category hierarchy or additional taxonomy for the item.
item_category3 string No Shirts The third category hierarchy or additional taxonomy for the item.
item_category4 string No Crew The fourth category hierarchy or additional taxonomy for the item.
item_category5 string No Short sleeve The fifth category hierarchy or additional taxonomy for the item.
item_list_id string No related_products The ID of the list in which the item was presented to the user.

If set, event-level item_list_id is ignored.
If not set, event-level item_list_id is used, if present.
item_list_name string No Related products The name of the list in which the item was presented to the user.

If set, event-level item_list_name is ignored.
If not set, event-level item_list_name is used, if present.
item_variant string No green The item variant or unique code or description for additional item details/options.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (the Google Place ID for San Francisco) The physical location associated with the item (eg the physical store location). It's recommended to use the Google Place ID that corresponds to the associated item. A custom location ID can also be used.

If set, event-level location_id is ignored.
If not set, event-level location_id is used, if present.
price number No 9.99 The monetary price of the item, in units of the specified currency parameter.
quantity number No 1

Item quantity.

If not set, quantity is set to 1.

Send Event

Try this event in the GA4 Event Builder

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

Use this event to contextualize search operations. This event can help you identify the most popular content in your app.

Parameters

Name Type Required Example value Описание
search_term string Yes t-shirts The term that was searched for.

Send Event

Try this event in the GA4 Event Builder

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

This event signifies that a user has selected some content of a certain type. This event can help you identify popular content and categories of content in your app.

Parameters

Name Type Required Example value Описание
content_type string No product The type of selected content.
item_id string No I_12345 An identifier for the item that was selected.

Send Event

Try this event in the GA4 Event Builder

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

This event signifies an item was selected from a list.

Parameters

Name Type Required Example value Описание
item_list_id string No related_products The ID of the list in which the item was presented to the user.

Ignored if set at the item-level.
item_list_name string No Related products The name of the list in which the item was presented to the user.

Ignored if set at the item-level.
items Array<Item> Yes* The items for the event.

* The items array is expected to have a single element, representing the selected item. If multiple elements are provided, only the first element in items will be used.

Item parameters

Name Type Required Example value Описание
item_id string Yes* SKU_12345

The ID of the item.

*One of item_id or item_name is required.

item_name string Yes* Stan and Friends Tee

The name of the item.

*One of item_id or item_name is required.

affiliation string No Google Store A product affiliation to designate a supplying company or brick and mortar store location.

Event-level and item-level affiliation parameters are independent.
coupon string No SUMMER_FUN The coupon name/code associated with the item.

Event-level and item-level coupon parameters are independent.
currency string No USD The currency, in 3-letter ISO 4217 format.

If set, event-level currency is ignored.

Multiple currencies per event is not supported. Each item should set the same currency.
discount number No 2.22 The monetary discount value associated with the item.
index number No 5 The index/position of the item in a list.
item_brand string No Google The brand of the item.
item_category string No Apparel The category of the item. If used as part of a category hierarchy or taxonomy then this will be the first category.
item_category2 string No Adult The second category hierarchy or additional taxonomy for the item.
item_category3 string No Shirts The third category hierarchy or additional taxonomy for the item.
item_category4 string No Crew The fourth category hierarchy or additional taxonomy for the item.
item_category5 string No Short sleeve The fifth category hierarchy or additional taxonomy for the item.
item_list_id string No related_products The ID of the list in which the item was presented to the user.

If set, event-level item_list_id is ignored.
If not set, event-level item_list_id is used, if present.
item_list_name string No Related products The name of the list in which the item was presented to the user.

If set, event-level item_list_name is ignored.
If not set, event-level item_list_name is used, if present.
item_variant string No green The item variant or unique code or description for additional item details/options.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (the Google Place ID for San Francisco) The physical location associated with the item (eg the physical store location). It's recommended to use the Google Place ID that corresponds to the associated item. A custom location ID can also be used.

If set, event-level location_id is ignored.
If not set, event-level location_id is used, if present.
price number No 9.99 The monetary price of the item, in units of the specified currency parameter.
quantity number No 1

Item quantity.

If not set, quantity is set to 1.

Send Event

Try this event in the GA4 Event Builder

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_item",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

select_promotion

This event signifies an promotion was selected from a list.

Parameters

Name Type Required Example value Описание
creative_name string No summer_banner2 The name of the promotional creative.

Ignored if set at the item-level.
creative_slot string No featured_app_1 The name of the promotional creative slot associated with the event.

Ignored if set at the item-level.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (the Google Place ID for San Francisco) The ID of the location.

Ignored if set at the item-level.
promotion_id string No P_12345 The ID of the promotion associated with the event.

Ignored if set at the item-level.
promotion_name string No Summer Sale The name of the promotion associated with the event.

Ignored if set at the item-level.
items Array<Item> No The items for the event.

Item parameters

Name Type Required Example value Описание
item_id string Yes* SKU_12345

The ID of the item.

*One of item_id or item_name is required.

item_name string Yes* Stan and Friends Tee

The name of the item.

*One of item_id or item_name is required.

affiliation string No Google Store A product affiliation to designate a supplying company or brick and mortar store location.

Event-level and item-level affiliation parameters are independent.
coupon string No SUMMER_FUN The coupon name/code associated with the item.

Event-level and item-level coupon parameters are independent.
currency string No USD The currency, in 3-letter ISO 4217 format.

If set, event-level currency is ignored.

Multiple currencies per event is not supported. Each item should set the same currency.
creative_name string No summer_banner2 The name of the promotional creative.

If set, event-level creative_name is ignored.
If not set, event-level creative_name is used, if present.
creative_slot string No featured_app_1 The name of the promotional creative slot associated with the item.

If set, event-level creative_slot is ignored.
If not set, event-level creative_slot is used, if present.
discount number No 2.22 The monetary discount value associated with the item.
index number No 5 The index/position of the item in a list.
item_brand string No Google The brand of the item.
item_category string No Apparel The category of the item. If used as part of a category hierarchy or taxonomy then this will be the first category.
item_category2 string No Adult The second category hierarchy or additional taxonomy for the item.
item_category3 string No Shirts The third category hierarchy or additional taxonomy for the item.
item_category4 string No Crew The fourth category hierarchy or additional taxonomy for the item.
item_category5 string No Short sleeve The fifth category hierarchy or additional taxonomy for the item.
item_list_id string No related_products The ID of the list in which the item was presented to the user.

If set, event-level item_list_id is ignored.
If not set, event-level item_list_id is used, if present.
item_list_name string No Related products The name of the list in which the item was presented to the user.

If set, event-level item_list_name is ignored.
If not set, event-level item_list_name is used, if present.
item_variant string No green The item variant or unique code or description for additional item details/options.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (the Google Place ID for San Francisco) The physical location associated with the item (eg the physical store location). It's recommended to use the Google Place ID that corresponds to the associated item. A custom location ID can also be used.

If set, event-level location_id is ignored.
If not set, event-level location_id is used, if present.
price number No 9.99 The monetary price of the item, in units of the specified currency parameter.
promotion_id string No P_12345 The ID of the promotion associated with the item.

If set, event-level promotion_id is ignored.
If not set, event-level promotion_id is used, if present.
promotion_name string No Summer Sale The name of the promotion associated with the item.

If set, event-level promotion_name is ignored.
If not set, event-level promotion_name is used, if present.
quantity number No 1

Item quantity.

If not set, quantity is set to 1.

Send Event

Try this event in the GA4 Event Builder

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

share

Use this event when a user has shared content.

Parameters

Name Type Required Example value Описание
method string No Twitter The method in which the content is shared.
content_type string No image The type of shared content.
item_id string No C_12345 The ID of the shared content.

Send Event

Try this event in the GA4 Event Builder

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

This event indicates that a user has signed up for an account. Use this event to understand the different behaviors of logged in and logged out users.

Parameters

Name Type Required Example value Описание
method string No Google The method used for sign up.

Send Event

Try this event in the GA4 Event Builder

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

This event measures the sale of virtual goods in your app and helps you identify which virtual goods are the most popular.

Parameters

Name Type Required Example value Описание
value number Yes 5 The value of the virtual currency.
virtual_currency_name string Yes Gems The name of the virtual currency.
item_name string No Starter Boost The name of the item the virtual currency is being used for.

Send Event

Try this event in the GA4 Event Builder

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

This event signifies the start of the on-boarding process. Use this in a funnel with tutorial_complete to understand how many users complete the tutorial.

Parameters

No parameters are suggested for this event.

There are no parameters for this event.

Send Event

Try this event in the GA4 Event Builder

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

This event signifies the user's completion of your on-boarding process. Use this in a funnel with tutorial_begin to understand how many users complete the tutorial.

Parameters

No parameters are suggested for this event.

Send Event

Try this event in the GA4 Event Builder

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

Log this event when the user has unlocked an achievement. This event can help you understand how users are experiencing your game.

Parameters

Name Type Required Example value Описание
achievement_id string Yes A_12345 The id of the achievement that was unlocked.

Send Event

Try this event in the GA4 Event Builder

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

This event signifies that a user viewed their cart.

Parameters

Name Type Required Example value Описание
currency string Yes* USD Currency of the items associated with the event, in 3-letter ISO 4217 format.

If set, item-level currency is ignored.
If not set, currency from the first item in items is used.

* If you set value then currency is required for revenue metrics to be computed accurately.
value number Yes* 7.77 The monetary value of the event.

* value is typically required for meaningful reporting. If you mark the event as a conversion then it's recommended you set value .
* currency is required if you set value .
items Array<Item> Yes The items for the event.

Item parameters

Name Type Required Example value Описание
item_id string Yes* SKU_12345

The ID of the item.

*One of item_id or item_name is required.

item_name string Yes* Stan and Friends Tee

The name of the item.

*One of item_id or item_name is required.

affiliation string No Google Store A product affiliation to designate a supplying company or brick and mortar store location.

Event-level and item-level affiliation parameters are independent.
coupon string No SUMMER_FUN The coupon name/code associated with the item.

Event-level and item-level coupon parameters are independent.
currency string No USD The currency, in 3-letter ISO 4217 format.

If set, event-level currency is ignored.

Multiple currencies per event is not supported. Each item should set the same currency.
discount number No 2.22 The monetary discount value associated with the item.
index number No 5 The index/position of the item in a list.
item_brand string No Google The brand of the item.
item_category string No Apparel The category of the item. If used as part of a category hierarchy or taxonomy then this will be the first category.
item_category2 string No Adult The second category hierarchy or additional taxonomy for the item.
item_category3 string No Shirts The third category hierarchy or additional taxonomy for the item.
item_category4 string No Crew The fourth category hierarchy or additional taxonomy for the item.
item_category5 string No Short sleeve The fifth category hierarchy or additional taxonomy for the item.
item_list_id string No related_products The ID of the list in which the item was presented to the user.

If set, event-level item_list_id is ignored.
If not set, event-level item_list_id is used, if present.
item_list_name string No Related products The name of the list in which the item was presented to the user.

If set, event-level item_list_name is ignored.
If not set, event-level item_list_name is used, if present.
item_variant string No green The item variant or unique code or description for additional item details/options.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (the Google Place ID for San Francisco) The physical location associated with the item (eg the physical store location). It's recommended to use the Google Place ID that corresponds to the associated item. A custom location ID can also be used.

If set, event-level location_id is ignored.
If not set, event-level location_id is used, if present.
price number No 9.99 The monetary price of the item, in units of the specified currency parameter.
quantity number No 1

Item quantity.

If not set, quantity is set to 1.

Send Event

Try this event in the GA4 Event Builder

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_item

This event signifies that some content was shown to the user. Use this event to discover the most popular items viewed.

Parameters

Name Type Required Example value Описание
currency string Yes* USD Currency of the items associated with the event, in 3-letter ISO 4217 format.

If set, item-level currency is ignored.
If not set, currency from the first item in items is used.

* If you set value then currency is required for revenue metrics to be computed accurately.
value number Yes* 7.77 The monetary value of the event.

* value is typically required for meaningful reporting. If you mark the event as a conversion then it's recommended you set value .
* currency is required if you set value .
items Array<Item> Yes The items for the event.

Item parameters

Name Type Required Example value Описание
item_id string Yes* SKU_12345

The ID of the item.

*One of item_id or item_name is required.

item_name string Yes* Stan and Friends Tee

The name of the item.

*One of item_id or item_name is required.

affiliation string No Google Store A product affiliation to designate a supplying company or brick and mortar store location.

Event-level and item-level affiliation parameters are independent.
coupon string No SUMMER_FUN The coupon name/code associated with the item.

Event-level and item-level coupon parameters are independent.
currency string No USD The currency, in 3-letter ISO 4217 format.

If set, event-level currency is ignored.

Multiple currencies per event is not supported. Each item should set the same currency.
discount number No 2.22 The monetary discount value associated with the item.
index number No 5 The index/position of the item in a list.
item_brand string No Google The brand of the item.
item_category string No Apparel The category of the item. If used as part of a category hierarchy or taxonomy then this will be the first category.
item_category2 string No Adult The second category hierarchy or additional taxonomy for the item.
item_category3 string No Shirts The third category hierarchy or additional taxonomy for the item.
item_category4 string No Crew The fourth category hierarchy or additional taxonomy for the item.
item_category5 string No Short sleeve The fifth category hierarchy or additional taxonomy for the item.
item_list_id string No related_products The ID of the list in which the item was presented to the user.

If set, event-level item_list_id is ignored.
If not set, event-level item_list_id is used, if present.
item_list_name string No Related products The name of the list in which the item was presented to the user.

If set, event-level item_list_name is ignored.
If not set, event-level item_list_name is used, if present.
item_variant string No green The item variant or unique code or description for additional item details/options.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (the Google Place ID for San Francisco) The physical location associated with the item (eg the physical store location). It's recommended to use the Google Place ID that corresponds to the associated item. A custom location ID can also be used.

If set, event-level location_id is ignored.
If not set, event-level location_id is used, if present.
price number No 9.99 The monetary price of the item, in units of the specified currency parameter.
quantity number No 1

Item quantity.

If not set, quantity is set to 1.

Send Event

Try this event in the GA4 Event Builder

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 9.99,
            "quantity": 1
          }
        ],
      }
    }]
  })
});

view_item_list

Log this event when the user has been presented with a list of items of a certain category.

Parameters

Name Type Required Example value Описание
item_list_id string No related_products The ID of the list in which the item was presented to the user.

Ignored if set at the item-level.
item_list_name string No Related products The name of the list in which the item was presented to the user.

Ignored if set at the item-level.
items Array<Item> Yes The items for the event.

Item parameters

Name Type Required Example value Описание
item_id string Yes* SKU_12345

The ID of the item.

*One of item_id or item_name is required.

item_name string Yes* Stan and Friends Tee

The name of the item.

*One of item_id or item_name is required.

affiliation string No Google Store A product affiliation to designate a supplying company or brick and mortar store location.

Event-level and item-level affiliation parameters are independent.
coupon string No SUMMER_FUN The coupon name/code associated with the item.

Event-level and item-level coupon parameters are independent.
currency string No USD The currency, in 3-letter ISO 4217 format.

If set, event-level currency is ignored.

Multiple currencies per event is not supported. Each item should set the same currency.
discount number No 2.22 The monetary discount value associated with the item.
index number No 5 The index/position of the item in a list.
item_brand string No Google The brand of the item.
item_category string No Apparel The category of the item. If used as part of a category hierarchy or taxonomy then this will be the first category.
item_category2 string No Adult The second category hierarchy or additional taxonomy for the item.
item_category3 string No Shirts The third category hierarchy or additional taxonomy for the item.
item_category4 string No Crew The fourth category hierarchy or additional taxonomy for the item.
item_category5 string No Short sleeve The fifth category hierarchy or additional taxonomy for the item.
item_list_id string No related_products The ID of the list in which the item was presented to the user.

If set, event-level item_list_id is ignored.
If not set, event-level item_list_id is used, if present.
item_list_name string No Related products The name of the list in which the item was presented to the user.

If set, event-level item_list_name is ignored.
If not set, event-level item_list_name is used, if present.
item_variant string No green The item variant or unique code or description for additional item details/options.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (the Google Place ID for San Francisco) The physical location associated with the item (eg the physical store location). It's recommended to use the Google Place ID that corresponds to the associated item. A custom location ID can also be used.

If set, event-level location_id is ignored.
If not set, event-level location_id is used, if present.
price number No 9.99 The monetary price of the item, in units of the specified currency parameter.
quantity number No 1

Item quantity.

If not set, quantity is set to 1.

Send Event

Try this event in the GA4 Event Builder

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item_list",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_promotion

This event signifies an promotion was viewed from a list.

Parameters

Name Type Required Example value Описание
creative_name string No summer_banner2 The name of the promotional creative.

Ignored if set at the item-level.
creative_slot string No featured_app_1 The name of the promotional creative slot associated with the event.

Ignored if set at the item-level.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo The ID of the location.

Ignored if set at the item-level.
promotion_id string No P_12345 The ID of the promotion associated with the event.

Ignored if set at the item-level.
promotion_name string No Summer Sale The name of the promotion associated with the event.

Ignored if set at the item-level.
items Array<Item> Yes* The items for the event.

* The items array is expected to have a single element, representing the item associated with the promotion. If multiple elements are provided, only the first element in items will be used.

Item parameters

Name Type Required Example value Описание
item_id string Yes* SKU_12345

The ID of the item.

*One of item_id or item_name is required.

item_name string Yes* Stan and Friends Tee

The name of the item.

*One of item_id or item_name is required.

affiliation string No Google Store A product affiliation to designate a supplying company or brick and mortar store location.

Event-level and item-level affiliation parameters are independent.
coupon string No SUMMER_FUN The coupon name/code associated with the item.

Event-level and item-level coupon parameters are independent.
currency string No USD The currency, in 3-letter ISO 4217 format.

If set, event-level currency is ignored.

Multiple currencies per event is not supported. Each item should set the same currency.
creative_name string No summer_banner2 The name of the promotional creative.

If set, event-level creative_name is ignored.
If not set, event-level creative_name is used, if present.
creative_slot string No featured_app_1 The name of the promotional creative slot associated with the item.

If set, event-level creative_slot is ignored.
If not set, event-level creative_slot is used, if present.
discount number No 2.22 The monetary discount value associated with the item.
index number No 5 The index/position of the item in a list.
item_brand string No Google The brand of the item.
item_category string No Apparel The category of the item. If used as part of a category hierarchy or taxonomy then this will be the first category.
item_category2 string No Adult The second category hierarchy or additional taxonomy for the item.
item_category3 string No Shirts The third category hierarchy or additional taxonomy for the item.
item_category4 string No Crew The fourth category hierarchy or additional taxonomy for the item.
item_category5 string No Short sleeve The fifth category hierarchy or additional taxonomy for the item.
item_list_id string No related_products The ID of the list in which the item was presented to the user.

If set, event-level item_list_id is ignored.
If not set, event-level item_list_id is used, if present.
item_list_name string No Related products The name of the list in which the item was presented to the user.

If set, event-level item_list_name is ignored.
If not set, event-level item_list_name is used, if present.
item_variant string No green The item variant or unique code or description for additional item details/options.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (the Google Place ID for San Francisco) The physical location associated with the item (eg the physical store location). It's recommended to use the Google Place ID that corresponds to the associated item. A custom location ID can also be used.

If set, event-level location_id is ignored.
If not set, event-level location_id is used, if present.
price number No 9.99 The monetary price of the item, in units of the specified currency parameter.
promotion_id string No P_12345 The ID of the promotion associated with the item.

If set, event-level promotion_id is ignored.
If not set, event-level promotion_id is used, if present.
promotion_name string No Summer Sale The name of the promotion associated with the item.

If set, event-level promotion_name is ignored.
If not set, event-level promotion_name is used, if present.
quantity number No 1

Item quantity.

If not set, quantity is set to 1.

Send Event

Try this event in the GA4 Event Builder

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

view_search_results

Log this event when the user has been presented with the results of a search.

Parameters

Name Type Required Example value Описание
search_term string No Clothing The term used for the search.
items Array<Item> Yes The items for the event.

Send Event

Try this event in the GA4 Event Builder

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