Questa pagina è stata tradotta dall'API Cloud Translation.

Eventi

ad_impression

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

Parametri

Nome	Tipo	Obbligatorio	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` è necessario per calcolare accuratamente le metriche relative alle entrate.
`value`	`number`	No	3,99 €	Il valore dell'impressione dell'annuncio. * `value` è in genere necessaria per generare report significativi. * `currency` è obbligatorio se imposti `value`.

Invia evento

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"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 durante una procedura di pagamento e-commerce.

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`currency`	`string`	Sì*	€	Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti `value`, `currency` è necessario per calcolare accuratamente le metriche relative alle entrate.
`value`	`number`	Sì*	30,03	Il valore monetario dell'evento. * Imposta `value` sulla somma di `(price * quantity)` per tutti gli elementi in `items`. Non includere `shipping` o `tax`. * `value` è in genere necessaria per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare `value`. * `currency` è obbligatorio se imposti `value`.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'evento. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`payment_type`	`string`	No	Carta di credito	Il metodo di pagamento scelto.
`items`	`Array<Item>`	Yes		Gli articoli dell'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`item_id`	`string`	Sì*	SKU_12345	L'ID dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`item_name`	`string`	Sì*	Maglietta Stan and Friends	Il nome dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`affiliation`	`string`	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`creative_name`	`string`	No	summer_banner2	Il nome della creatività promozionale. Se impostato, il criterio `creative_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_name` a livello di evento, se presente.
`creative_slot`	`string`	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio `creative_slot` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_slot` a livello di evento, se presente.
`discount`	`number`	No	2,22	Valore dello sconto monetario 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	Manica corta	La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
`item_list_id`	`string`	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_id` a livello di evento, se presente.
`item_list_name`	`string`	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_name` a livello di evento, se presente.
`item_variant`	`string`	No	verde	La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco)	La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
`price`	`number`	No	10,01	Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato. Se all'articolo viene applicato 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 associata all'articolo. Se impostato, il criterio `promotion_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_id` a livello di evento, se presente.
`promotion_name`	`string`	No	Saldi estivi	Il nome della promozione associata all'articolo. Se impostato, il criterio `promotion_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_name` a livello di evento, se presente.
`quantity`	`number`	No	3	Quantità articolo. Se non viene configurato, `quantity` è impostato su 1.

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

Invia evento

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_payment_info",
      "params": {
        "currency": "USD",
        "value": 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 le proprie informazioni di spedizione durante una procedura di pagamento e-commerce.

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`currency`	`string`	Sì*	€	Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti `value`, `currency` è necessario per calcolare accuratamente le metriche relative alle entrate.
`value`	`number`	Sì*	30,03	Il valore monetario dell'evento. * Imposta `value` sulla somma di `(price * quantity)` per tutti gli elementi in `items`. Non includere `shipping` o `tax`. * `value` è in genere necessaria per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare `value`. * `currency` è obbligatorio se imposti `value`.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'evento. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`shipping_tier`	`string`	No	Trasporto terrestre	Livello di spedizione (ad es. `Ground`, `Air`, `Next-day`) selezionato per la consegna dell'articolo acquistato.
`items`	`Array<Item>`	Yes		Gli articoli dell'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`item_id`	`string`	Sì*	SKU_12345	L'ID dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`item_name`	`string`	Sì*	Maglietta Stan and Friends	Il nome dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`affiliation`	`string`	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`creative_name`	`string`	No	summer_banner2	Il nome della creatività promozionale. Se impostato, il criterio `creative_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_name` a livello di evento, se presente.
`creative_slot`	`string`	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio `creative_slot` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_slot` a livello di evento, se presente.
`discount`	`number`	No	2,22	Valore dello sconto monetario 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	Manica corta	La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
`item_list_id`	`string`	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_id` a livello di evento, se presente.
`item_list_name`	`string`	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_name` a livello di evento, se presente.
`item_variant`	`string`	No	verde	La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco)	La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
`price`	`number`	No	10,01	Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato. Se all'articolo viene applicato 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 associata all'articolo. Se impostato, il criterio `promotion_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_id` a livello di evento, se presente.
`promotion_name`	`string`	No	Saldi estivi	Il nome della promozione associata all'articolo. Se impostato, il criterio `promotion_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_name` a livello di evento, se presente.
`quantity`	`number`	No	3	Quantità articolo. Se non viene configurato, `quantity` è impostato su 1.

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

Invia evento

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_shipping_info",
      "params": {
        "currency": "USD",
        "value": 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 al carrello per l'acquisto.

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`currency`	`string`	Sì*	€	Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti `value`, `currency` è necessario per calcolare accuratamente le metriche relative alle entrate.
`value`	`number`	Sì*	30,03	Il valore monetario dell'evento. * Imposta `value` sulla somma di `(price * quantity)` per tutti gli elementi in `items`. Non includere `shipping` o `tax`. * `value` è in genere necessaria per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare `value`. * `currency` è obbligatorio se imposti `value`.
`items`	`Array<Item>`	Yes		Gli articoli dell'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`item_id`	`string`	Sì*	SKU_12345	L'ID dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`item_name`	`string`	Sì*	Maglietta Stan and Friends	Il nome dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`affiliation`	`string`	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`creative_name`	`string`	No	summer_banner2	Il nome della creatività promozionale. Se impostato, il criterio `creative_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_name` a livello di evento, se presente.
`creative_slot`	`string`	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio `creative_slot` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_slot` a livello di evento, se presente.
`discount`	`number`	No	2,22	Valore dello sconto monetario 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	Manica corta	La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
`item_list_id`	`string`	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_id` a livello di evento, se presente.
`item_list_name`	`string`	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_name` a livello di evento, se presente.
`item_variant`	`string`	No	verde	La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco)	La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
`price`	`number`	No	10,01	Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato. Se all'articolo viene applicato 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 associata all'articolo. Se impostato, il criterio `promotion_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_id` a livello di evento, se presente.
`promotion_name`	`string`	No	Saldi estivi	Il nome della promozione associata all'articolo. Se impostato, il criterio `promotion_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_name` a livello di evento, se presente.
`quantity`	`number`	No	3	Quantità articolo. Se non viene configurato, `quantity` è impostato su 1.

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

