Zalecane zdarzenia Google Analytics

Poniżej przedstawiamy listę zalecanych zdarzeń. Możesz też tworzyć i wysyłać własne zdarzenia niestandardowe.

Ważne: w przypadku zdarzeń wysyłanych do strumieni danych z aplikacji używaj parametru app_instance_id zamiast client_id.

Podczas tworzenia nazw zdarzeń niestandardowych musisz:

1. Postępuj zgodnie z regułami nadawania nazw zdarzeniom.
2. Unikaj zarezerwowanych nazw i prefiksów.
3. Nie przekraczaj limitów zbierania zdarzeń, np. limitu 40 znaków w przypadku nazw zdarzeń i parametrów.

Więcej informacji znajdziesz w artykule Pierwsze kroki.

Jeśli przechodzisz na wyższy pakiet z Measurement Protocol, zapoznaj się z instrukcjami w artykule Przechodzenie na wyższy pakiet z Measurement Protocol.

Wszystkie usługi

ad_impression

To zdarzenie jest dostępne tylko w przypadku strumieni danych z aplikacji.

Używaj tego zdarzenia, gdy użytkownik widzi wyświetlenie reklamy.

• ad_impression wysłane za pomocą platformy Measurement Protocol nie będą uwzględniane w eksportach na inne platformy reklamowe, takie jak Google Ads.
• Wysyłanie zdarzeń ad_impression za pomocą Measurement Protocol może powodować duplikowanie wyświetleń, jeśli masz skonfigurowane tagowanie lub pakiet SDK dla połączonych produktów reklamowych Google. Zdarzenie ad_impression wysyłaj za pomocą Measurement Protocol tylko wtedy, gdy nie zostało ono zarejestrowane przez tagowanie lub pakiet SDK.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Nie	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Nie	3,99 EUR	Wartość wyświetlenia reklamy. * W celu uzyskania przydatnych raportów zwykle wymagany jest parametr conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
ad_platform	string	Nie	MoPub	Platforma reklamowa.
ad_source	string	Nie	AdColony	Źródło reklamy.
ad_format	string	Nie	Baner	Format reklamy.
ad_unit_name	string	Nie	Banner_03	Nazwa jednostki reklamowej.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie ad_impression za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

earn_virtual_currency

Mierzy zdarzenia, kiedy użytkownik otrzymuje wirtualną walutę w grze. Rejestruj to zdarzenie wraz z parametrem spend_virtual_currency, aby lepiej poznać swoje wirtualne finanse.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
conversion_value	number	Nie	5	Wartość waluty wirtualnej.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
virtual_currency_name	string	Nie	Klejnoty	Nazwa waluty wirtualnej.

Przykład

Poniższy przykład pokazuje, jak wysłać zdarzenie earn_virtual_currency za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "earn_virtual_currency",
      "params": {
        "virtual_currency_name": "Gems",
        "value": 5
      }
    }]
  })
});

join_group

Rejestruj to zdarzenie, gdy użytkownik dołącza do grupy, np. do gildii, zespołu lub rodziny. Dzięki temu zdarzeniu dowiesz się, jak popularne są określone grupy lub funkcje społecznościowe.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
group_id	string	Nie	G_12345	Identyfikator grupy.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie join_group za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

login

Wysyłaj to zdarzenie, aby sygnalizować, że użytkownik zalogował się w Twojej witrynie lub aplikacji.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
method	string	Nie	Google	Metoda użyta do logowania.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie login za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

screen_view

To zdarzenie jest dostępne tylko w przypadku strumieni danych z aplikacji.

Użyj tego zdarzenia, aby wskazać, że nastąpiło przejście między ekranami.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
screen_class	string	Nie	MainActivity	Klasa ekranu.
screen_name	string	Nie	Informacje	Nazwa ekranu.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie screen_view za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

search

Rejestruj to zdarzenie, aby wskazać, kiedy użytkownik przeprowadził wyszukiwanie. Możesz używać tego zdarzenia, aby określać, czego użytkownicy szukają w Twojej witrynie lub aplikacji. Możesz np. wysyłać to zdarzenie, gdy użytkownik wyświetli stronę wyników wyszukiwania po przeprowadzeniu wyszukiwania.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
search_term	string	Tak	t-shirty,	Wyszukiwany produkt.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie search za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

select_content

To zdarzenie oznacza, że użytkownik wybrał treści określonego typu. To zdarzenie może pomóc Ci określić popularne treści i kategorie treści w Twojej witrynie lub aplikacji.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
content_type	string	Nie	produkt	Typ wybranej treści.
content_id	string	Nie	C_12345	Identyfikator wybranych treści. Wartość musi zawierać co najmniej 1 znak inny niż cyfra.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie select_content za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_content",
      "params": {
        "content_type": "product",
        "content_id": "C_12345"
      }
    }]
  })
});

share

Używaj tego zdarzenia, gdy użytkownik udostępni treść.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
cart_data.items	Item[]	Nie		Produkty powiązane ze zdarzeniem. Ustaw pole cart_data.items w obiekcie Event.

