Wydarzenia

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 usług reklamowych Google. Zdarzenie ad_impression wysyłaj za pomocą platformy Measurement Protocol tylko wtedy, gdy nie zostało ono zarejestrowane przez tagowanie lub pakiet SDK.

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.
currency string Nie USD Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217.

* Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value number Nie 3,99 EUR
Wartość wyświetlenia reklamy.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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

add_payment_info

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

Parametry

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 value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego ze zdarzeniem.

Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
payment_type string Nie Karta kredytowa Wybrana forma płatności.
items Array<Item> Tak Produkty powiązane ze zdarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest jedna z tych właściwości: item_id lub item_name.

item_name string Tak* koszulka „Stan and Friends”,

Nazwa elementu.

*Wymagana jest jedna z tych właściwoś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: parametr „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) Lokalizacja fizyczna 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

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

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_shipping_info

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

Parametry

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 value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego ze zdarzeniem.

Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
shipping_tier string Nie Ziemia Poziom dostawy (np. Ground, Air, Next-day) wybrany w przypadku zakupionego produktu.
items Array<Item> Tak Produkty powiązane ze zdarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest jedna z tych właściwości: item_id lub item_name.

item_name string Tak* koszulka „Stan and Friends”,

Nazwa elementu.

*Wymagana jest jedna z tych właściwoś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: parametr „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) Lokalizacja fizyczna 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

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

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_cart

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

Parametry

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 value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
items Array<Item> Tak Produkty powiązane ze zdarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest jedna z tych właściwości: item_id lub item_name.

item_name string Tak* koszulka „Stan and Friends”,

Nazwa elementu.

*Wymagana jest jedna z tych właściwoś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: parametr „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) Lokalizacja fizyczna 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

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

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_wishlist

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

Parametry

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 value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
items Array<Item> Tak Produkty powiązane ze zdarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest jedna z tych właściwości: item_id lub item_name.

item_name string Tak* koszulka „Stan and Friends”,

Nazwa elementu.

*Wymagana jest jedna z tych właściwoś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: parametr „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) Lokalizacja fizyczna 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

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

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

begin_checkout

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

Parametry

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 value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego ze zdarzeniem.

Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
items Array<Item> Tak Produkty powiązane ze zdarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest jedna z tych właściwości: item_id lub item_name.

item_name string Tak* koszulka „Stan and Friends”,

Nazwa elementu.

*Wymagana jest jedna z tych właściwoś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: parametr „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) Lokalizacja fizyczna 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

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

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

campaign_details

Użyj tego zdarzenia, aby wysłać szczegóły kampanii, które zostaną zastosowane do przyszłych zdarzeń.

Parametry

Nazwa Typ Wymagane Przykładowa wartość Opis
campaign_id string Nie google_1234 Identyfikator kampanii.
campaign string Nie Letnia_zabawa 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.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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

close_convert_lead

Mierzy zdarzenia, kiedy potencjalny klient został przekształcony w klienta i zakończył proces (np. poprzez zakup).

Parametry

Nazwa Typ Wymagane Przykładowa wartość Opis
currency string Tak* USD Waluta value zdarzenia podana w 3-literowym formacie ISO 4217.

* Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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, wraz z podaniem przyczyny.

Parametry

Nazwa Typ Wymagane Przykładowa wartość Opis
currency string Tak* USD Waluta value zdarzenia podana w 3-literowym formacie ISO 4217.

* Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
unconvert_lead_reason string Nie Nigdy nie odpowiedział Przyczyna, dla której kontakt do potencjalnego klienta nie został przekształcony w klienta.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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 powodem niezakwalifikowania.

Parametry

Nazwa Typ Wymagane Przykładowa wartość Opis
currency string Tak* USD Waluta value zdarzenia podana w 3-literowym formacie ISO 4217.

* Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
disqualified_lead_reason string Nie Nie planuję zakupu Przyczyna oznaczenia potencjalnego klienta jako niezakwalifikowanego.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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

earn_virtual_currency

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

Parametry

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

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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

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

generate_lead

Mierzy zdarzenia, kiedy został wygenerowany potencjalny klient (np. za pomocą formularza). Rejestruj te dane, aby sprawdzać skuteczność kampanii marketingowych i liczbę klientów, którzy ponownie angażują się w Twoją firmę po zastosowaniu remarketingu.

Parametry

Nazwa Typ Wymagane Przykładowa wartość Opis
currency string Tak* USD Waluta value zdarzenia podana w 3-literowym formacie ISO 4217.

* Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
lead_source string Nie Targi Źródło potencjalnego klienta.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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

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.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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

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

level_up

To zdarzenie oznacza, że gracz przeszedł w grze na wyższy poziom. Możesz dzięki temu ocenić rozkład poziomów wśród użytkowników i określić, które z nich 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.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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

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

login

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.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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

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