Invia evento

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_cart",
      "params": {
        "currency": "USD",
        "value": 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 articolo è stato aggiunto a una lista desideri. Utilizza questo evento per identificare gli articoli regalo popolari nella tua app.

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`currency`	`string`	Sì*	€	Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti `value`, `currency` è necessario per calcolare accuratamente le metriche relative alle entrate.
`value`	`number`	Sì*	30,03	Il valore monetario dell'evento. * Imposta `value` sulla somma di `(price * quantity)` per tutti gli elementi in `items`. Non includere `shipping` o `tax`. * `value` è in genere necessaria per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare `value`. * `currency` è obbligatorio se imposti `value`.
`items`	`Array<Item>`	Yes		Gli articoli dell'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`item_id`	`string`	Sì*	SKU_12345	L'ID dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`item_name`	`string`	Sì*	Maglietta Stan and Friends	Il nome dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`affiliation`	`string`	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`creative_name`	`string`	No	summer_banner2	Il nome della creatività promozionale. Se impostato, il criterio `creative_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_name` a livello di evento, se presente.
`creative_slot`	`string`	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio `creative_slot` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_slot` a livello di evento, se presente.
`discount`	`number`	No	2,22	Valore dello sconto monetario 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	Manica corta	La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
`item_list_id`	`string`	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_id` a livello di evento, se presente.
`item_list_name`	`string`	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_name` a livello di evento, se presente.
`item_variant`	`string`	No	verde	La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco)	La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
`price`	`number`	No	10,01	Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato. Se all'articolo viene applicato 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 associata all'articolo. Se impostato, il criterio `promotion_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_id` a livello di evento, se presente.
`promotion_name`	`string`	No	Saldi estivi	Il nome della promozione associata all'articolo. Se impostato, il criterio `promotion_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_name` a livello di evento, se presente.
`quantity`	`number`	No	3	Quantità articolo. Se non viene configurato, `quantity` è impostato su 1.

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

Invia evento

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_wishlist",
      "params": {
        "currency": "USD",
        "value": 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

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`currency`	`string`	Sì*	€	Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti `value`, `currency` è necessario per calcolare accuratamente le metriche relative alle entrate.
`value`	`number`	Sì*	30,03	Il valore monetario dell'evento. * Imposta `value` sulla somma di `(price * quantity)` per tutti gli elementi in `items`. Non includere `shipping` o `tax`. * `value` è in genere necessaria per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare `value`. * `currency` è obbligatorio se imposti `value`.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'evento. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`items`	`Array<Item>`	Yes		Gli articoli dell'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`item_id`	`string`	Sì*	SKU_12345	L'ID dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`item_name`	`string`	Sì*	Maglietta Stan and Friends	Il nome dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`affiliation`	`string`	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`creative_name`	`string`	No	summer_banner2	Il nome della creatività promozionale. Se impostato, il criterio `creative_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_name` a livello di evento, se presente.
`creative_slot`	`string`	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio `creative_slot` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_slot` a livello di evento, se presente.
`discount`	`number`	No	2,22	Valore dello sconto monetario 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	Manica corta	La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
`item_list_id`	`string`	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_id` a livello di evento, se presente.
`item_list_name`	`string`	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_name` a livello di evento, se presente.
`item_variant`	`string`	No	verde	La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco)	La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
`price`	`number`	No	10,01	Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato. Se all'articolo viene applicato 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 associata all'articolo. Se impostato, il criterio `promotion_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_id` a livello di evento, se presente.
`promotion_name`	`string`	No	Saldi estivi	Il nome della promozione associata all'articolo. Se impostato, il criterio `promotion_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_name` a livello di evento, se presente.
`quantity`	`number`	No	3	Quantità articolo. Se non viene configurato, `quantity` è impostato su 1.

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