Pola produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak	I_12345	Unikalny identyfikator produktu. Ustaw pole item_id w obiekcie Item.
unit_price	number	Tak	27,67	Cena jednostkowa bez podatku, dostawy i rabatów na poziomie zdarzenia (transakcji) dla tego produktu. Jeśli produkt ma zniżkę obejmującą tylko ten produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład cena jednostkowa produktu wynosi 27,67, a rabat jednostkowy to 6,66, ustaw wartość unitPrice na 21,01.
quantity	number	Tak	1	Ilość zakupionych sztuk tego produktu.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
method	string	Nie	Twitter	Metoda udostępniania treści.
content_type	string	Nie	obraz	Typ udostępnionych treści.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie share za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "share",
      "params": {
        "method": "Twitter",
        "content_type": "image",
        "item_id": "C_12345"
      }
    }]
  })
});

sign_up

To zdarzenie oznacza, że użytkownik zarejestrował konto. Dzięki temu zdarzeniu możesz poznać różne zachowania zalogowanych i niezalogowanych użytkowników.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
method	string	Nie	Google	Metoda użyta do rejestracji.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie sign_up za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

spend_virtual_currency

To zdarzenie mierzy sprzedaż wirtualnych produktów w aplikacji i pomaga określić, które z nich są najpopularniejsze.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
conversion_value	number	Tak	5	Wartość waluty wirtualnej.
cart_data.items	Item[]	Nie		Produkty powiązane ze zdarzeniem. Ustaw pole cart_data.items w obiekcie Event.

Pola produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak	I_12345	Unikalny identyfikator produktu. Ustaw pole item_id w obiekcie Item.
unit_price	number	Tak	27,67	Cena jednostkowa bez podatku, dostawy i rabatów na poziomie zdarzenia (transakcji) dla tego produktu. Jeśli produkt ma zniżkę obejmującą tylko ten produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład cena jednostkowa produktu wynosi 27,67, a rabat jednostkowy to 6,66, ustaw wartość unitPrice na 21,01.
quantity	number	Tak	1	Ilość zakupionych sztuk tego produktu.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_name	string	Nie	Starter Boost	Nazwa produktu, do którego używana jest waluta wirtualna.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
virtual_currency_name	string	Tak	Klejnoty	Nazwa waluty wirtualnej.

Przykład

Poniższy przykład pokazuje, jak wysłać zdarzenie spend_virtual_currency za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "spend_virtual_currency",
      "params": {
        "value": 5,
        "virtual_currency_name": "Gems",
        "item_name": "Starter Boost"
      }
    }]
  })
});

tutorial_begin

To zdarzenie oznacza rozpoczęcie procesu rejestracji. Użyj tego zdarzenia w ścieżce z tutorial_complete, aby dowiedzieć się, ilu użytkowników ukończyło samouczek.

Parametry

Dla tego zdarzenia nie są sugerowane żadne parametry.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie tutorial_begin za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

tutorial_complete

To zdarzenie oznacza, że użytkownik zakończył proces wprowadzający. Użyj tego parametru w ścieżce z parametrem tutorial_begin, aby dowiedzieć się, ilu użytkowników ukończyło samouczek.

Parametry

Dla tego zdarzenia nie są sugerowane żadne parametry.

Przykład

Poniższy przykład pokazuje, jak wysłać zdarzenie tutorial_complete za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

view_search_results

Rejestruj to zdarzenie, gdy użytkownikowi zostaną wyświetlone wyniki wyszukiwania. Pamiętaj, że możesz włączyć automatyczne zbieranie zdarzenia view_search_results za pomocą pomiaru zaawansowanego zdarzeń w Google Analytics.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
search_term	string	Nie	Odzież	Wyszukiwane hasło.

Uwaga: zdarzenie view_search_results wysyła parametr unique_search_term z wartością 1, jeśli wyszukiwane hasło jest unikalne w bieżącej sesji. Jeśli wyszukiwane hasło zostało już przesłane w bieżącej sesji, wartość parametru wynosi 0.

Przykład

Poniższy przykład pokazuje, jak wysłać zdarzenie view_search_results za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

campaign_details

Używaj tego zdarzenia do wysyłania szczegółów kampanii, które zostaną zastosowane do zdarzeń z sygnaturą czasową większą lub równą sygnaturze czasowej zdarzenia campaign_details.

Uwaga: zdarzenie campaign_details nie będzie widoczne w raportach Google Analytics ani w widoku debugowania. Jeśli masz włączoną funkcję BigQuery Export, to zdarzenie będzie obecne w eksportowanych danych zdarzeń BigQuery.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
campaign_id	string	Nie	google_1234	Identyfikator kampanii.
campaign	string	Nie	Summer_fun	Nazwa służąca do identyfikowania określonej promocji lub kampanii strategicznej.
source	string	Nie	google	Źródło wizyt w kampanii (np. google, e-mail itp.).
medium	string	Nie	cpc	Medium kampanii (np.e-mail, koszt kliknięcia itp.).
term	string	Nie	summer+travel	Termin kampanii używany w płatnym wyszukiwaniu do podawania słów kluczowych w reklamach.
content	string	Nie	logolink	Treść kampanii używana do testowania wersji A/B i reklam kierowanych na sieć reklamową w celu rozróżniania reklam lub linków prowadzących pod ten sam adres URL.

