Eventi

add_payment_info

Questo evento indica che un utente ha inviato i propri dati di pagamento durante una procedura di pagamento e-commerce.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere.

* Se imposti value, currency è necessario per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 7,77 Il valore monetario dell'evento.

* value è in genere obbligatorio per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare value.
* currency è obbligatorio se imposti value.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'evento.

I parametri coupon a livello di evento e di articolo sono indipendenti.
payment_type string No Carta di credito Il metodo di pagamento scelto.
items Array<Item> Yes Gli articoli dell'evento.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì* SKU_12345

L'ID dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico.
Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
creative_name string No summer_banner2 Il nome della creatività promozionale.

Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se presente.
discount number No 2,22 Valore dello sconto monetario associato all'articolo.
index number No 5 L'indice/la posizione dell'elemento in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category3 string No Camicie La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category4 string No Troupe La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category5 string No Manica corta La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_list_id string No related_products L'ID dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_id a livello di evento, se presente.
item_list_name string No Prodotti correlati Il nome dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_name a livello di evento, se presente.
item_variant string No verde La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato.
Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
price number No 9,99 € Il prezzo monetario dell'elemento, espresso in unità del parametro currency specificato.
promotion_id string No P_12345 L'ID della promozione associata all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se presente.
promotion_name string No Saldi estivi Il nome della promozione associata all'articolo.

Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_name a livello di evento, se presente.
quantity number No 1

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

Oltre ai parametri obbligatori, puoi includere fino a 27 parametri personalizzati nell'array items.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di GA4

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

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

add_shipping_info

Questo evento indica che un utente ha inviato le proprie informazioni di spedizione durante una procedura di pagamento e-commerce.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere.

* Se imposti value, currency è necessario per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 7,77 Il valore monetario dell'evento.

* value è in genere obbligatorio per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare value.
* currency è obbligatorio se imposti value.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'evento.

I parametri coupon a livello di evento e di articolo sono indipendenti.
shipping_tier string No Trasporto terrestre Livello di spedizione (ad es. Ground, Air, Next-day) selezionato per la consegna dell'articolo acquistato.
items Array<Item> Yes Gli articoli dell'evento.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì* SKU_12345

L'ID dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico.
Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
creative_name string No summer_banner2 Il nome della creatività promozionale.

Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se presente.
discount number No 2,22 Valore dello sconto monetario associato all'articolo.
index number No 5 L'indice/la posizione dell'elemento in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category3 string No Camicie La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category4 string No Troupe La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category5 string No Manica corta La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_list_id string No related_products L'ID dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_id a livello di evento, se presente.
item_list_name string No Prodotti correlati Il nome dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_name a livello di evento, se presente.
item_variant string No verde La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato.
Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
price number No 9,99 € Il prezzo monetario dell'elemento, espresso in unità del parametro currency specificato.
promotion_id string No P_12345 L'ID della promozione associata all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se presente.
promotion_name string No Saldi estivi Il nome della promozione associata all'articolo.

Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_name a livello di evento, se presente.
quantity number No 1

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

Oltre ai parametri obbligatori, puoi includere fino a 27 parametri personalizzati nell'array items.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di GA4

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

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

add_to_cart

Questo evento indica che un articolo è stato aggiunto al carrello per l'acquisto.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere.

* Se imposti value, currency è necessario per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 7,77 Il valore monetario dell'evento.

* value è in genere obbligatorio per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare value.
* currency è obbligatorio se imposti value.
items Array<Item> Yes Gli articoli dell'evento.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì* SKU_12345

L'ID dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico.
Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
creative_name string No summer_banner2 Il nome della creatività promozionale.

Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se presente.
discount number No 2,22 Valore dello sconto monetario associato all'articolo.
index number No 5 L'indice/la posizione dell'elemento in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category3 string No Camicie La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category4 string No Troupe La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category5 string No Manica corta La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_list_id string No related_products L'ID dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_id a livello di evento, se presente.
item_list_name string No Prodotti correlati Il nome dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_name a livello di evento, se presente.
item_variant string No verde La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato.
Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
price number No 9,99 € Il prezzo monetario dell'elemento, espresso in unità del parametro currency specificato.
promotion_id string No P_12345 L'ID della promozione associata all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se presente.
promotion_name string No Saldi estivi Il nome della promozione associata all'articolo.

Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_name a livello di evento, se presente.
quantity number No 1

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

Oltre ai parametri obbligatori, puoi includere fino a 27 parametri personalizzati nell'array items.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di GA4

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

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