Invia evento

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

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


fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "begin_checkout",
      "params": {
        "currency": "USD",
        "value": 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 i dettagli della campagna da applicare a eventi futuri.

Parametri

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

Invia evento

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

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

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

earn_virtual_currency

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

Parametri

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

Invia evento

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

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

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

generate_lead

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`currency`	`string`	Sì*	€	Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti `value`, `currency` è necessario per calcolare accuratamente le metriche relative alle entrate.
`value`	`number`	Sì*	30,03	Il valore monetario dell'evento. * Imposta `value` sulla somma di `(price * quantity)` per tutti gli elementi in `items`. Non includere `shipping` o `tax`. * `value` è in genere necessaria per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare `value`. * `currency` è obbligatorio se imposti `value`.

Invia evento

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

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

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

join_group

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

Parametri

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

Invia evento

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

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

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

level_up

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

Parametri

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

Invia evento

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

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

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

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

Parametri

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

Invia evento

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

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

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

post_score

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

Parametri

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

Invia evento

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

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

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

purchase

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`currency`	`string`	Sì*	€	Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti `value`, `currency` è necessario per calcolare accuratamente le metriche relative alle entrate.
`value`	`number`	Sì*	30,03	Il valore monetario dell'evento. * Imposta `value` sulla somma di `(price * quantity)` per tutti gli elementi in `items`. Non includere `shipping` o `tax`. * `value` è in genere necessaria per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare `value`. * `currency` è obbligatorio se imposti `value`.
`transaction_id`	`string`	Yes	T_12345	L'identificatore univoco di una transazione. Il parametro `transaction_id` ti consente di evitare di ricevere eventi duplicati per un acquisto.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'evento. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`shipping`	`number`	No	3,33	Costo di spedizione associato a una transazione.
`tax`	`number`	No	1.11	Oneri fiscali associati a una transazione.
`items`	`Array<Item>`	Yes		Gli articoli dell'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`item_id`	`string`	Sì*	SKU_12345	L'ID dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`item_name`	`string`	Sì*	Maglietta Stan and Friends	Il nome dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`affiliation`	`string`	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`creative_name`	`string`	No	summer_banner2	Il nome della creatività promozionale. Se impostato, il criterio `creative_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_name` a livello di evento, se presente.
`creative_slot`	`string`	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio `creative_slot` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_slot` a livello di evento, se presente.
`discount`	`number`	No	2,22	Valore dello sconto monetario 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	Manica corta	La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
`item_list_id`	`string`	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_id` a livello di evento, se presente.
`item_list_name`	`string`	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_name` a livello di evento, se presente.
`item_variant`	`string`	No	verde	La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco)	La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
`price`	`number`	No	10,01	Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato. Se all'articolo viene applicato 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 associata all'articolo. Se impostato, il criterio `promotion_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_id` a livello di evento, se presente.
`promotion_name`	`string`	No	Saldi estivi	Il nome della promozione associata all'articolo. Se impostato, il criterio `promotion_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_name` a livello di evento, se presente.
`quantity`	`number`	No	3	Quantità articolo. Se non viene configurato, `quantity` è impostato su 1.

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

Invia evento

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

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

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

refund

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`currency`	`string`	Sì*	€	Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti `value`, `currency` è necessario per calcolare accuratamente le metriche relative alle entrate.
`transaction_id`	`string`	Yes	T_12345	L'identificatore univoco di una transazione.
`value`	`number`	Sì*	30,03	Il valore monetario dell'evento. * Imposta `value` sulla somma di `(price * quantity)` per tutti gli elementi in `items`. Non includere `shipping` o `tax`. * `value` è in genere necessaria per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare `value`. * `currency` è obbligatorio se imposti `value`.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'evento. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`shipping`	`number`	No	3,33	Costo di spedizione associato a una transazione.
`tax`	`number`	No	1.11	Oneri fiscali associati a una transazione.
`items`	`Array<Item>`	No*		Gli articoli dell'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`item_id`	`string`	Sì*	SKU_12345	L'ID dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`item_name`	`string`	Sì*	Maglietta Stan and Friends	Il nome dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`affiliation`	`string`	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`creative_name`	`string`	No	summer_banner2	Il nome della creatività promozionale. Se impostato, il criterio `creative_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_name` a livello di evento, se presente.
`creative_slot`	`string`	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio `creative_slot` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_slot` a livello di evento, se presente.
`discount`	`number`	No	2,22	Valore dello sconto monetario 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	Manica corta	La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
`item_list_id`	`string`	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_id` a livello di evento, se presente.
`item_list_name`	`string`	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_name` a livello di evento, se presente.
`item_variant`	`string`	No	verde	La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco)	La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
`price`	`number`	No	10,01	Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato. Se all'articolo viene applicato 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 associata all'articolo. Se impostato, il criterio `promotion_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_id` a livello di evento, se presente.
`promotion_name`	`string`	No	Saldi estivi	Il nome della promozione associata all'articolo. Se impostato, il criterio `promotion_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_name` a livello di evento, se presente.
`quantity`	`number`	No	3	Quantità articolo. Se non viene configurato, `quantity` è impostato su 1.

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