Przykład

Poniższy przykład pokazuje, jak wysłać zdarzenie campaign_details za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "campaign_details",
      "params": {
        "campaign_id": "google_1234",
        "campaign": "Summer_fun",
        "source": "google",
        "medium": "cpc",
        "term": "summer+travel",
        "content": "logolink"
      }
    }]
  })
});

Sprzedaż online

add_payment_info

To zdarzenie oznacza, że użytkownik przesłał dane do płatności w procesie płatności w e-commerce.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości w zdarzeniu view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw wartość conversion_value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj informacji dotyczących wersji, takich jak shipping czy tax. * W celu uzyskania przydatnych raportów zwykle wymagany jest parametr conversion_value. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.
cart_data.items	Item[]	Tak		Produkty powiązane ze zdarzeniem. Ustaw pole cart_data.items w obiekcie Event.
cart_data.coupon_codes	string[]	Nie	SUMMER_FUN	Kod kuponu powiązany ze zdarzeniem. Ustaw pole coupon_codes w obiekcie CartData. * Na tej liście podaj tylko jeden kod kuponu. * Nie zależy to od kodów kuponów na poziomie produktu.

Pola produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak	I_12345	Unikalny identyfikator produktu. Ustaw pole item_id w obiekcie Item.
unit_price	number	Tak	27,67	Cena jednostkowa bez podatku, dostawy i rabatów na poziomie zdarzenia (transakcji) dla tego produktu. Jeśli produkt ma zniżkę obejmującą tylko ten produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład cena jednostkowa produktu wynosi 27,67, a rabat jednostkowy to 6,66, ustaw wartość unitPrice na 21,01.
quantity	number	Tak	1	Ilość zakupionych sztuk tego produktu.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
payment_type	string	Nie	Karta kredytowa	Wybrana forma płatności.

Przykład

Poniższy przykład pokazuje, jak wysłać zdarzenie add_payment_info za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

add_shipping_info

To zdarzenie oznacza, że użytkownik przesłał informacje o dostawie w procesie płatności w e-commerce.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości w zdarzeniu view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw wartość conversion_value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj informacji dotyczących wersji, takich jak shipping czy tax. * W celu uzyskania przydatnych raportów zwykle wymagany jest parametr conversion_value. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.
cart_data.items	Item[]	Tak		Produkty powiązane ze zdarzeniem. Ustaw pole cart_data.items w obiekcie Event.
cart_data.coupon_codes	string[]	Nie	SUMMER_FUN	Kod kuponu powiązany ze zdarzeniem. Ustaw pole coupon_codes w obiekcie CartData. * Na tej liście podaj tylko jeden kod kuponu. * Nie zależy to od kodów kuponów na poziomie produktu.

Pola produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak	I_12345	Unikalny identyfikator produktu. Ustaw pole item_id w obiekcie Item.
unit_price	number	Tak	27,67	Cena jednostkowa bez podatku, dostawy i rabatów na poziomie zdarzenia (transakcji) dla tego produktu. Jeśli produkt ma zniżkę obejmującą tylko ten produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład cena jednostkowa produktu wynosi 27,67, a rabat jednostkowy to 6,66, ustaw wartość unitPrice na 21,01.
quantity	number	Tak	1	Ilość zakupionych sztuk tego produktu.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
shipping_tier	string	Nie	Ziemia	Poziom dostawy (np. Ground, Air, Next-day) wybrany w przypadku zakupionego produktu.

Przykład

Poniższy przykład pokazuje, jak wysłać zdarzenie add_shipping_info za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

add_to_cart

To zdarzenie oznacza, że produkt został dodany do koszyka w celu zakupu.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości w zdarzeniu view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw wartość conversion_value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj informacji dotyczących wersji, takich jak shipping czy tax. * W celu uzyskania przydatnych raportów zwykle wymagany jest parametr conversion_value. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.
cart_data.items	Item[]	Tak		Produkty powiązane ze zdarzeniem. Ustaw pole cart_data.items w obiekcie Event.

Pola produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak	I_12345	Unikalny identyfikator produktu. Ustaw pole item_id w obiekcie Item.
unit_price	number	Tak	27,67	Cena jednostkowa bez podatku, dostawy i rabatów na poziomie zdarzenia (transakcji) dla tego produktu. Jeśli produkt ma zniżkę obejmującą tylko ten produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład cena jednostkowa produktu wynosi 27,67, a rabat jednostkowy to 6,66, ustaw wartość unitPrice na 21,01.
quantity	number	Tak	1	Ilość zakupionych sztuk tego produktu.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązany z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w ramach hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Fizyczna lokalizacja powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.

Oprócz określonych parametrów możesz w tablicy items umieścić do 27 parametrów niestandardowych.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie add_to_cart za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

add_to_wishlist

Zdarzenie oznacza, że produkt został dodany do listy życzeń. Używaj tego zdarzenia, aby identyfikować popularne prezenty w aplikacji.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości w zdarzeniu view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw wartość conversion_value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj informacji dotyczących wersji, takich jak shipping czy tax. * W celu uzyskania przydatnych raportów zwykle wymagany jest parametr conversion_value. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.
cart_data.items	Item[]	Tak		Produkty powiązane ze zdarzeniem. Ustaw pole cart_data.items w obiekcie Event.