post_score

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 uzyskała wynik.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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

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

purchase

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

Parametry

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 value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
transaction_id string Tak T_12345 Unikalny identyfikator transakcji.

Parametr transaction_id pomaga uniknąć otrzymywania zduplikowanych zdarzeń zakupu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego ze zdarzeniem.

Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
shipping number Nie 3,33 Koszt dostawy powiązany z transakcją.
tax number Nie 1.11 Koszty podatkowe powiązane z transakcją.
items Array<Item> Tak Produkty powiązane ze zdarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest jedna z tych właściwości: item_id lub item_name.

item_name string Tak* koszulka „Stan and Friends”,

Nazwa elementu.

*Wymagana jest jedna z tych właściwoś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: parametr „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) Lokalizacja fizyczna 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

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

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

qualify_lead

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

Parametry

Nazwa Typ Wymagane Przykładowa wartość Opis
currency string Tak* USD Waluta value zdarzenia podana w 3-literowym formacie ISO 4217.

* Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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

refund

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

Parametry

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 value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
transaction_id string Tak T_12345 Unikalny identyfikator transakcji.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego ze zdarzeniem.

Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
shipping number Nie 3,33 Koszt dostawy powiązany z transakcją.
tax number Nie 1.11 Koszty podatkowe powiązane z transakcją.
items Array<Item> Nie* Produkty powiązane ze zdarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest jedna z tych właściwości: item_id lub item_name.

item_name string Tak* koszulka „Stan and Friends”,

Nazwa elementu.

*Wymagana jest jedna z tych właściwoś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: parametr „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) Lokalizacja fizyczna 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

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

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

remove_from_cart

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

Parametry

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 value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
items Array<Item> Tak Produkty powiązane ze zdarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest jedna z tych właściwości: item_id lub item_name.

item_name string Tak* koszulka „Stan and Friends”,

Nazwa elementu.

*Wymagana jest jedna z tych właściwoś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: parametr „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) Lokalizacja fizyczna 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

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

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

screen_view

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

Używaj tego zdarzenia, aby sygnalizować 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.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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

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.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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

select_item

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

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.

Ignorowane, jeśli ustawione na poziomie produktu.
item_list_name string Nie Produkty powiązane Nazwa listy, na której produkt został przedstawiony użytkownikowi.

Ignorowane, jeśli ustawione na poziomie produktu.
items Array<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.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest jedna z tych właściwości: item_id lub item_name.

item_name string Tak* koszulka „Stan and Friends”,

Nazwa elementu.

*Wymagana jest jedna z tych właściwoś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: parametr „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) Lokalizacja fizyczna 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

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

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_promotion

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

Parametry

Nazwa Typ Wymagane Przykładowa wartość Opis
creative_name string Nie summer_banner2 Nazwa kreacji promocyjnej.

Ignorowane, jeśli ustawione na poziomie produktu.
creative_slot string Nie featured_app_1 Nazwa boksu kreacji promocyjnej powiązanego ze zdarzeniem.

Ignorowane, jeśli ustawione na poziomie produktu.
promotion_id string Nie P_12345 Identyfikator promocji powiązanej ze zdarzeniem.

Ignorowane, jeśli ustawione na poziomie produktu.
promotion_name string Nie Letnia wyprzedaż Nazwa promocji powiązanej ze zdarzeniem.

Ignorowane, jeśli ustawione na poziomie produktu.
items Array<Item> Nie Produkty powiązane ze zdarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest jedna z tych właściwości: item_id lub item_name.

item_name string Tak* koszulka „Stan and Friends”,

Nazwa elementu.

*Wymagana jest jedna z tych właściwoś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: parametr „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 ten parametr jest ustawiony, parametr creative_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest ustawiona, używana jest wartość creative_name na poziomie zdarzenia, o ile jest dostępna.
creative_slot string Nie featured_app_1 Nazwa boksu kreacji promocyjnej powiązanego z produktem.

Jeśli ten parametr jest ustawiony, parametr creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli nie jest ustawiona, używana jest wartość creative_slot na poziomie zdarzenia, o ile jest dostępna.
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) Lokalizacja fizyczna 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
promotion_id string Nie P_12345 Identyfikator promocji powiązanej z produktem.

Jeśli ten parametr jest ustawiony, parametr promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest ustawiona, używana jest wartość promotion_id na poziomie zdarzenia, o ile jest dostępna.
promotion_name string Nie Letnia wyprzedaż Nazwa promocji powiązanej z produktem.

Jeśli ten parametr jest ustawiony, parametr promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest ustawiona, używana jest wartość promotion_name na poziomie zdarzenia, o ile jest dostępna.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

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

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

share

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

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.
item_id string Nie C_12345 Identyfikator udostępnionych treści.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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.

Parametry