Invia evento

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 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

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`currency`	`string`	Sì*	€	Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti `value`, `currency` è necessario per calcolare accuratamente le metriche relative alle entrate.
`value`	`number`	Sì*	30,03	Il valore monetario dell'evento. * Imposta `value` sulla somma di `(price * quantity)` per tutti gli elementi in `items`. Non includere `shipping` o `tax`. * `value` è in genere necessaria per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare `value`. * `currency` è obbligatorio se imposti `value`.
`items`	`Array<Item>`	Yes		Gli articoli dell'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`item_id`	`string`	Sì*	SKU_12345	L'ID dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`item_name`	`string`	Sì*	Maglietta Stan and Friends	Il nome dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`affiliation`	`string`	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`creative_name`	`string`	No	summer_banner2	Il nome della creatività promozionale. Se impostato, il criterio `creative_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_name` a livello di evento, se presente.
`creative_slot`	`string`	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio `creative_slot` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_slot` a livello di evento, se presente.
`discount`	`number`	No	2,22	Valore dello sconto monetario 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	Manica corta	La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
`item_list_id`	`string`	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_id` a livello di evento, se presente.
`item_list_name`	`string`	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_name` a livello di evento, se presente.
`item_variant`	`string`	No	verde	La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco)	La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
`price`	`number`	No	10,01	Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato. Se all'articolo viene applicato 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 associata all'articolo. Se impostato, il criterio `promotion_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_id` a livello di evento, se presente.
`promotion_name`	`string`	No	Saldi estivi	Il nome della promozione associata all'articolo. Se impostato, il criterio `promotion_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_name` a livello di evento, se presente.
`quantity`	`number`	No	3	Quantità articolo. Se non viene configurato, `quantity` è impostato su 1.

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

Invia evento

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

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

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "remove_from_cart",
      "params": {
        "currency": "USD",
        "value": 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	Obbligatorio	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 nello strumento per la creazione di eventi di GA4

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

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

search

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

Parametri

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

Invia evento

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

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

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

select_content

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

Parametri

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

Invia evento

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

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

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

select_item

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`item_list_id`	`string`	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Ignorata se impostata a livello di articolo.
`item_list_name`	`string`	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Ignorata se impostata a livello di articolo.
`items`	`Array<Item>`	Sì*		Gli articoli dell'evento. * L'array `items` dovrebbe avere un singolo elemento, che rappresenta l'elemento selezionato. Se vengono forniti più elementi, verrà utilizzato solo il primo elemento in `items`.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`item_id`	`string`	Sì*	SKU_12345	L'ID dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`item_name`	`string`	Sì*	Maglietta Stan and Friends	Il nome dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`affiliation`	`string`	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`creative_name`	`string`	No	summer_banner2	Il nome della creatività promozionale. Se impostato, il criterio `creative_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_name` a livello di evento, se presente.
`creative_slot`	`string`	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio `creative_slot` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_slot` a livello di evento, se presente.
`discount`	`number`	No	2,22	Valore dello sconto monetario 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	Manica corta	La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
`item_list_id`	`string`	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_id` a livello di evento, se presente.
`item_list_name`	`string`	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_name` a livello di evento, se presente.
`item_variant`	`string`	No	verde	La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco)	La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
`price`	`number`	No	10,01	Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato. Se all'articolo viene applicato 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 associata all'articolo. Se impostato, il criterio `promotion_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_id` a livello di evento, se presente.
`promotion_name`	`string`	No	Saldi estivi	Il nome della promozione associata all'articolo. Se impostato, il criterio `promotion_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_name` a livello di evento, se presente.
`quantity`	`number`	No	3	Quantità articolo. Se non viene configurato, `quantity` è impostato su 1.

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