add_to_wishlist

L'evento indica che un articolo è stato aggiunto a una lista desideri. Utilizza questo evento per identificare gli articoli regalo popolari nella tua app.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere.

* Se imposti value, currency è necessario per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 7,77 Il valore monetario dell'evento.

* value è in genere obbligatorio per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare value.
* currency è obbligatorio se imposti value.
items Array<Item> Yes Gli articoli dell'evento.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì* SKU_12345

L'ID dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico.
Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
creative_name string No summer_banner2 Il nome della creatività promozionale.

Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se presente.
discount number No 2,22 Valore dello sconto monetario associato all'articolo.
index number No 5 L'indice/la posizione dell'elemento in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category3 string No Camicie La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category4 string No Troupe La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category5 string No Manica corta La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_list_id string No related_products L'ID dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_id a livello di evento, se presente.
item_list_name string No Prodotti correlati Il nome dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_name a livello di evento, se presente.
item_variant string No verde La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato.
Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
price number No 9,99 € Il prezzo monetario dell'elemento, espresso in unità del parametro currency specificato.
promotion_id string No P_12345 L'ID della promozione associata all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se presente.
promotion_name string No Saldi estivi Il nome della promozione associata all'articolo.

Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_name a livello di evento, se presente.
quantity number No 1

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

Oltre ai parametri obbligatori, puoi includere fino a 27 parametri personalizzati nell'array items.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di GA4

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

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

begin_checkout

Questo evento indica che un utente ha avviato una procedura di pagamento.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere.

* Se imposti value, currency è necessario per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 7,77 Il valore monetario dell'evento.

* value è in genere obbligatorio per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare value.
* currency è obbligatorio se imposti value.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'evento.

I parametri coupon a livello di evento e di articolo sono indipendenti.
items Array<Item> Yes Gli articoli dell'evento.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì* SKU_12345

L'ID dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico.
Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
creative_name string No summer_banner2 Il nome della creatività promozionale.

Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se presente.
discount number No 2,22 Valore dello sconto monetario associato all'articolo.
index number No 5 L'indice/la posizione dell'elemento in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category3 string No Camicie La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category4 string No Troupe La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category5 string No Manica corta La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_list_id string No related_products L'ID dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_id a livello di evento, se presente.
item_list_name string No Prodotti correlati Il nome dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_name a livello di evento, se presente.
item_variant string No verde La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato.
Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
price number No 9,99 € Il prezzo monetario dell'elemento, espresso in unità del parametro currency specificato.
promotion_id string No P_12345 L'ID della promozione associata all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se presente.
promotion_name string No Saldi estivi Il nome della promozione associata all'articolo.

Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_name a livello di evento, se presente.
quantity number No 1

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

Oltre ai parametri obbligatori, puoi includere fino a 27 parametri personalizzati nell'array items.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di GA4

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


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

campaign_details

Utilizza questo evento per inviare i dettagli della campagna da applicare a eventi futuri.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
campaign_id string No google_1234 L'ID della campagna.
campaign string No Summer_fun Il nome utilizzato per identificare una promozione o una campagna strategica specifica.
source string No google La sorgente di traffico della campagna (ad es. google, email e così via).
medium string No cpc Il mezzo della campagna (ad es. email, costo per clic e così via)
term string No summer+travel Il termine della campagna utilizzato con la ricerca a pagamento per fornire le parole chiave per gli annunci.
content string No logolink I contenuti della campagna utilizzati per il test A/B e gli annunci con targeting basato sui contenuti al fine di differenziare gli annunci o i link che puntano allo stesso URL.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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

Questo evento misura quando a un utente viene assegnata una valuta virtuale in un gioco. Registra questo valore insieme a spend_virtual_currency per comprendere meglio la tua economia virtuale.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
virtual_currency_name string No Gemme Nome della valuta virtuale.
value number No 5 Il valore della valuta virtuale.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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

Questo evento misura quando è stato generato un lead (ad esempio, tramite un modulo). Registra questi dati per comprendere l'efficacia delle tue campagne di marketing e quanti clienti interagiscono nuovamente con la tua attività dopo il remarketing per i clienti.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere.

* Se imposti value, currency è necessario per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 7,77 Il valore monetario dell'evento.

* value è in genere obbligatorio per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare value.
* currency è obbligatorio se imposti value.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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

Registra questo evento quando un utente entra a far parte di un gruppo, ad esempio una gilda, una squadra o una famiglia. Usa questo evento per analizzare la popolarità di determinati gruppi o funzionalità social.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
group_id string No G_12345 L'ID del gruppo.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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

