ad_impression
Użyj tego zdarzenia, gdy użytkownik wyświetli reklamę.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
ad_platform |
string |
Nie | MoPub | Platforma reklamowa. |
ad_source |
string |
Nie | AdColony | Źródło reklam. |
ad_format |
string |
Nie | Baner | Format reklamy. |
ad_unit_name |
string |
Nie | Banner_03 | Nazwa jednostki reklamowej. |
currency |
string |
Nie | USD |
Waluta elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Nie | 3,99 EUR | Wartość wyświetlenia reklamy. * Wartość value jest zwykle wymagana do efektywnego raportowania.
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events":[{
"name":"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ł dane do płatności w ramach procesu płatności e-commerce.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego ze zdarzeniem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
payment_type |
string |
Nie | Karta kredytowa | Wybrana forma płatności. |
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Jeśli zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
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ótkie rękawy | Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_payment_info",
"params": {
"currency": "USD",
"value": 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 ramach procesu płatności e-commerce.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego ze zdarzeniem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
shipping_tier |
string |
Nie | Transport lądowy |
Poziom dostawy (np. Ground , Air , Next-day ) wybrany do dostawy kupionego produktu.
|
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Jeśli zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
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ótkie rękawy | Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_shipping_info",
"params": {
"currency": "USD",
"value": 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 elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Jeśli zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
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ótkie rękawy | Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_to_cart",
"params": {
"currency": "USD",
"value": 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 oznacza dodanie produktu do listy życzeń. Użyj tego zdarzenia, aby zidentyfikować popularne prezenty w swojej aplikacji.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Jeśli zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
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ótkie rękawy | Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_to_wishlist",
"params": {
"currency": "USD",
"value": 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 elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego ze zdarzeniem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Jeśli zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
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ótkie rękawy | Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "begin_checkout",
"params": {
"currency": "USD",
"value": 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 wysyłać szczegóły kampanii, które zostaną zastosowane do przyszłych wydarzeń.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
campaign_id |
string |
Nie | google_1234 | Identyfikator kampanii. |
campaign |
string |
Nie | Summer_fun | Nazwa używana do identyfikacji określonej promocji lub kampanii strategicznej. |
source |
string |
Nie | Ź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 | Hasło kampanii użyte w płatnym wyszukiwaniu do dostarczania słów kluczowych do reklam. |
content |
string |
Nie | logolink | Treść kampanii służąca do testów A/B oraz reklam kierowanych na sieć reklamową w celu rozróżnienia reklam lub linków kierujących do tego samego adresu URL. |
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "campaign_details",
"params": {
"campaign_id": "google_1234",
"campaign": "Summer_fun",
"source": "google",
"medium": "cpc",
"term": "summer+travel",
"content": "logolink"
}
}]
})
});
earn_virtual_currency
Jest to zdarzenie polegające na tym, że użytkownik otrzymuje wirtualną walutę w grze. Zapisz go wraz z atrybutem spend_virtual_currency, aby lepiej poznać swoją gospodarkę wirtualną.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
virtual_currency_name |
string |
Nie | Gemy | Nazwa waluty wirtualnej. |
value |
number |
Nie | 5 | Wartość wirtualnej waluty. |
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "earn_virtual_currency",
"params": {
"virtual_currency_name": "Gems",
"value": 5
}
}]
})
});
generate_lead
Mierzy ono czas wygenerowania potencjalnego klienta (np. za pomocą formularza). Zapisuj te dane, by poznać skuteczność swoich kampanii marketingowych i liczbę klientów, którzy ponownie weszli w interakcję z Twoją firmą po rozpoczęciu interakcji z reklamą kierowaną do klientów.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "generate_lead",
"params": {
"currency": "USD",
"value": 99.99
}
}]
})
});
join_group
Zarejestruj to wydarzenie, gdy użytkownik dołączy do grupy, takiej jak gildia, zespół lub rodzina. Dzięki temu zdarzeniu możesz analizować popularność określonych grup lub funkcji społecznościowych.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
group_id |
string |
Nie | G_12345 | Identyfikator grupy. |
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events":[{
"name":"join_group",
"params":{
"group_id":"G_12345"
}
}]
})
});
level_up
To wydarzenie oznacza, że gracz awansował w grze na kolejny poziom. Za jego pomocą możesz określić rozkład poziomów grupy użytkowników i zidentyfikować poziomy, które są trudne do ukończenia.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
level |
number |
Nie | 5 | Poziom postaci. |
character |
string |
Nie | Gracz 1 | Postać, która awansowała na wyższy poziom. |
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "level_up",
"params": {
"level": 5,
"character": "Player 1"
}
}]
})
});
logowanie
Wysyłaj to zdarzenie, aby informować, że użytkownik zalogował się w Twojej witrynie lub aplikacji.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
method |
string |
Nie | Metoda używana do logowania. |
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "login",
"params": {
"method": "Google"
}
}]
})
});
post_score
Wyślij to zdarzenie, gdy użytkownik opublikuje wynik. Dzięki temu zdarzeniu możesz się dowiedzieć, jak użytkownicy radzą sobie w grze, oraz skorelować wysokie wyniki z odbiorcami lub zachowaniami użytkowników.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
score |
number |
Tak | 10 tys. | Wynik do opublikowania. |
level |
number |
Nie | 5 | Poziom wyniku. |
character |
string |
Nie | Gracz 1 | Postać, która osiągnęła wynik. |
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "post_score",
"params": {
"score": 10000,
"level": 5,
"character": "Player 1"
}
}]
})
});
zakup
To zdarzenie sygnalizuje zakup co najmniej jednego produktu przez użytkownika.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
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 coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
shipping |
number |
Nie | 3,33 | Koszt dostawy powiązany z transakcją. |
tax |
number |
Nie | 1.11 | Koszt podatku związany z transakcją. |
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Jeśli zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
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ótkie rękawy | Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "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
}
]
}
}]
})
});
refund
To zdarzenie sygnalizuje, gdy użytkownik otrzyma zwrot środków za co najmniej 1 produkt.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
transaction_id |
string |
Tak | T_12345 | Unikalny identyfikator transakcji. |
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego ze zdarzeniem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
shipping |
number |
Nie | 3,33 | Koszt dostawy powiązany z transakcją. |
tax |
number |
Nie | 1.11 | Koszt podatku związany z transakcją. |
items |
Array<Item>
|
Nie* | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Jeśli zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
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ótkie rękawy | Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "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 elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Jeśli zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
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ótkie rękawy | Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "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
Używaj tego zdarzenia do sygnalizowania, że nastąpiło przejście ekranu.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
screen_class |
string |
Nie | MainActivity | Klasa ekranu. |
screen_name |
string |
Nie | Informacje | Nazwa ekranu. |
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "screen_view",
"params": {
"screen_class": "MainActivity",
"screen_name": "About"
}
}]
})
});
search
Zarejestruj to zdarzenie, aby wskazać, kiedy użytkownik przeprowadził wyszukiwanie. Korzystając z tego zdarzenia, możesz się dowiedzieć, czego szukają użytkownicy w Twojej witrynie lub aplikacji. Możesz na przykład 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 | koszulki | Wyszukiwany produkt. |
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "search",
"params": {
"search_term": "t-shirts"
}
}]
})
});
select_content
To zdarzenie oznacza, że użytkownik wybrał treści określonego typu. To zdarzenie pomoże Ci zidentyfikować popularne treści oraz kategorie treści w 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 wybranej treści. |
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "select_content",
"params": {
"content_type": "product",
"content_id": "C_12345"
}
}]
})
});
select_item
To zdarzenie 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 ustawiono na poziomie produktu. |
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Ignorowane, jeśli ustawiono na poziomie produktu. |
items |
Array<Item> |
Tak* | Elementy związane z wydarzeniem. * Tablica items powinna zawierać jeden element, który reprezentuje wybrany element. Jeśli podasz wiele elementów, używany będzie tylko pierwszy z nich items .
|
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Jeśli zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
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ótkie rękawy | Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "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 ustawiono na poziomie produktu. |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego ze zdarzeniem. Ignorowane, jeśli ustawiono na poziomie produktu. |
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej ze zdarzeniem. Ignorowane, jeśli ustawiono na poziomie produktu. |
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej ze zdarzeniem. Ignorowane, jeśli ustawiono na poziomie produktu. |
items |
Array<Item>
|
Nie | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Jeśli zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
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ótkie rękawy | Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "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
}
]
}
}]
})
});
udostępnienie
Użyj tego zdarzenia, gdy użytkownik udostępni treść.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
method |
string |
Nie | Metoda udostępniania treści. | |
content_type |
string |
Nie | obraz | Typ udostępnianej treści. |
item_id |
string |
Nie | C_12345 | Identyfikator udostępnianej treści. |
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "share",
"params": {
"method": "Twitter",
"content_type": "image",
"item_id": "C_12345"
}
}]
})
});
sign_up
To zdarzenie oznacza, że użytkownik założył konto. Dzięki temu zdarzeniu możesz poznawać różne zachowania zalogowanych i niezalogowanych użytkowników.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
method |
string |
Nie | Metoda użyta do rejestracji. |
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "sign_up",
"params": {
"method": "Google"
}
}]
})
});
spend_virtual_currency
Mierzy ono sprzedaż wirtualnych towarów w Twojej aplikacji i pomaga określić, które towary są najpopularniejsze.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
value |
number |
Tak | 5 | Wartość wirtualnej waluty. |
virtual_currency_name |
string |
Tak | Gemy | Nazwa waluty wirtualnej. |
item_name |
string |
Nie | Wzmocnienie na początek | Nazwa produktu, dla którego używana jest waluta wirtualna. |
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "spend_virtual_currency",
"params": {
"value": 5,
"virtual_currency_name": "Gems",
"item_name": "Starter Boost"
}
}]
})
});
tutorial_begin
Oznacza ono rozpoczęcie procesu rejestracji. Użyj go w przypadku ścieżki z parametrem tutorial_complete, na podstawie którego możesz się dowiedzieć, ilu użytkowników ukończyło samouczek.
Parametry
Dla tego zdarzenia nie są sugerowane żadne parametry.
Nie ma parametrów dla tego zdarzenia.
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "tutorial_begin"
}]
})
});
tutorial_complete
Zdarzenie to sygnalizuje zakończenie procesu rejestracji przez użytkownika. Możesz go wykorzystać w ścieżce z parametrem tutorial_begin, aby dowiedzieć się, ilu użytkowników ukończyło samouczek.
Parametry
Dla tego zdarzenia nie są sugerowane żadne parametry.
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "tutorial_complete"
}]
})
});
unlock_achievement
Zarejestruj to zdarzenie, gdy użytkownik odblokuje osiągnięcie. Dzięki temu dowiesz się, 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 wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "unlock_achievement",
"params": {
"achievement_id": "A_12345"
}
}]
})
});
view_cart
To zdarzenie oznacza, że użytkownik wyświetlił swój koszyk.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Jeśli zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
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ótkie rękawy | Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "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żytkownik wyświetlił pewne treści. Skorzystaj z tego zdarzenia, aby dowiedzieć się, które produkty są najpopularniejsze.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Jeśli zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
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ótkie rękawy | Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "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
Zarejestruj to zdarzenie, gdy użytkownikowi zostanie wyświetlona lista elementów z określonej kategorii.
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 ustawiono na poziomie produktu. |
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Ignorowane, jeśli ustawiono na poziomie produktu. |
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Jeśli zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
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ótkie rękawy | Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "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 z listy.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Ignorowane, jeśli ustawiono na poziomie produktu. |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego ze zdarzeniem. Ignorowane, jeśli ustawiono na poziomie produktu. |
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej ze zdarzeniem. Ignorowane, jeśli ustawiono na poziomie produktu. |
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej ze zdarzeniem. Ignorowane, jeśli ustawiono na poziomie produktu. |
items |
Array<Item> |
Tak* | Elementy związane z wydarzeniem. * Tablica items powinna zawierać jeden element, który reprezentuje element powiązany z promocją. Jeśli podasz wiele elementów, używany będzie tylko pierwszy z nich items .
|
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Jeśli zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
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ótkie rękawy | Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "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
Zarejestruj to zdarzenie, gdy użytkownik zobaczy wyniki wyszukiwania. Pamiętaj, że zdarzenie view_search_results możesz włączyć w przypadku automatycznego zbierania danych za pomocą pomiaru zaawansowanego w Google Analytics.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
search_term |
string |
Nie | Odzież | Hasło użyte do wyszukiwania. |
Wyślij wydarzenie
Wypróbuj to zdarzenie w Kreatorze zdarzeń GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_search_results",
"params": {
"search_term": "Clothing"
}
}]
})
});