Invia evento

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

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

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

select_promotion

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`creative_name`	`string`	No	summer_banner2	Il nome della creatività promozionale. Ignorata se impostata a livello di articolo.
`creative_slot`	`string`	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'evento. Ignorata se impostata a livello di articolo.
`promotion_id`	`string`	No	P_12345	L'ID della promozione associata all'evento. Ignorata se impostata a livello di articolo.
`promotion_name`	`string`	No	Saldi estivi	Il nome della promozione associata all'evento. Ignorata se impostata a livello di articolo.
`items`	`Array<Item>`	No		Gli articoli dell'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`item_id`	`string`	Sì*	SKU_12345	L'ID dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`item_name`	`string`	Sì*	Maglietta Stan and Friends	Il nome dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`affiliation`	`string`	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`creative_name`	`string`	No	summer_banner2	Il nome della creatività promozionale. Se impostato, il criterio `creative_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_name` a livello di evento, se presente.
`creative_slot`	`string`	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio `creative_slot` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_slot` a livello di evento, se presente.
`discount`	`number`	No	2,22	Valore dello sconto monetario 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	Manica corta	La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
`item_list_id`	`string`	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_id` a livello di evento, se presente.
`item_list_name`	`string`	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_name` a livello di evento, se presente.
`item_variant`	`string`	No	verde	La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco)	La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
`price`	`number`	No	10,01	Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato. Se all'articolo viene applicato 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 associata all'articolo. Se impostato, il criterio `promotion_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_id` a livello di evento, se presente.
`promotion_name`	`string`	No	Saldi estivi	Il nome della promozione associata all'articolo. Se impostato, il criterio `promotion_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_name` a livello di evento, se presente.
`quantity`	`number`	No	3	Quantità articolo. Se non viene configurato, `quantity` è impostato su 1.

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

Invia evento

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

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

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

Utilizza questo evento quando un utente ha condiviso contenuti.

Parametri

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

Invia evento

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

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

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

sign_up

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

Parametri

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

Invia evento

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

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

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

spend_virtual_currency

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

Parametri

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

Invia evento

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

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

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

tutorial_begin

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

Parametri

Nessun parametro suggerito per questo evento.

Nessun parametro per questo evento.

Invia evento

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

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

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

tutorial_complete

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

Parametri

Nessun parametro suggerito per questo evento.

Invia evento

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

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

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

unlock_achievement

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

Parametri

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

Invia evento

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

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

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

view_cart

Questo evento indica che un utente ha visualizzato il carrello.

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`currency`	`string`	Sì*	€	Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti `value`, `currency` è necessario per calcolare accuratamente le metriche relative alle entrate.
`value`	`number`	Sì*	30,03	Il valore monetario dell'evento. * Imposta `value` sulla somma di `(price * quantity)` per tutti gli elementi in `items`. Non includere `shipping` o `tax`. * `value` è in genere necessaria per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare `value`. * `currency` è obbligatorio se imposti `value`.
`items`	`Array<Item>`	Yes		Gli articoli dell'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`item_id`	`string`	Sì*	SKU_12345	L'ID dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`item_name`	`string`	Sì*	Maglietta Stan and Friends	Il nome dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`affiliation`	`string`	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`creative_name`	`string`	No	summer_banner2	Il nome della creatività promozionale. Se impostato, il criterio `creative_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_name` a livello di evento, se presente.
`creative_slot`	`string`	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio `creative_slot` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_slot` a livello di evento, se presente.
`discount`	`number`	No	2,22	Valore dello sconto monetario 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	Manica corta	La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
`item_list_id`	`string`	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_id` a livello di evento, se presente.
`item_list_name`	`string`	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_name` a livello di evento, se presente.
`item_variant`	`string`	No	verde	La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco)	La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
`price`	`number`	No	10,01	Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato. Se all'articolo viene applicato 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 associata all'articolo. Se impostato, il criterio `promotion_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_id` a livello di evento, se presente.
`promotion_name`	`string`	No	Saldi estivi	Il nome della promozione associata all'articolo. Se impostato, il criterio `promotion_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_name` a livello di evento, se presente.
`quantity`	`number`	No	3	Quantità articolo. Se non viene configurato, `quantity` è impostato su 1.

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