Questo evento indica che un giocatore è salito di livello in una partita. Utilizzalo per valutare la distribuzione dei livelli della tua base utenti e identificare i livelli difficili da completare.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
level number No 5 Il livello del personaggio.
character string No Giocatore 1 Il personaggio che è salito di livello.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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"
      }
    }]
  })
});

accedere

Invia questo evento per indicare che un utente ha eseguito l'accesso al tuo sito web o alla tua app.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
method string No Google Il metodo utilizzato per accedere.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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

Invia questo evento quando l'utente pubblica un punteggio. Utilizza questo evento per comprendere il rendimento degli utenti nel tuo gioco e correlare i punteggi migliori con i segmenti di pubblico o i comportamenti.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
score number Yes 10000 Il punteggio da pubblicare.
level number No 5 Il livello del punteggio.
character string No Giocatore 1 Il personaggio che ha ottenuto il punteggio.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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"
      }
    }]
  })
});

purchase

Questo evento indica quando un utente ha acquistato uno o più articoli.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere.

* Se imposti value, currency è necessario per calcolare accuratamente le metriche relative alle entrate.
transaction_id string Yes T_12345 L'identificatore univoco di una transazione.

Il parametro transaction_id ti consente di evitare di ricevere eventi duplicati per un acquisto.
value number Sì* 12,21 Il valore monetario dell'evento.

* value è obbligatorio per generare report significativi e completare il segmento di pubblico predittivo degli acquirenti.
* currency è obbligatorio se imposti value.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'evento.

I parametri coupon a livello di evento e di articolo sono indipendenti.
shipping number No 3,33 Costo di spedizione associato a una transazione.
tax number No 1.11 Oneri fiscali associati a una transazione.
items Array<Item> Yes Gli articoli dell'evento.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì* SKU_12345

L'ID dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico.
Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
creative_name string No summer_banner2 Il nome della creatività promozionale.

Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se presente.
discount number No 2,22 Valore dello sconto monetario associato all'articolo.
index number No 5 L'indice/la posizione dell'elemento in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category3 string No Camicie La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category4 string No Troupe La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category5 string No Manica corta La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_list_id string No related_products L'ID dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_id a livello di evento, se presente.
item_list_name string No Prodotti correlati Il nome dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_name a livello di evento, se presente.
item_variant string No verde La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato.
Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
price number No 9,99 € Il prezzo monetario dell'elemento, espresso in unità del parametro currency specificato.
promotion_id string No P_12345 L'ID della promozione associata all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se presente.
promotion_name string No Saldi estivi Il nome della promozione associata all'articolo.

Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_name a livello di evento, se presente.
quantity number No 1

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

Oltre ai parametri obbligatori, puoi includere fino a 27 parametri personalizzati nell'array items.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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": 12.21,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

refund

Questo evento indica quando uno o più articoli vengono rimborsati a un utente.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere.

* Se imposti value, currency è necessario per calcolare accuratamente le metriche relative alle entrate.
transaction_id string Yes T_12345 L'identificatore univoco di una transazione.
value number Sì* 7,77 Il valore monetario dell'evento.

* value è in genere obbligatorio per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare value.
* currency è obbligatorio se imposti value.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'evento.

I parametri coupon a livello di evento e di articolo sono indipendenti.
shipping number No 3,33 Costo di spedizione associato a una transazione.
tax number No 1.11 Oneri fiscali associati a una transazione.
items Array<Item> No* Gli articoli dell'evento.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì* SKU_12345

L'ID dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico.
Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
creative_name string No summer_banner2 Il nome della creatività promozionale.

Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se presente.
discount number No 2,22 Valore dello sconto monetario associato all'articolo.
index number No 5 L'indice/la posizione dell'elemento in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category3 string No Camicie La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category4 string No Troupe La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category5 string No Manica corta La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_list_id string No related_products L'ID dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_id a livello di evento, se presente.
item_list_name string No Prodotti correlati Il nome dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_name a livello di evento, se presente.
item_variant string No verde La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato.
Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
price number No 9,99 € Il prezzo monetario dell'elemento, espresso in unità del parametro currency specificato.
promotion_id string No P_12345 L'ID della promozione associata all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se presente.
promotion_name string No Saldi estivi Il nome della promozione associata all'articolo.

Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_name a livello di evento, se presente.
quantity number No 1

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

