Eventi

ad_impression

Utilizza questo evento quando un utente visualizza un'impressione dell'annuncio.

  • Un ad_impression inviato utilizzando Measurement Protocol non verrà incluso nelle esportazioni verso altre piattaforme pubblicitarie come Google Ads.
  • L'invio di eventi ad_impression utilizzando Measurement Protocol può causare impressioni duplicate se hai configurato il tagging o l'SDK per i prodotti pubblicitari di Google collegati. Invia un evento ad_impression utilizzando Measurement Protocol solo se l'evento non è stato acquisito tramite il tagging o l'SDK.

Parametri

Nome Tipo Obbligatorie Valore di esempio Descrizione
ad_platform string No MoPub La piattaforma pubblicitaria.
ad_source string No AdColony L'origine annuncio.
ad_format string No Banner Il formato dell'annuncio.
ad_unit_name string No Banner_03 Il nome dell'unità pubblicitaria.
currency string No Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere.

* Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value number No 3,99 €
Il valore dell'impressione dell'annuncio.
* In genere il valore value è obbligatorio per generare report significativi.
* Il campo currency è obbligatorio se imposti value.

Invia evento

Prova questo evento nel generatore di eventi GA4

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

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

add_payment_info

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

Parametri

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

* Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 30:03 Il valore monetario dell'evento.

* Imposta value alla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* In genere il valore value è obbligatorio per generare report significativi. Se contrassegni l'evento come conversione, ti consigliamo di impostare value.
* Il campo 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 elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi GA4

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

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

add_shipping_info

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

Parametri

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

* Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 30:03 Il valore monetario dell'evento.

* Imposta value alla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* In genere il valore value è obbligatorio per generare report significativi. Se contrassegni l'evento come conversione, ti consigliamo di impostare value.
* Il campo 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 elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi GA4

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

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

add_to_cart

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

Parametri

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

* Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 30:03 Il valore monetario dell'evento.

* Imposta value alla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* In genere il valore value è obbligatorio per generare report significativi. Se contrassegni l'evento come conversione, ti consigliamo di impostare value.
* Il campo currency è obbligatorio se imposti value.
items Array<Item> Yes Gli elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi GA4

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

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

add_to_wishlist

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

Parametri

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

* Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 30:03 Il valore monetario dell'evento.

* Imposta value alla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* In genere il valore value è obbligatorio per generare report significativi. Se contrassegni l'evento come conversione, ti consigliamo di impostare value.
* Il campo currency è obbligatorio se imposti value.
items Array<Item> Yes Gli elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi GA4

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

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

begin_checkout

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

Parametri

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

* Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 30:03 Il valore monetario dell'evento.

* Imposta value alla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* In genere il valore value è obbligatorio per generare report significativi. Se contrassegni l'evento come conversione, ti consigliamo di impostare value.
* Il campo 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 elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi GA4

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


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

campaign_details

Utilizza questo evento per inviare dettagli della campagna che verranno applicati agli eventi futuri.

Parametri

Nome Tipo Obbligatorie 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 per distinguere gli annunci o i link che puntano allo stesso URL.

Invia evento

Prova questo evento nel generatore di eventi 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"
      }
    }]
  })
});

close_convert_lead

Questo evento misura quando un lead è stato convertito e chiuso (ad esempio tramite un acquisto).

Parametri

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

* Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 30:03 Il valore monetario dell'evento.

* Imposta value alla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* In genere il valore value è obbligatorio per generare report significativi. Se contrassegni l'evento come conversione, ti consigliamo di impostare value.
* Il campo currency è obbligatorio se imposti value.
items Array<Item> No Gli elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

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

close_unconvert_lead

Questo evento misura quando un utente viene contrassegnato come non lead convertito, insieme al motivo.

Parametri

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

* Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 30:03 Il valore monetario dell'evento.

* Imposta value alla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* In genere il valore value è obbligatorio per generare report significativi. Se contrassegni l'evento come conversione, ti consigliamo di impostare value.
* Il campo currency è obbligatorio se imposti value.
unconvert_lead_reason string No Non ho mai risposto Il motivo per cui il lead non è stato convertito.
items Array<Item> No Gli elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi 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": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

disqualify_lead

Questo evento misura quando un utente viene contrassegnato come squalificato per diventare lead, insieme al motivo della mancata idoneità.

Parametri

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

* Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 30:03 Il valore monetario dell'evento.