Invia evento

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

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

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

view_item

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`currency`	`string`	Sì*	€	Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti `value`, `currency` è necessario per calcolare accuratamente le metriche relative alle entrate.
`value`	`number`	Sì*	30,03	Il valore monetario dell'evento. * Imposta `value` sulla somma di `(price * quantity)` per tutti gli elementi in `items`. Non includere `shipping` o `tax`. * `value` è in genere necessaria per generare report significativi. Se contrassegna l'evento come conversione, ti consigliamo di impostare `value`. * `currency` è obbligatorio se imposti `value`.
`items`	`Array<Item>`	Yes		Gli articoli dell'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`item_id`	`string`	Sì*	SKU_12345	L'ID dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`item_name`	`string`	Sì*	Maglietta Stan and Friends	Il nome dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`affiliation`	`string`	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`creative_name`	`string`	No	summer_banner2	Il nome della creatività promozionale. Se impostato, il criterio `creative_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_name` a livello di evento, se presente.
`creative_slot`	`string`	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio `creative_slot` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_slot` a livello di evento, se presente.
`discount`	`number`	No	2,22	Valore dello sconto monetario 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	Manica corta	La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
`item_list_id`	`string`	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_id` a livello di evento, se presente.
`item_list_name`	`string`	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_name` a livello di evento, se presente.
`item_variant`	`string`	No	verde	La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco)	La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
`price`	`number`	No	10,01	Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato. Se all'articolo viene applicato 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 associata all'articolo. Se impostato, il criterio `promotion_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_id` a livello di evento, se presente.
`promotion_name`	`string`	No	Saldi estivi	Il nome della promozione associata all'articolo. Se impostato, il criterio `promotion_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_name` a livello di evento, se presente.
`quantity`	`number`	No	3	Quantità articolo. Se non viene configurato, `quantity` è impostato su 1.

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

Invia evento

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

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

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

view_item_list

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`item_list_id`	`string`	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Ignorata se impostata a livello di articolo.
`item_list_name`	`string`	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Ignorata se impostata a livello di articolo.
`items`	`Array<Item>`	Yes		Gli articoli dell'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`item_id`	`string`	Sì*	SKU_12345	L'ID dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`item_name`	`string`	Sì*	Maglietta Stan and Friends	Il nome dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`affiliation`	`string`	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`creative_name`	`string`	No	summer_banner2	Il nome della creatività promozionale. Se impostato, il criterio `creative_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_name` a livello di evento, se presente.
`creative_slot`	`string`	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio `creative_slot` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_slot` a livello di evento, se presente.
`discount`	`number`	No	2,22	Valore dello sconto monetario 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	Manica corta	La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
`item_list_id`	`string`	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_id` a livello di evento, se presente.
`item_list_name`	`string`	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_name` a livello di evento, se presente.
`item_variant`	`string`	No	verde	La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco)	La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
`price`	`number`	No	10,01	Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato. Se all'articolo viene applicato 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 associata all'articolo. Se impostato, il criterio `promotion_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_id` a livello di evento, se presente.
`promotion_name`	`string`	No	Saldi estivi	Il nome della promozione associata all'articolo. Se impostato, il criterio `promotion_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_name` a livello di evento, se presente.
`quantity`	`number`	No	3	Quantità articolo. Se non viene configurato, `quantity` è impostato su 1.

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