Oltre ai parametri obbligatori, puoi includere fino a 27 parametri personalizzati nell'array items.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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": 12.21,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

remove_from_cart

Questo evento indica che un articolo è stato rimosso da un carrello.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere.

* Se imposti value, currency è necessario per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 7,77 Il valore monetario dell'evento.

* value è in genere obbligatorio per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare value.
* currency è obbligatorio se imposti value.
items Array<Item> Yes Gli articoli dell'evento.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì* SKU_12345

L'ID dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico.
Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
creative_name string No summer_banner2 Il nome della creatività promozionale.

Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se presente.
discount number No 2,22 Valore dello sconto monetario associato all'articolo.
index number No 5 L'indice/la posizione dell'elemento in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category3 string No Camicie La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category4 string No Troupe La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category5 string No Manica corta La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_list_id string No related_products L'ID dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_id a livello di evento, se presente.
item_list_name string No Prodotti correlati Il nome dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_name a livello di evento, se presente.
item_variant string No verde La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato.
Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
price number No 9,99 € Il prezzo monetario dell'elemento, espresso in unità del parametro currency specificato.
promotion_id string No P_12345 L'ID della promozione associata all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se presente.
promotion_name string No Saldi estivi Il nome della promozione associata all'articolo.

Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_name a livello di evento, se presente.
quantity number No 1

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

Oltre ai parametri obbligatori, puoi includere fino a 27 parametri personalizzati nell'array items.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

Registra questo evento per indicare quando l'utente ha eseguito una ricerca. Puoi utilizzare questo evento per identificare ciò che gli utenti cercano sul tuo sito web o nella tua app. Ad esempio, puoi inviare questo evento quando un utente visualizza una pagina dei risultati di ricerca dopo aver eseguito una ricerca.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
search_term string Yes T-shirt Termine cercato.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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

Questo evento indica che un utente ha selezionato alcuni contenuti di un determinato tipo. Questo evento può aiutarti a identificare contenuti popolari e categorie di contenuti sul tuo sito web o nella tua app.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
content_type string No prodotto Il tipo di contenuti selezionati.
content_id string No C_12345 Identificatore per i contenuti selezionati.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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

Questo evento indica che un articolo è stato selezionato da un elenco.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_list_id string No related_products L'ID dell'elenco in cui l'articolo è stato presentato all'utente.

Ignorata se impostata a livello di articolo.
item_list_name string No Prodotti correlati Il nome dell'elenco in cui l'articolo è stato presentato all'utente.

Ignorata se impostata a livello di articolo.
items Array<Item> Sì* Gli articoli dell'evento.

* L'array items dovrebbe avere un singolo elemento, che rappresenta l'elemento selezionato. Se vengono forniti più elementi, verrà utilizzato solo il primo elemento in items.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì* SKU_12345

L'ID dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico.
Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
creative_name string No summer_banner2 Il nome della creatività promozionale.

Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se presente.
discount number No 2,22 Valore dello sconto monetario associato all'articolo.
index number No 5 L'indice/la posizione dell'elemento in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category3 string No Camicie La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category4 string No Troupe La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category5 string No Manica corta La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_list_id string No related_products L'ID dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_id a livello di evento, se presente.
item_list_name string No Prodotti correlati Il nome dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_name a livello di evento, se presente.
item_variant string No verde La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato.
Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
price number No 9,99 € Il prezzo monetario dell'elemento, espresso in unità del parametro currency specificato.
promotion_id string No P_12345 L'ID della promozione associata all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se presente.
promotion_name string No Saldi estivi Il nome della promozione associata all'articolo.

Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_name a livello di evento, se presente.
quantity number No 1

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

Oltre ai parametri obbligatori, puoi includere fino a 27 parametri personalizzati nell'array items.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

select_promotion

Questo evento indica che una promozione è stata selezionata da un elenco.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
creative_name string No summer_banner2 Il nome della creatività promozionale.

Ignorata se impostata a livello di articolo.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'evento.

Ignorata se impostata a livello di articolo.
promotion_id string No P_12345 L'ID della promozione associata all'evento.

Ignorata se impostata a livello di articolo.
promotion_name string No Saldi estivi Il nome della promozione associata all'evento.

Ignorata se impostata a livello di articolo.
items Array<Item> No Gli articoli dell'evento.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì* SKU_12345