Nazwa Typ Wymagane Przykładowa wartość Opis
value number Tak 5 Wartość waluty wirtualnej.
virtual_currency_name string Tak Klejnoty Nazwa waluty wirtualnej.
item_name string Nie Starter Boost Nazwa produktu, do którego używana jest waluta wirtualna.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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 wprowadzania. Użyj tego zdarzenia w ścieżce z parametrem tutorial_complete, aby dowiedzieć się, ilu użytkowników ukończyło samouczek.

Parametry

Dla tego zdarzenia nie są sugerowane żadne parametry.

To zdarzenie nie ma parametrów.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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 wprowadzania. Użyj tego parametru na ś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.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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

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

unlock_achievement

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.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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

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

view_cart

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

Parametry

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 value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
items Array<Item> Tak Produkty powiązane ze zdarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest jedna z tych właściwości: item_id lub item_name.

item_name string Tak* koszulka „Stan and Friends”,

Nazwa elementu.

*Wymagana jest jedna z tych właściwoś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: parametr „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) Lokalizacja fizyczna 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

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

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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,
            "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.

Parametry

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 value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
items Array<Item> Tak Produkty powiązane ze zdarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest jedna z tych właściwości: item_id lub item_name.

item_name string Tak* koszulka „Stan and Friends”,

Nazwa elementu.

*Wymagana jest jedna z tych właściwoś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: parametr „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) Lokalizacja fizyczna 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

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

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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,
            "quantity": 3
          }
        ],
      }
    }]
  })
});

view_item_list

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

Parametry

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 value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
item_list_id string Nie related_products Identyfikator listy, na której produkt został przedstawiony użytkownikowi.

Ignorowane, jeśli ustawione na poziomie produktu.
item_list_name string Nie Produkty powiązane Nazwa listy, na której produkt został przedstawiony użytkownikowi.

Ignorowane, jeśli ustawione na poziomie produktu.
items Array<Item> Tak Produkty powiązane ze zdarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest jedna z tych właściwości: item_id lub item_name.

item_name string Tak* koszulka „Stan and Friends”,

Nazwa elementu.

*Wymagana jest jedna z tych właściwoś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: parametr „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) Lokalizacja fizyczna 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

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

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_promotion

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

Parametry

Nazwa Typ Wymagane Przykładowa wartość Opis
creative_name string Nie summer_banner2 Nazwa kreacji promocyjnej.

Ignorowane, jeśli ustawione na poziomie produktu.
creative_slot string Nie featured_app_1 Nazwa boksu kreacji promocyjnej powiązanego ze zdarzeniem.

Ignorowane, jeśli ustawione na poziomie produktu.
promotion_id string Nie P_12345 Identyfikator promocji powiązanej ze zdarzeniem.

Ignorowane, jeśli ustawione na poziomie produktu.
promotion_name string Nie Letnia wyprzedaż Nazwa promocji powiązanej ze zdarzeniem.

Ignorowane, jeśli ustawione na poziomie produktu.
items Array<Item> Tak* Produkty powiązane ze zdarzeniem.

* Oczekuje się, że tablica items będzie zawierać jeden element reprezentujący produkt powiązany z promocją. Jeśli podasz kilka elementów, użyty zostanie tylko pierwszy element w items.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest jedna z tych właściwości: item_id lub item_name.

item_name string Tak* koszulka „Stan and Friends”,

Nazwa elementu.

*Wymagana jest jedna z tych właściwoś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: parametr „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 ten parametr jest ustawiony, parametr creative_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest ustawiona, używana jest wartość creative_name na poziomie zdarzenia, o ile jest dostępna.
creative_slot string Nie featured_app_1 Nazwa boksu kreacji promocyjnej powiązanego z produktem.

Jeśli ten parametr jest ustawiony, parametr creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli nie jest ustawiona, używana jest wartość creative_slot na poziomie zdarzenia, o ile jest dostępna.
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) Lokalizacja fizyczna 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
promotion_id string Nie P_12345 Identyfikator promocji powiązanej z produktem.

Jeśli ten parametr jest ustawiony, parametr promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest ustawiona, używana jest wartość promotion_id na poziomie zdarzenia, o ile jest dostępna.
promotion_name string Nie Letnia wyprzedaż Nazwa promocji powiązanej z produktem.

Jeśli ten parametr jest ustawiony, parametr promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest ustawiona, używana jest wartość promotion_name na poziomie zdarzenia, o ile jest dostępna.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

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

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

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ż Hasło użyte do wyszukiwania.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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

working_lead

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

Parametry

Nazwa Typ Wymagane Przykładowa wartość Opis
currency string Tak* USD Waluta value zdarzenia podana w 3-literowym formacie ISO 4217.

* Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
lead_status string Nie Rozpoczęte rozmowy Stan potencjalnego klienta.

Wyślij zdarzenie

Wypróbuj to zdarzenie w kreatorze zdarzeń Google Analytics

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