* Imposta value alla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* In genere il valore value è obbligatorio per generare report significativi. Se contrassegni l'evento come conversione, ti consigliamo di impostare value.
* Il campo currency è obbligatorio se imposti value.
disqualified_lead_reason string No Non voglio acquistare Il motivo per cui un lead è stato contrassegnato come squalificato.
items Array<Item> No Gli elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi 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": "disqualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "disqualified_lead_reason": "Not looking to buy",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

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 Obbligatorie Valore di esempio Descrizione
virtual_currency_name string No Gem Nome della valuta virtuale.
value number No 5 Valore della valuta virtuale.

Invia evento

Prova questo evento nel generatore di eventi 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 questo dato per capire l'efficacia delle tue campagne di marketing e quanti clienti interagiscono nuovamente con la tua attività dopo il remarketing verso i clienti.

Parametri

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

* Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 30:03 Il valore monetario dell'evento.

* Imposta value alla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* In genere il valore value è obbligatorio per generare report significativi. Se contrassegni l'evento come conversione, ti consigliamo di impostare value.
* Il campo currency è obbligatorio se imposti value.
lead_source string No Fiere L'origine del lead.
items Array<Item> No Gli elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

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

join_group

Registra questo evento quando un utente si unisce a un gruppo, ad esempio una gilda, un team o una famiglia. Usa questo evento per analizzare la popolarità di determinati gruppi o funzionalità social.

Parametri

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

Invia evento

Prova questo evento nel generatore di eventi 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 un gioco. Utilizzalo per valutare la distribuzione dei livelli della tua base utenti e identificare i livelli difficili da completare.

Parametri

Nome Tipo Obbligatorie 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 nel generatore di eventi 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 Obbligatorie Valore di esempio Descrizione
method string No Google Il metodo utilizzato per accedere.

Invia evento

Prova questo evento nel generatore di eventi 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 Obbligatorie 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 nel generatore di eventi 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 acquista uno o più articoli.

Parametri

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

* Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 30:03 Il valore monetario dell'evento.

* Imposta value alla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* In genere il valore value è obbligatorio per generare report significativi. Se contrassegni l'evento come conversione, ti consigliamo di impostare value.
* Il campo currency è obbligatorio se imposti value.
transaction_id string Yes T_12345 L'identificatore univoco di una transazione.

Il parametro transaction_id consente di evitare eventi duplicati per un acquisto.
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 elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi GA4

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

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

qualify_lead

Questo evento misura quando un utente viene contrassegnato come conforme ai criteri per diventare un lead qualificato.

Parametri

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

* Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 30:03 Il valore monetario dell'evento.

* Imposta value alla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* In genere il valore value è obbligatorio per generare report significativi. Se contrassegni l'evento come conversione, ti consigliamo di impostare value.
* Il campo currency è obbligatorio se imposti value.
items Array<Item> No Gli elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

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

refund

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

Parametri

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

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

* Imposta value alla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* In genere il valore value è obbligatorio per generare report significativi. Se contrassegni l'evento come conversione, ti consigliamo di impostare value.
* Il campo 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 elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi GA4

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

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

remove_from_cart

L'evento indica che un articolo è stato rimosso da un carrello.

Parametri

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

* Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 30:03 Il valore monetario dell'evento.

* Imposta value alla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* In genere il valore value è obbligatorio per generare report significativi. Se contrassegni l'evento come conversione, ti consigliamo di impostare value.
* Il campo currency è obbligatorio se imposti value.
items Array<Item> Yes Gli elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi GA4

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

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

screen_view

Utilizza questo evento per indicare che si è verificata una transizione sullo schermo.

Parametri

Nome Tipo Obbligatorie Valore di esempio Descrizione
screen_class string No MainActivity La classe dello schermo.
screen_name string No Informazioni Il nome dello schermo.

Invia evento

Prova questo evento nel generatore di eventi GA4

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

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

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, potresti inviare questo evento quando un utente visualizza una pagina dei risultati di ricerca dopo aver eseguito una ricerca.

Parametri

Nome Tipo Obbligatorie Valore di esempio Descrizione
search_term string Yes t-shirt Termine cercato.

Invia evento

Prova questo evento nel generatore di eventi 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 i contenuti popolari e le categorie di contenuti sul tuo sito web o nella tua app.

Parametri

Nome Tipo Obbligatorie Valore di esempio Descrizione
content_type string No prodotto Il tipo di contenuti selezionati.
content_id string No C_12345 Un identificatore per i contenuti selezionati.

Invia evento

Prova questo evento nel generatore di eventi 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 elemento è stato selezionato da un elenco.

Parametri

Nome Tipo Obbligatorie 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 elementi dell'evento.

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

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi GA4

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

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

select_promotion

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

Parametri

Nome Tipo Obbligatorie 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 creatività promozionale associata all'evento.