L'ID dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico.
Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
creative_name string No summer_banner2 Il nome della creatività promozionale.

Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se presente.
discount number No 2,22 Valore dello sconto monetario associato all'articolo.
index number No 5 L'indice/la posizione dell'elemento in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category3 string No Camicie La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category4 string No Troupe La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category5 string No Manica corta La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_list_id string No related_products L'ID dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_id a livello di evento, se presente.
item_list_name string No Prodotti correlati Il nome dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_name a livello di evento, se presente.
item_variant string No verde La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato.
Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
price number No 9,99 € Il prezzo monetario dell'elemento, espresso in unità del parametro currency specificato.
promotion_id string No P_12345 L'ID della promozione associata all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se presente.
promotion_name string No Saldi estivi Il nome della promozione associata all'articolo.

Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_name a livello di evento, se presente.
quantity number No 1

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

Oltre ai parametri obbligatori, puoi includere fino a 27 parametri personalizzati nell'array items.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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": 9.99,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 1
          }
        ]
      }
    }]
  })
});

condivisione

Utilizza questo evento quando un utente ha condiviso contenuti.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
method string No Twitter Il metodo con cui vengono condivisi i contenuti.
content_type string No immagine Il tipo di contenuti condivisi.
item_id string No C_12345 L'ID dei contenuti condivisi.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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

Questo evento indica che un utente ha creato un account. Utilizza questo evento per comprendere i diversi comportamenti degli utenti che hanno eseguito l'accesso e quelli che non l'hanno eseguito.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
method string No Google Il metodo utilizzato per la registrazione.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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

Questo evento misura la vendita di beni virtuali nella tua app e ti aiuta a identificare quali beni virtuali sono più popolari.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
value number Yes 5 Il valore della valuta virtuale.
virtual_currency_name string Yes Gemme Nome della valuta virtuale.
item_name string No Booster iniziale Il nome dell'articolo per il quale viene utilizzata la valuta virtuale.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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

Questo evento indica l'inizio della procedura di onboarding. Utilizzalo in una canalizzazione con tutorial_complete per capire quanti utenti completano il tutorial.

Parametri

Nessun parametro suggerito per questo evento.

Nessun parametro per questo evento.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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

Questo evento indica il completamento della procedura di onboarding da parte dell'utente. Utilizzalo in una canalizzazione con tutorial_begin per capire quanti utenti completano il tutorial.

Parametri

Nessun parametro suggerito per questo evento.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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

Registra questo evento quando l'utente ha sbloccato un obiettivo. Questo evento può aiutarti a capire come gli utenti utilizzano il tuo gioco.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
achievement_id string Yes A_12345 ID dell'obiettivo raggiunto.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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

Questo evento indica che un utente ha visualizzato il carrello.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere.

* Se imposti value, currency è necessario per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 7,77 Il valore monetario dell'evento.

* value è in genere obbligatorio per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare value.
* currency è obbligatorio se imposti value.
items Array<Item> Yes Gli articoli dell'evento.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì* SKU_12345

L'ID dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico.
Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
creative_name string No summer_banner2 Il nome della creatività promozionale.

Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se presente.
discount number No 2,22 Valore dello sconto monetario associato all'articolo.
index number No 5 L'indice/la posizione dell'elemento in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category3 string No Camicie La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category4 string No Troupe La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category5 string No Manica corta La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_list_id string No related_products L'ID dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_id a livello di evento, se presente.
item_list_name string No Prodotti correlati Il nome dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_name a livello di evento, se presente.
item_variant string No verde La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato.
Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
price number No 9,99 € Il prezzo monetario dell'elemento, espresso in unità del parametro currency specificato.
promotion_id string No P_12345 L'ID della promozione associata all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se presente.
promotion_name string No Saldi estivi Il nome della promozione associata all'articolo.

Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_name a livello di evento, se presente.
quantity number No 1

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

Oltre ai parametri obbligatori, puoi includere fino a 27 parametri personalizzati nell'array items.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_item

Questo evento indica che alcuni contenuti sono stati mostrati all'utente. Utilizza questo evento per scoprire gli articoli più popolari visualizzati.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere.

* Se imposti value, currency è necessario per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 7,77 Il valore monetario dell'evento.

* value è in genere obbligatorio per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare value.
* currency è obbligatorio se imposti value.
items Array<Item> Yes Gli articoli dell'evento.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì* SKU_12345