Invia evento

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

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

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

view_promotion

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`creative_name`	`string`	No	summer_banner2	Il nome della creatività promozionale. Ignorata se impostata a livello di articolo.
`creative_slot`	`string`	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'evento. Ignorata se impostata a livello di articolo.
`promotion_id`	`string`	No	P_12345	L'ID della promozione associata all'evento. Ignorata se impostata a livello di articolo.
`promotion_name`	`string`	No	Saldi estivi	Il nome della promozione associata all'evento. Ignorata se impostata a livello di articolo.
`items`	`Array<Item>`	Sì*		Gli articoli dell'evento. * L'array `items` dovrebbe avere un singolo elemento, che rappresenta l'articolo associato alla promozione. Se vengono forniti più elementi, verrà utilizzato solo il primo elemento in `items`.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
`item_id`	`string`	Sì*	SKU_12345	L'ID dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`item_name`	`string`	Sì*	Maglietta Stan and Friends	Il nome dell'articolo. *Uno dei valori `item_id` o `item_name` è obbligatorio.
`affiliation`	`string`	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli.
`coupon`	`string`	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri `coupon` a livello di evento e di articolo sono indipendenti.
`creative_name`	`string`	No	summer_banner2	Il nome della creatività promozionale. Se impostato, il criterio `creative_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_name` a livello di evento, se presente.
`creative_slot`	`string`	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio `creative_slot` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `creative_slot` a livello di evento, se presente.
`discount`	`number`	No	2,22	Valore dello sconto monetario 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	Manica corta	La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo.
`item_list_id`	`string`	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_id` a livello di evento, se presente.
`item_list_name`	`string`	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio `item_list_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `item_list_name` a livello di evento, se presente.
`item_variant`	`string`	No	verde	La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo.
`location_id`	`string`	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco)	La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli.
`price`	`number`	No	10,01	Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato. Se all'articolo viene applicato 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 associata all'articolo. Se impostato, il criterio `promotion_id` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_id` a livello di evento, se presente.
`promotion_name`	`string`	No	Saldi estivi	Il nome della promozione associata all'articolo. Se impostato, il criterio `promotion_name` a livello di evento viene ignorato. Se non viene configurato, viene utilizzato `promotion_name` a livello di evento, se presente.
`quantity`	`number`	No	3	Quantità articolo. Se non viene configurato, `quantity` è impostato su 1.

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

Invia evento

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

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

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

view_search_results

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

Parametri

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

Invia evento

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

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

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

Eventi

ad_impression

Parametri

Invia evento

add_payment_info

Parametri

Parametri degli elementi

Invia evento

add_shipping_info

Parametri

Parametri degli elementi

Invia evento

add_to_cart

Parametri

Parametri degli elementi

Invia evento

add_to_wishlist

Parametri

Parametri degli elementi

Invia evento

begin_checkout

Parametri

Parametri degli elementi

Invia evento

campaign_details

Parametri

Invia evento

earn_virtual_currency

Parametri

Invia evento

generate_lead

Parametri

Invia evento

join_group

Parametri

Invia evento

level_up

Parametri

Invia evento

accedere

Parametri

Invia evento

post_score

Parametri

Invia evento

purchase

Parametri

Parametri degli elementi

Invia evento

refund

Parametri

Parametri degli elementi

Invia evento

remove_from_cart

Parametri

Parametri degli elementi

Invia evento

screen_view

Parametri

Invia evento

search

Parametri

Invia evento

select_content

Parametri

Invia evento

select_item

Parametri

Parametri degli elementi

Invia evento

select_promotion

Parametri

Parametri degli elementi

Invia evento

condivisione

Parametri

Invia evento

sign_up

Parametri

Invia evento