Pola produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak	I_12345	Unikalny identyfikator produktu. Ustaw pole item_id w obiekcie Item.
unit_price	number	Tak	27,67	Cena jednostkowa bez podatku, dostawy i rabatów na poziomie zdarzenia (transakcji) dla tego produktu. Jeśli produkt ma zniżkę obejmującą tylko ten produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład cena jednostkowa produktu wynosi 27,67, a rabat jednostkowy to 6,66, ustaw wartość unitPrice na 21,01.
quantity	number	Tak	1	Ilość zakupionych sztuk tego produktu.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązany z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w ramach hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Fizyczna lokalizacja powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.

Oprócz określonych parametrów możesz w tablicy items umieścić do 27 parametrów niestandardowych.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie add_to_wishlist za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

begin_checkout

To zdarzenie oznacza, że użytkownik rozpoczął proces płatności.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości w zdarzeniu view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw wartość conversion_value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj informacji dotyczących wersji, takich jak shipping czy tax. * W celu uzyskania przydatnych raportów zwykle wymagany jest parametr conversion_value. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.
cart_data.items	Item[]	Tak		Produkty powiązane ze zdarzeniem. Ustaw pole cart_data.items w obiekcie Event.
cart_data.coupon_codes	string[]	Nie	SUMMER_FUN	Kod kuponu powiązany ze zdarzeniem. Ustaw pole coupon_codes w obiekcie CartData. * Na tej liście podaj tylko jeden kod kuponu. * Nie zależy to od kodów kuponów na poziomie produktu.

Pola produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak	I_12345	Unikalny identyfikator produktu. Ustaw pole item_id w obiekcie Item.
unit_price	number	Tak	27,67	Cena jednostkowa bez podatku, dostawy i rabatów na poziomie zdarzenia (transakcji) dla tego produktu. Jeśli produkt ma zniżkę obejmującą tylko ten produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład cena jednostkowa produktu wynosi 27,67, a rabat jednostkowy to 6,66, ustaw wartość unitPrice na 21,01.
quantity	number	Tak	1	Ilość zakupionych sztuk tego produktu.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązany z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w ramach hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Fizyczna lokalizacja powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.

Oprócz określonych parametrów możesz w tablicy items umieścić do 27 parametrów niestandardowych.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie begin_checkout za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

in_app_purchase

To zdarzenie jest dostępne tylko w przypadku strumieni danych z aplikacji.

Używaj tego zdarzenia, gdy użytkownik dokonuje zakupu w aplikacji.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta conversion_value zdarzenia podana w 3-literowym formacie ISO 4217. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * conversion_value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.
cart_data.items	Item[]	Nie		Produkty powiązane ze zdarzeniem. Ustaw pole cart_data.items w obiekcie Event.

Pola produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak	I_12345	Unikalny identyfikator produktu. Ustaw pole item_id w obiekcie Item.
unit_price	number	Tak	27,67	Cena jednostkowa bez podatku, dostawy i rabatów na poziomie zdarzenia (transakcji) dla tego produktu. Jeśli produkt ma zniżkę obejmującą tylko ten produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład cena jednostkowa produktu wynosi 27,67, a rabat jednostkowy to 6,66, ustaw wartość unitPrice na 21,01.
quantity	number	Tak	1	Ilość zakupionych sztuk tego produktu.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
product_id	string	Nie	ABC123456789	Identyfikator produktu.
subscription	boolean	Nie	prawda	Wskazuje, czy zakup jest subskrypcją. Jeśli nie jest ustawiony, przyjmuje się domyślnie false.
free_trial	boolean	Nie	prawda	Wskazuje, czy zdarzenie dotyczy bezpłatnego okresu próbnego subskrypcji. Jeśli nie jest ustawiony, przyjmuje się domyślnie false.
price_is_discounted	boolean	Nie	fałsz	Wskazuje, czy price jest objęty rabatem. Jeśli nie jest ustawiony, przyjmuje się domyślnie false.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie in_app_purchase za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

purchase

To zdarzenie oznacza, że użytkownik kupił co najmniej 1 produkt.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości w zdarzeniu view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw wartość conversion_value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj informacji dotyczących wersji, takich jak shipping czy tax. * W celu uzyskania przydatnych raportów zwykle wymagany jest parametr conversion_value. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.
transaction_id	string	Tak	T_12345	Unikalny identyfikator transakcji. Parametr transaction_id pomaga uniknąć otrzymywania zduplikowanych zdarzeń zakupu. Ustaw pole transaction_id w obiekcie Event.
user_properties.customer_type	CustomerType	Nie	NEW	Czy konwersja pochodzi od klienta NEW czy RETURNING.
cart_data.items	Item[]	Tak		Produkty powiązane ze zdarzeniem. Ustaw pole cart_data.items w obiekcie Event.
cart_data.coupon_codes	string[]	Nie	SUMMER_FUN	Kod kuponu powiązany ze zdarzeniem. Ustaw pole coupon_codes w obiekcie CartData. * Na tej liście podaj tylko jeden kod kuponu. * Nie zależy to od kodów kuponów na poziomie produktu.