Ignorata se impostata a livello di articolo.
promotion_id string No P_12345 L'ID della promozione associato 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 elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi GA4

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

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

condividere

Utilizza questo evento quando un utente ha condiviso contenuti.

Parametri

Nome Tipo Obbligatorie Valore di esempio Descrizione
method string No Twitter Il metodo con cui i contenuti vengono condivisi.
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 nel generatore di eventi 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 che sono disconnessi.

Parametri

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

Invia evento

Prova questo evento nel generatore di eventi 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 sono i prodotti virtuali più popolari.

Parametri

Nome Tipo Obbligatorie Valore di esempio Descrizione
value number Yes 5 Valore della valuta virtuale.
virtual_currency_name string Yes Gem Nome della valuta virtuale.
item_name string No Booster iniziale Il nome dell'elemento per cui viene utilizzata la valuta virtuale.

Invia evento

Prova questo evento nel generatore di eventi 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

L'evento rappresenta l'inizio della procedura di inserimento. Utilizzalo in una canalizzazione con tutorial_complete per capire quanti utenti completano il tutorial.

Parametri

Nessun parametro suggerito per questo evento.

Non ci sono parametri per questo evento.

Invia evento

Prova questo evento nel generatore di eventi 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 nel generatore di eventi 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 l'esperienza degli utenti con il tuo gioco.

Parametri

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

Invia evento

Prova questo evento nel generatore di eventi 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

L'evento indica che un utente ha visualizzato il carrello.

Parametri

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

* Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 30:03 Il valore monetario dell'evento.

* Imposta value alla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* In genere il valore value è obbligatorio per generare report significativi. Se contrassegni l'evento come conversione, ti consigliamo di impostare value.
* Il campo currency è obbligatorio se imposti value.
items Array<Item> Yes Gli elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi GA4

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

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

view_item

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

Parametri

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

* Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 30:03 Il valore monetario dell'evento.

* Imposta value alla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* In genere il valore value è obbligatorio per generare report significativi. Se contrassegni l'evento come conversione, ti consigliamo di impostare value.
* Il campo currency è obbligatorio se imposti value.
items Array<Item> Yes Gli elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi GA4

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

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

view_item_list

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

Parametri

Nome Tipo Obbligatorie 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 elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi GA4

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

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

view_promotion

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

Parametri

Nome Tipo Obbligatorie 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 creatività promozionale associata all'evento.

Ignorata se impostata a livello di articolo.
promotion_id string No P_12345 L'ID della promozione associato 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 elementi dell'evento.

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

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi GA4

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

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

view_search_results

Registra questo evento quando all'utente vengono mostrati 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 Obbligatorie Valore di esempio Descrizione
search_term string No Abbigliamento Il termine utilizzato per la ricerca.

Invia evento

Prova questo evento nel generatore di eventi 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"
      }
    }]
  })
});

working_lead

Questo evento misura quando un utente contatta un rappresentante o viene contattato da un rappresentante.

Parametri

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

* Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value number Sì* 30:03 Il valore monetario dell'evento.

* Imposta value alla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* In genere il valore value è obbligatorio per generare report significativi. Se contrassegni l'evento come conversione, ti consigliamo di impostare value.
* Il campo currency è obbligatorio se imposti value.
lead_status string No Conversazioni avviate Lo stato del lead.
items Array<Item> No Gli elementi dell'evento.

Parametri degli elementi

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

L'ID dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

item_name string Sì* Maglietta Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare un valore tra item_id o item_name.

affiliation string No Google Store Un'affiliazione di prodotto per indicare un'azienda fornitrice o la sede di un negozio fisico.
Nota: l'affiliazione è disponibile solo nell'ambito dell'articolo.
coupon string No SUMMER_FUN Il 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 il valore creative_name a livello di evento, se presente.
creative_slot string No featured_app_1 Il nome dell'area creatività promozionale associata all'articolo.

Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se presente.
discount number No 2,22 Il valore dello sconto monetario unitario 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 A 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 il valore 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 il valore 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 dettagli/opzioni dell'articolo.
location_id string No ChIJIQBpAG2ahYAR_6128GcTUEo (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 di Google che corrisponde all'articolo associato. Puoi anche utilizzare un ID località personalizzato.
Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli.
price number No 10:01 Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato.
Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id string No P_12345 L'ID della promozione associato all'articolo.

Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore 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 il valore promotion_name a livello di evento, se presente.
quantity number No 3

Quantità articolo.

Se non viene configurato, quantity è impostato su 1.

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

Invia evento

Prova questo evento nel generatore di eventi 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": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});