L'ID dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico.
Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
creative_name string No summer_banner2 Il nome della creatività promozionale.

Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se presente.
discount number No 2,22 Valore dello sconto monetario associato all'articolo.
index number No 5 L'indice/la posizione dell'elemento in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category3 string No Camicie La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category4 string No Troupe La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category5 string No Manica corta La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_list_id string No related_products L'ID dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_id a livello di evento, se presente.
item_list_name string No Prodotti correlati Il nome dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_name a livello di evento, se presente.
item_variant string No verde La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato.
Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
price number No 9,99 € Il prezzo monetario dell'elemento, espresso in unità del parametro currency specificato.
promotion_id string No P_12345 L'ID della promozione associata all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se presente.
promotion_name string No Saldi estivi Il nome della promozione associata all'articolo.

Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_name a livello di evento, se presente.
quantity number No 1

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

Oltre ai parametri obbligatori, puoi includere fino a 27 parametri personalizzati nell'array items.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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": 9.99,
            "quantity": 1
          }
        ],
      }
    }]
  })
});

view_item_list

Registra questo evento quando all'utente viene presentato un elenco di elementi di una determinata categoria.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_list_id string No related_products L'ID dell'elenco in cui l'articolo è stato presentato all'utente.

Ignorata se impostata a livello di articolo.
item_list_name string No Prodotti correlati Il nome dell'elenco in cui l'articolo è stato presentato all'utente.

Ignorata se impostata a livello di articolo.
items Array<Item> Yes Gli articoli dell'evento.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì* SKU_12345

L'ID dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico.
Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
creative_name string No summer_banner2 Il nome della creatività promozionale.

Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se presente.
discount number No 2,22 Valore dello sconto monetario associato all'articolo.
index number No 5 L'indice/la posizione dell'elemento in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category3 string No Camicie La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category4 string No Troupe La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category5 string No Manica corta La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_list_id string No related_products L'ID dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_id a livello di evento, se presente.
item_list_name string No Prodotti correlati Il nome dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_name a livello di evento, se presente.
item_variant string No verde La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato.
Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
price number No 9,99 € Il prezzo monetario dell'elemento, espresso in unità del parametro currency specificato.
promotion_id string No P_12345 L'ID della promozione associata all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se presente.
promotion_name string No Saldi estivi Il nome della promozione associata all'articolo.

Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_name a livello di evento, se presente.
quantity number No 1

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

Oltre ai parametri obbligatori, puoi includere fino a 27 parametri personalizzati nell'array items.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_promotion

Questo evento indica che una promozione è stata visualizzata in un elenco.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
creative_name string No summer_banner2 Il nome della creatività promozionale.

Ignorata se impostata a livello di articolo.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'evento.

Ignorata se impostata a livello di articolo.
promotion_id string No P_12345 L'ID della promozione associata all'evento.

Ignorata se impostata a livello di articolo.
promotion_name string No Saldi estivi Il nome della promozione associata all'evento.

Ignorata se impostata a livello di articolo.
items Array<Item> Sì* Gli articoli dell'evento.

* L'array items dovrebbe avere un singolo elemento, che rappresenta l'articolo associato alla promozione. Se vengono forniti più elementi, verrà utilizzato solo il primo elemento in items.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì* SKU_12345

L'ID dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*Uno dei valori item_id o item_name è obbligatorio.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico.
Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
coupon string No SUMMER_FUN Nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
creative_name string No summer_banner2 Il nome della creatività promozionale.

Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se presente.
discount number No 2,22 Valore dello sconto monetario associato all'articolo.
index number No 5 L'indice/la posizione dell'elemento in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category3 string No Camicie La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category4 string No Troupe La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_category5 string No Manica corta La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
item_list_id string No related_products L'ID dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_id a livello di evento, se presente.
item_list_name string No Prodotti correlati Il nome dell'elenco in cui l'articolo è stato presentato all'utente.

Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato item_list_name a livello di evento, se presente.
item_variant string No verde La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato.
Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
price number No 9,99 € Il prezzo monetario dell'elemento, espresso in unità del parametro currency specificato.
promotion_id string No P_12345 L'ID della promozione associata all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se presente.
promotion_name string No Saldi estivi Il nome della promozione associata all'articolo.

Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_name a livello di evento, se presente.
quantity number No 1

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

Oltre ai parametri obbligatori, puoi includere fino a 27 parametri personalizzati nell'array items.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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": 9.99,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_search_results

Registra questo evento quando all'utente vengono presentati i risultati di una ricerca. Tieni presente che puoi attivare l'evento view_search_results per la raccolta automatica tramite la misurazione avanzata degli eventi in Google Analytics.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
search_term string No Abbigliamento Il termine utilizzato per la ricerca.

Invia evento

Prova questo evento nello strumento per la creazione di eventi di 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"
      }
    }]
  })
});