Pola produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak	I_12345	Unikalny identyfikator produktu. Ustaw pole item_id w obiekcie Item.
unit_price	number	Tak	27,67	Cena jednostkowa bez podatku, dostawy i rabatów na poziomie zdarzenia (transakcji) dla tego produktu. Jeśli produkt ma zniżkę obejmującą tylko ten produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład cena jednostkowa produktu wynosi 27,67, a rabat jednostkowy to 6,66, ustaw wartość unitPrice na 21,01.
quantity	number	Tak	1	Ilość zakupionych sztuk tego produktu.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
shipping	number	Nie	3,33	Koszt dostawy powiązany z transakcją.
tax	number	Nie	1.11	Koszty podatkowe powiązane z transakcją.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązany z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w ramach hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Fizyczna lokalizacja powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.

Oprócz określonych parametrów możesz w tablicy items umieścić do 27 parametrów niestandardowych.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie purchase za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
    method: "POST",
    body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "purchase",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
            {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

refund

To zdarzenie oznacza, że użytkownikowi zwrócono środki za co najmniej 1 produkt.

Uwaga: zalecamy uwzględnienie informacji o produkcie w zdarzeniu refund, aby w Analytics wyświetlać dane o zwrotach na poziomie produktu.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości w zdarzeniu view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw wartość conversion_value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj informacji dotyczących wersji, takich jak shipping czy tax. * W celu uzyskania przydatnych raportów zwykle wymagany jest parametr conversion_value. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.
transaction_id	string	Tak	T_12345	Unikalny identyfikator transakcji.
cart_data.items	Item[]	Nie		Produkty powiązane ze zdarzeniem. Ustaw pole cart_data.items w obiekcie Event.
cart_data.coupon_codes	string[]	Nie	SUMMER_FUN	Kod kuponu powiązany ze zdarzeniem. Ustaw pole coupon_codes w obiekcie CartData. * Na tej liście podaj tylko jeden kod kuponu. * Nie zależy to od kodów kuponów na poziomie produktu.

Pola produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak	I_12345	Unikalny identyfikator produktu. Ustaw pole item_id w obiekcie Item.
unit_price	number	Tak	27,67	Cena jednostkowa bez podatku, dostawy i rabatów na poziomie zdarzenia (transakcji) dla tego produktu. Jeśli produkt ma zniżkę obejmującą tylko ten produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład cena jednostkowa produktu wynosi 27,67, a rabat jednostkowy to 6,66, ustaw wartość unitPrice na 21,01.
quantity	number	Tak	1	Ilość zakupionych sztuk tego produktu.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
shipping	number	Nie	3,33	Koszt dostawy powiązany z transakcją.
tax	number	Nie	1.11	Koszty podatkowe powiązane z transakcją.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązany z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w ramach hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Fizyczna lokalizacja powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.

Oprócz określonych parametrów możesz w tablicy items umieścić do 27 parametrów niestandardowych.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie refund za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

remove_from_cart

To zdarzenie oznacza, że produkt został usunięty z koszyka.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości w zdarzeniu view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw wartość conversion_value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj informacji dotyczących wersji, takich jak shipping czy tax. * W celu uzyskania przydatnych raportów zwykle wymagany jest parametr conversion_value. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.
cart_data.items	Item[]	Tak		Produkty powiązane ze zdarzeniem. Ustaw pole cart_data.items w obiekcie Event.

Pola produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak	I_12345	Unikalny identyfikator produktu. Ustaw pole item_id w obiekcie Item.
unit_price	number	Tak	27,67	Cena jednostkowa bez podatku, dostawy i rabatów na poziomie zdarzenia (transakcji) dla tego produktu. Jeśli produkt ma zniżkę obejmującą tylko ten produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład cena jednostkowa produktu wynosi 27,67, a rabat jednostkowy to 6,66, ustaw wartość unitPrice na 21,01.
quantity	number	Tak	1	Ilość zakupionych sztuk tego produktu.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązany z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w ramach hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Fizyczna lokalizacja powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.

Oprócz określonych parametrów możesz w tablicy items umieścić do 27 parametrów niestandardowych.

Przykład

Poniższy przykład pokazuje, jak wysłać zdarzenie remove_from_cart za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

select_item

To wydarzenie oznacza, że element został wybrany z listy.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
cart_data.items	Item[]	Tak*		Produkty powiązane ze zdarzeniem. * Oczekuje się, że tablica items będzie zawierać jeden element reprezentujący wybrany produkt. Jeśli podasz kilka elementów, użyty zostanie tylko pierwszy element w items. Ustaw pole cart_data.items w obiekcie Event.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Ignorowany, jeśli jest ustawiony na poziomie produktu.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Ignorowany, jeśli jest ustawiony na poziomie produktu.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązany z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w ramach hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Fizyczna lokalizacja powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.

Oprócz określonych parametrów możesz w tablicy items umieścić do 27 parametrów niestandardowych.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie select_item za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

select_promotion

To wydarzenie oznacza, że promocja została wybrana z listy.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
cart_data.items	Item[]	Nie		Produkty powiązane ze zdarzeniem. Ustaw pole cart_data.items w obiekcie Event.

Pola produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak	I_12345	Unikalny identyfikator produktu. Ustaw pole item_id w obiekcie Item.
unit_price	number	Tak	27,67	Cena jednostkowa bez podatku, dostawy i rabatów na poziomie zdarzenia (transakcji) dla tego produktu. Jeśli produkt ma zniżkę obejmującą tylko ten produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład cena jednostkowa produktu wynosi 27,67, a rabat jednostkowy to 6,66, ustaw wartość unitPrice na 21,01.
quantity	number	Tak	1	Ilość zakupionych sztuk tego produktu.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
creative_name	string	Nie	summer_banner2	Nazwa kreacji promocyjnej.
creative_slot	string	Nie	featured_app_1	Nazwa boksu kreacji promocyjnej powiązanego ze zdarzeniem.
promotion_id	string	Nie	P_12345	Identyfikator promocji powiązanej ze zdarzeniem.
promotion_name	string	Nie	Letnia wyprzedaż	Nazwa promocji powiązanej ze zdarzeniem.

Aby w raportach Google Analytics wypełniać wymiary promocji ograniczone do produktu, takie jak „Identyfikator promocji produktu” lub „Nazwa promocji produktu”, usługa Google Analytics najpierw wyszukuje odpowiednie parametry promocji (promotion_id, promotion_name, creative_name i creative_slot) w każdym konkretnym obiekcie w tablicy items zdarzeń e-commerce. Jeśli w obiekcie elementu nie znajdzie się parametr, Google Analytics użyje wartości z parametru na poziomie zdarzenia, jeśli taki parametr jest podany. Wymiar promocji ograniczony do produktu w przypadku konkretnego produktu będzie raportowany jako „(not set)” tylko wtedy, gdy odpowiedni parametr nie będzie występować *ani* w obiekcie produktu, *ani* w parametrach na poziomie zdarzenia. Parametry na poziomie produktu mają zawsze pierwszeństwo przed parametrami na poziomie zdarzenia.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązany z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
creative_name	string	Nie	summer_banner2	Nazwa kreacji promocyjnej. Jeśli nie zostanie ustawiony, domyślnie przyjmuje wartość creative_name na poziomie wydarzenia.
creative_slot	string	Nie	featured_app_1	Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli nie zostanie ustawiony, domyślnie przyjmuje wartość creative_slot na poziomie wydarzenia.
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w ramach hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Fizyczna lokalizacja powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.
promotion_id	string	Nie	P_12345	Identyfikator promocji powiązanej z produktem. Jeśli nie zostanie ustawiony, domyślnie przyjmuje wartość promotion_id na poziomie wydarzenia.
promotion_name	string	Nie	Letnia wyprzedaż	Nazwa promocji powiązanej z produktem. Jeśli nie zostanie ustawiony, domyślnie przyjmuje wartość promotion_name na poziomie wydarzenia.

Oprócz określonych parametrów możesz w tablicy items umieścić do 27 parametrów niestandardowych.

Przykład

Poniższy przykład pokazuje, jak wysłać zdarzenie select_promotion za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_cart

To zdarzenie oznacza, że użytkownik wyświetlił zawartość koszyka.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości w zdarzeniu view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw wartość conversion_value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj informacji dotyczących wersji, takich jak shipping czy tax. * W celu uzyskania przydatnych raportów zwykle wymagany jest parametr conversion_value. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.
cart_data.items	Item[]	Tak		Produkty powiązane ze zdarzeniem. Ustaw pole cart_data.items w obiekcie Event.

Pola produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak	I_12345	Unikalny identyfikator produktu. Ustaw pole item_id w obiekcie Item.
unit_price	number	Tak	27,67	Cena jednostkowa bez podatku, dostawy i rabatów na poziomie zdarzenia (transakcji) dla tego produktu. Jeśli produkt ma zniżkę obejmującą tylko ten produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład cena jednostkowa produktu wynosi 27,67, a rabat jednostkowy to 6,66, ustaw wartość unitPrice na 21,01.
quantity	number	Tak	1	Ilość zakupionych sztuk tego produktu.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązany z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w ramach hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Fizyczna lokalizacja powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.

Oprócz określonych parametrów możesz w tablicy items umieścić do 27 parametrów niestandardowych.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie view_cart za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

view_item

To zdarzenie oznacza, że użytkownikowi wyświetlono pewne treści. Użyj tego zdarzenia, aby odkryć najpopularniejsze wyświetlane produkty.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości w zdarzeniu view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw wartość conversion_value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj informacji dotyczących wersji, takich jak shipping czy tax. * W celu uzyskania przydatnych raportów zwykle wymagany jest parametr conversion_value. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.
cart_data.items	Item[]	Tak		Produkty powiązane ze zdarzeniem. Ustaw pole cart_data.items w obiekcie Event.

Pola produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak	I_12345	Unikalny identyfikator produktu. Ustaw pole item_id w obiekcie Item.
unit_price	number	Tak	27,67	Cena jednostkowa bez podatku, dostawy i rabatów na poziomie zdarzenia (transakcji) dla tego produktu. Jeśli produkt ma zniżkę obejmującą tylko ten produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład cena jednostkowa produktu wynosi 27,67, a rabat jednostkowy to 6,66, ustaw wartość unitPrice na 21,01.
quantity	number	Tak	1	Ilość zakupionych sztuk tego produktu.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązany z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w ramach hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Fizyczna lokalizacja powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.

Oprócz określonych parametrów możesz w tablicy items umieścić do 27 parametrów niestandardowych.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie view_item za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

view_item_list

Rejestruj to zdarzenie, gdy użytkownikowi zostanie wyświetlona lista produktów z określonej kategorii.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości w zdarzeniu view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
cart_data.items	Item[]	Tak		Produkty powiązane ze zdarzeniem. Ustaw pole cart_data.items w obiekcie Event.

Pola produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak	I_12345	Unikalny identyfikator produktu. Ustaw pole item_id w obiekcie Item.
unit_price	number	Tak	27,67	Cena jednostkowa bez podatku, dostawy i rabatów na poziomie zdarzenia (transakcji) dla tego produktu. Jeśli produkt ma zniżkę obejmującą tylko ten produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład cena jednostkowa produktu wynosi 27,67, a rabat jednostkowy to 6,66, ustaw wartość unitPrice na 21,01.
quantity	number	Tak	1	Ilość zakupionych sztuk tego produktu.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązany z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w ramach hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Fizyczna lokalizacja powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.

Oprócz określonych parametrów możesz w tablicy items umieścić do 27 parametrów niestandardowych.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie view_item_list za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

view_promotion

To wydarzenie oznacza, że promocja została wyświetlona na liście.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
cart_data.items	Item[]	Tak*		Produkty powiązane ze zdarzeniem. * Tablica items powinna zawierać tylko 1 element, który reprezentuje produkt powiązany z promocją. Jeśli podasz kilka elementów, użyty zostanie tylko pierwszy element w items. Ustaw pole cart_data.items w obiekcie Event.

Pola produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak	I_12345	Unikalny identyfikator produktu. Ustaw pole item_id w obiekcie Item.
unit_price	number	Tak	27,67	Cena jednostkowa bez podatku, dostawy i rabatów na poziomie zdarzenia (transakcji) dla tego produktu. Jeśli produkt ma zniżkę obejmującą tylko ten produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład cena jednostkowa produktu wynosi 27,67, a rabat jednostkowy to 6,66, ustaw wartość unitPrice na 21,01.
quantity	number	Tak	1	Ilość zakupionych sztuk tego produktu.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
creative_name	string	Nie	summer_banner2	Nazwa kreacji promocyjnej.
creative_slot	string	Nie	featured_app_1	Nazwa boksu kreacji promocyjnej powiązanego ze zdarzeniem.
promotion_id	string	Nie	P_12345	Identyfikator promocji powiązanej ze zdarzeniem.
promotion_name	string	Nie	Letnia wyprzedaż	Nazwa promocji powiązanej ze zdarzeniem.

Aby wypełnić w raportach Google Analytics wymiary promocji ograniczone do produktu, takie jak „Identyfikator promocji produktu” lub „Nazwa promocji produktu”, usługa Google Analytics najpierw wyszukuje odpowiednie parametry promocji (promotion_id, promotion_name, creative_name i creative_slot) w każdym konkretnym obiekcie w tablicy items zdarzeń e-commerce. Jeśli w obiekcie elementu nie znajdzie się parametr, Google Analytics użyje wartości z parametru na poziomie zdarzenia, jeśli taki parametr jest podany. Wymiary promocji ograniczone do produktu w przypadku konkretnego produktu będą raportowane jako „(not set)” tylko wtedy, gdy odpowiedni parametr nie występuje *ani* w obiekcie produktu, *ani* w parametrach na poziomie zdarzenia. Parametry na poziomie produktu mają zawsze pierwszeństwo przed parametrami na poziomie zdarzenia.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązany z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
creative_name	string	Nie	summer_banner2	Nazwa kreacji promocyjnej. Jeśli nie zostanie ustawiony, domyślnie przyjmuje wartość creative_name na poziomie wydarzenia.
creative_slot	string	Nie	featured_app_1	Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli nie zostanie ustawiony, domyślnie przyjmuje wartość creative_slot na poziomie wydarzenia.
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w ramach hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Fizyczna lokalizacja powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.
promotion_id	string	Nie	P_12345	Identyfikator promocji powiązanej z produktem. Jeśli nie zostanie ustawiony, domyślnie przyjmuje wartość promotion_id na poziomie wydarzenia.
promotion_name	string	Nie	Letnia wyprzedaż	Nazwa promocji powiązanej z produktem. Jeśli nie zostanie ustawiony, domyślnie przyjmuje wartość promotion_name na poziomie wydarzenia.

Oprócz określonych parametrów możesz w tablicy items umieścić do 27 parametrów niestandardowych.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie view_promotion za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

Gry

level_up

To zdarzenie oznacza, że gracz przeszedł w grze na wyższy poziom. Możesz go używać do oceny rozkładu poziomów wśród użytkowników i identyfikowania poziomów, które są trudne do ukończenia.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
level	number	Nie	5	Poziom postaci.
character	string	Nie	Gracz 1	Postać, która awansowała.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie level_up za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "level_up",
      "params": {
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

post_score

Wysyłaj to zdarzenie, gdy użytkownik opublikuje wynik. Dzięki temu zdarzeniu możesz dowiedzieć się, jak użytkownicy radzą sobie w Twojej grze, i powiązać wysokie wyniki z odbiorcami lub zachowaniami.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
score	number	Tak	10000	Wynik do opublikowania.
level	number	Nie	5	Poziom wyniku.
character	string	Nie	Gracz 1	Postać, która osiągnęła wynik.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie post_score za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "post_score",
      "params": {
        "score": 10000,
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

unlock_achievement

Rejestruj to zdarzenie, gdy użytkownik odblokuje osiągnięcie. To zdarzenie może pomóc Ci zrozumieć, jak użytkownicy odbierają Twoją grę.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
achievement_id	string	Tak	A_12345	Identyfikator odblokowanego osiągnięcia.

Przykład

Poniższy przykład pokazuje, jak wysłać zdarzenie unlock_achievement za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

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

Zwiększanie liczby potencjalnych klientów

close_convert_lead

Rejestruj to zdarzenie, gdy zakwalifikowany potencjalny klient zostanie przekształcony w klienta. Zwykle oznacza to koniec procesu pozyskiwania potencjalnych klientów, np. podpisanie umowy, rozpoczęcie płatnej subskrypcji lub sfinalizowanie sprzedaży.

• Uwaga: aby śledzić początkowe zdobywanie potencjalnych klientów, np. przesyłanie formularzy, rejestrację w newsletterze lub prośby o wersję demonstracyjną, użyj zdarzenia generate_lead.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta conversion_value zdarzenia podana w 3-literowym formacie ISO 4217. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * conversion_value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.

Przykład

Poniższy przykład pokazuje, jak wysłać zdarzenie close_convert_lead za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_convert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

close_unconvert_lead

Mierzy zdarzenia, kiedy użytkownik jest oznaczany jako osoba, która nie stała się potencjalnym klientem po konwersji, wraz z podaniem przyczyny.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta conversion_value zdarzenia podana w 3-literowym formacie ISO 4217. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * conversion_value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
unconvert_lead_reason	string	Nie	Nigdy nie odpowiedział	Przyczyna, dla której potencjalny klient nie dokonał konwersji.

Przykład

Poniższy przykład pokazuje, jak wysłać zdarzenie close_unconvert_lead za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded"
      }
    }]
  })
});

disqualify_lead

Mierzy zdarzenia, kiedy użytkownik zostaje oznaczony jako niezakwalifikowany do zostania potencjalnym klientem, wraz z przyczyną dyskwalifikacji.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta conversion_value zdarzenia podana w 3-literowym formacie ISO 4217. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * conversion_value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
disqualified_lead_reason	string	Nie	Nie planuję zakupu	Przyczyna oznaczenia potencjalnego klienta jako niezakwalifikowanego.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie disqualify_lead za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "disqualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "disqualified_lead_reason": "Not looking to buy"
      }
    }]
  })
});

generate_lead

Mierzy zdarzenia, kiedy potencjalny klient został pozyskany (np. za pomocą formularza). Rejestruj te dane, aby poznać skuteczność kampanii marketingowych i dowiedzieć się, ilu klientów ponownie angażuje się w Twoją firmę po zastosowaniu remarketingu.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta conversion_value zdarzenia podana w 3-literowym formacie ISO 4217. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * conversion_value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
lead_source	string	Nie	Targi	Źródło potencjalnego klienta.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie generate_lead za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_source": "Trade show"
      }
    }]
  })
});

qualify_lead

Mierzy zdarzenia, kiedy użytkownik zostaje oznaczony jako spełniający kryteria kwalifikacji potencjalnych klientów.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta conversion_value zdarzenia podana w 3-literowym formacie ISO 4217. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * conversion_value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie qualify_lead za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "qualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

working_lead

Mierzy zdarzenia, kiedy użytkownik skontaktuje się z przedstawicielem lub przedstawiciel skontaktuje się z użytkownikiem.

Pola zdarzeń

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta conversion_value zdarzenia podana w 3-literowym formacie ISO 4217. * Jeśli określisz parametr conversion_value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
conversion_value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * conversion_value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości conversion_value. * Parametr currency jest wymagany, jeśli skonfigurujesz parametr conversion_value.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
lead_status	string	Nie	Rozpoczęte rozmowy	Stan potencjalnego klienta.

Przykład

Ten przykład pokazuje, jak wysłać zdarzenie working_lead za pomocą interfejsu Data Manager API. Jeśli przechodzisz z Measurement Protocol, użyj kart, aby przenieść żądania do interfejsu Data Manager API.

Data Manager API

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

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations"
      }
    }]
  })
});