Eventi consigliati

Google Analytics invia alcuni tipi di eventi automaticamente. Questa pagina descrive eventi facoltativi aggiuntivi che puoi configurare per misurare più comportamenti e generare report più utili per la tua attività. Questi eventi aggiuntivi richiedono un maggiore impegno per la configurazione prima di poterli utilizzare, pertanto Google Analytics 4 non può inviarli automaticamente. Per istruzioni dettagliate su come configurare gli eventi consigliati e personalizzati per il tuo sito web o la tua app, consulta Configurare gli eventi.

Per visualizzare i dettagli di ciascun evento che puoi utilizzare, seleziona la tua piattaforma di gestione dei tag:

gtag.js Tag Manager Firebase

add_payment_info

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
currency	string	Sì*	USD	Valuta degli articoli associati all'evento, nel formato ISO 4217 a tre lettere. Attribuisci alle metriche relative al valore dell'evento view_item il valore non contribuendo alle entrate * Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value	number	Sì*	30,03	Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax. * value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, 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>	Sì		Gli articoli per l'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
item_id	string	Sì*	SKU_12345	ID dell'articolo. *È obbligatorio uno tra item_id e item_name.
item_name	string	Sì*	T-shirt Stan and Friends	Il nome dell'articolo. *È obbligatorio uno tra item_id e item_name.
affiliation	string	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: "affiliation" è disponibile solo a livello di ambito dell'elemento.
coupon	string	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono indipendenti.
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 all'interno di una gerarchia o di una tassonomia delle categorie, 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, item_list_id a livello di evento viene ignorato. Se non è impostato, 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, item_list_name a livello di evento viene ignorato. Se non è impostato, 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 dettagli/opzioni dell'articolo.
location_id	string	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID posizione Google per San Francisco)	La sede fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo di Google corrispondente all'articolo associato. È possibile utilizzare anche un ID posizione personalizzato. Nota: "location id" è disponibile solo a livello di ambito dell'articolo.
price	number	No	10,01	Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato. Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
quantity	number	No	3	Quantità articolo. Se non impostato, quantity viene impostato su 1.

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "add_payment_info", {
  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",
      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 di e-commerce.

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
currency	string	Sì*	USD	Valuta degli articoli associati all'evento, nel formato ISO 4217 a tre lettere. Attribuisci alle metriche relative al valore dell'evento view_item il valore non contribuendo alle entrate * Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value	number	Sì*	30,03	Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax. * value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, 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	Suolo	Il livello di spedizione (ad es. Ground, Air, Next-day) selezionato per la consegna dell'articolo acquistato.
items	Array<Item>	Sì		Gli articoli per l'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
item_id	string	Sì*	SKU_12345	ID dell'articolo. *È obbligatorio uno tra item_id e item_name.
item_name	string	Sì*	T-shirt Stan and Friends	Il nome dell'articolo. *È obbligatorio uno tra item_id e item_name.
affiliation	string	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: "affiliation" è disponibile solo a livello di ambito dell'elemento.
coupon	string	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono indipendenti.
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 all'interno di una gerarchia o di una tassonomia delle categorie, 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, item_list_id a livello di evento viene ignorato. Se non è impostato, 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, item_list_name a livello di evento viene ignorato. Se non è impostato, 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 dettagli/opzioni dell'articolo.
location_id	string	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID posizione Google per San Francisco)	La sede fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo di Google corrispondente all'articolo associato. È possibile utilizzare anche un ID posizione personalizzato. Nota: "location id" è disponibile solo a livello di ambito dell'articolo.
price	number	No	10,01	Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato. Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
quantity	number	No	3	Quantità articolo. Se non impostato, quantity viene impostato su 1.

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "add_shipping_info", {
  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",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ]
});

add_to_cart

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

Parametri

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

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
item_id	string	Sì*	SKU_12345	ID dell'articolo. *È obbligatorio uno tra item_id e item_name.
item_name	string	Sì*	T-shirt Stan and Friends	Il nome dell'articolo. *È obbligatorio uno tra item_id e item_name.
affiliation	string	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: "affiliation" è disponibile solo a livello di ambito dell'elemento.
coupon	string	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono indipendenti.
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 all'interno di una gerarchia o di una tassonomia delle categorie, 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, item_list_id a livello di evento viene ignorato. Se non è impostato, 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, item_list_name a livello di evento viene ignorato. Se non è impostato, 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 dettagli/opzioni dell'articolo.
location_id	string	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID posizione Google per San Francisco)	La sede fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo di Google corrispondente all'articolo associato. È possibile utilizzare anche un ID posizione personalizzato. Nota: "location id" è disponibile solo a livello di ambito dell'articolo.
price	number	No	10,01	Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato. Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
quantity	number	No	3	Quantità articolo. Se non impostato, quantity viene impostato su 1.

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "add_to_cart", {
  currency: "USD",
  value: 30.03,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      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 da regalo più apprezzati nella tua app.

Parametri

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

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
item_id	string	Sì*	SKU_12345	ID dell'articolo. *È obbligatorio uno tra item_id e item_name.
item_name	string	Sì*	T-shirt Stan and Friends	Il nome dell'articolo. *È obbligatorio uno tra item_id e item_name.
affiliation	string	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: "affiliation" è disponibile solo a livello di ambito dell'elemento.
coupon	string	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono indipendenti.
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 all'interno di una gerarchia o di una tassonomia delle categorie, 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, item_list_id a livello di evento viene ignorato. Se non è impostato, 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, item_list_name a livello di evento viene ignorato. Se non è impostato, 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 dettagli/opzioni dell'articolo.
location_id	string	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID posizione Google per San Francisco)	La sede fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo di Google corrispondente all'articolo associato. È possibile utilizzare anche un ID posizione personalizzato. Nota: "location id" è disponibile solo a livello di ambito dell'articolo.
price	number	No	10,01	Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato. Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
quantity	number	No	3	Quantità articolo. Se non impostato, quantity viene impostato su 1.

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "add_to_wishlist", {
  currency: "USD",
  value: 30.03,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      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 iniziato la procedura di pagamento.

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
currency	string	Sì*	USD	Valuta degli articoli associati all'evento, nel formato ISO 4217 a tre lettere. Attribuisci alle metriche relative al valore dell'evento view_item il valore non contribuendo alle entrate * Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value	number	Sì*	30,03	Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax. * value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, 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>	Sì		Gli articoli per l'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
item_id	string	Sì*	SKU_12345	ID dell'articolo. *È obbligatorio uno tra item_id e item_name.
item_name	string	Sì*	T-shirt Stan and Friends	Il nome dell'articolo. *È obbligatorio uno tra item_id e item_name.
affiliation	string	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: "affiliation" è disponibile solo a livello di ambito dell'elemento.
coupon	string	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono indipendenti.
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 all'interno di una gerarchia o di una tassonomia delle categorie, 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, item_list_id a livello di evento viene ignorato. Se non è impostato, 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, item_list_name a livello di evento viene ignorato. Se non è impostato, 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 dettagli/opzioni dell'articolo.
location_id	string	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID posizione Google per San Francisco)	La sede fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo di Google corrispondente all'articolo associato. È possibile utilizzare anche un ID posizione personalizzato. Nota: "location id" è disponibile solo a livello di ambito dell'articolo.
price	number	No	10,01	Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato. Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
quantity	number	No	3	Quantità articolo. Se non impostato, quantity viene impostato su 1.

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "begin_checkout", {
  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",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ]
});

close_convert_lead

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
currency	string	Sì*	USD	Valuta del value dell'evento, in formato ISO 4217 a tre lettere. * Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value	number	Sì*	30,03	Il valore monetario dell'evento. * value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare value. * currency è obbligatorio se imposti value.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "close_convert_lead", {
  currency: "USD",
  value: 30.03
});

close_unconvert_lead

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
currency	string	Sì*	USD	Valuta del value dell'evento, in formato ISO 4217 a tre lettere. * Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value	number	Sì*	30,03	Il valore monetario dell'evento. * value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare value. * currency è obbligatorio se imposti value.
unconvert_lead_reason	string	No	Non ha risposto	Il motivo per cui la richiesta non è stata convertita.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "close_unconvert_lead", {
  currency: "USD",
  value: 30.03,
  unconvert_lead_reason: "Never responded"
});

disqualify_lead

Questo evento misura quando un utente viene contrassegnato come non idoneo a diventare un lead, insieme al motivo della disqualificazione.

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
currency	string	Sì*	USD	Valuta del value dell'evento, in formato ISO 4217 a tre lettere. * Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value	number	Sì*	30,03	Il valore monetario dell'evento. * value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare value. * currency è obbligatorio se imposti value.
disqualified_lead_reason	string	No	Non voglio acquistare	Il motivo per cui un lead è stato contrassegnato come non idoneo.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "disqualify_lead", {
  currency: "USD",
  value: 30.03,
  disqualified_lead_reason: "Not looking to buy"
});

earn_virtual_currency

Questo evento misura quando a un utente viene assegnata valuta virtuale in un gioco. Registra questo evento 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.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "earn_virtual_currency", {
  virtual_currency_name: "Gems",
  value: 5
});

generate_lead

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
currency	string	Sì*	USD	Valuta del value dell'evento, in formato ISO 4217 a tre lettere. * Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value	number	Sì*	30,03	Il valore monetario dell'evento. * value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare value. * currency è obbligatorio se imposti value.
lead_source	string	No	Fiera	L'origine del lead.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "generate_lead", {
  currency: "USD",
  value: 30.03,
  lead_source: "Trade show"
});

join_group

Registra questo evento quando un utente si iscrive a un gruppo, ad esempio una corporazione, un team o una famiglia. Utilizza 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.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "join_group", {
  group_id: "G_12345"
});

level_end

Questo evento indica che un giocatore ha raggiunto la fine di un livello in un gioco.

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
level_name	string	No	Il viaggio ha inizio…	Il nome del livello.
success	boolean	No	true	Imposta su true se il livello è stato completato correttamente.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "level_end", {
  level_name: "The journey begins...",
  success: true
});

level_start

Questo evento indica che un giocatore ha iniziato un livello in un gioco.

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
level_name	string	No	Il viaggio ha inizio…	Il nome del livello.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "level_start", {
  level_name: "The journey begins..."
});

level_up

Questo evento indica che un giocatore ha raggiunto un nuovo livello in un gioco. Utilizzalo per valutare la distribuzione dei livelli della tua base utenti e identificare i livelli difficili da completare.

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
level	number	No	5	Il livello del personaggio.
character	string	No	Giocatore 1	Il personaggio che ha raggiunto un nuovo livello.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "level_up", {
  level: 5,
  character: "Player 1"
});

login

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.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "login", {
  method: "Google"
});

post_score

Invia questo evento quando l'utente pubblica un punteggio. Utilizza questo evento per capire 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	Sì	10000	Il punteggio da pubblicare.
level	number	No	5	Il livello del punteggio.
character	string	No	Giocatore 1	Il carattere che ha ottenuto il punteggio.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "post_score", {
  score: 10000,
  level: 5,
  character: "Player 1"
});

purchase

Questo evento indica quando uno o più articoli vengono acquistati da un utente.

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
currency	string	Sì*	USD	Valuta degli articoli associati all'evento, nel formato ISO 4217 a tre lettere. Attribuisci alle metriche relative al valore dell'evento view_item il valore non contribuendo alle entrate * Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value	number	Sì*	30,03	Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax. * value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare value. * currency è obbligatorio se imposti value.
transaction_id	string	Sì	T_12345	L'identificatore univoco di una transazione. Il parametro transaction_id consente di evitare gli 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>	Sì		Gli articoli per l'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
item_id	string	Sì*	SKU_12345	ID dell'articolo. *È obbligatorio uno tra item_id e item_name.
item_name	string	Sì*	T-shirt Stan and Friends	Il nome dell'articolo. *È obbligatorio uno tra item_id e item_name.
affiliation	string	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: "affiliation" è disponibile solo a livello di ambito dell'elemento.
coupon	string	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono indipendenti.
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 all'interno di una gerarchia o di una tassonomia delle categorie, 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, item_list_id a livello di evento viene ignorato. Se non è impostato, 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, item_list_name a livello di evento viene ignorato. Se non è impostato, 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 dettagli/opzioni dell'articolo.
location_id	string	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID posizione Google per San Francisco)	La sede fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo di Google corrispondente all'articolo associato. È possibile utilizzare anche un ID posizione personalizzato. Nota: "location id" è disponibile solo a livello di ambito dell'articolo.
price	number	No	10,01	Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato. Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
quantity	number	No	3	Quantità articolo. Se non impostato, quantity viene impostato su 1.

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "purchase", {
    transaction_id: "T_12345",
    // Sum of (price * quantity) for all items.
    value: 72.05,
    tax: 3.60,
    shipping: 5.99,
    currency: "USD",
    coupon: "SUMMER_SALE",
    items: [
     {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      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
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      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: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
});

qualify_lead

Questo evento viene misurato quando un utente viene contrassegnato come idoneo a diventare un lead qualificato.

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
currency	string	Sì*	USD	Valuta del value dell'evento, in formato ISO 4217 a tre lettere. * Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value	number	Sì*	30,03	Il valore monetario dell'evento. * value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare value. * currency è obbligatorio se imposti value.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "qualify_lead", {
  currency: "USD",
  value: 30.03
});

refund

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

Nota: ti consigliamo di includere le informazioni sugli articoli nell'evento refund per visualizzare le metriche sui rimborsi a livello di articolo in Analytics.

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
currency	string	Sì*	USD	Valuta degli articoli associati all'evento, nel formato ISO 4217 a tre lettere. Attribuisci alle metriche relative al valore dell'evento view_item il valore non contribuendo alle entrate * Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
transaction_id	string	Sì	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 obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, 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 per l'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
item_id	string	Sì*	SKU_12345	ID dell'articolo. *È obbligatorio uno tra item_id e item_name.
item_name	string	Sì*	T-shirt Stan and Friends	Il nome dell'articolo. *È obbligatorio uno tra item_id e item_name.
affiliation	string	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: "affiliation" è disponibile solo a livello di ambito dell'elemento.
coupon	string	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono indipendenti.
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 all'interno di una gerarchia o di una tassonomia delle categorie, 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, item_list_id a livello di evento viene ignorato. Se non è impostato, 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, item_list_name a livello di evento viene ignorato. Se non è impostato, 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 dettagli/opzioni dell'articolo.
location_id	string	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID posizione Google per San Francisco)	La sede fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo di Google corrispondente all'articolo associato. È possibile utilizzare anche un ID posizione personalizzato. Nota: "location id" è disponibile solo a livello di ambito dell'articolo.
price	number	No	10,01	Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato. Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
quantity	number	No	3	Quantità articolo. Se non impostato, quantity viene impostato su 1.

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "refund", {
  currency: "USD",
  transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
  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",
      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ì*	USD	Valuta degli articoli associati all'evento, nel formato ISO 4217 a tre lettere. Attribuisci alle metriche relative al valore dell'evento view_item il valore non contribuendo alle entrate * Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value	number	Sì*	30,03	Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax. * value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare value. * currency è obbligatorio se imposti value.
items	Array<Item>	Sì		Gli articoli per l'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
item_id	string	Sì*	SKU_12345	ID dell'articolo. *È obbligatorio uno tra item_id e item_name.
item_name	string	Sì*	T-shirt Stan and Friends	Il nome dell'articolo. *È obbligatorio uno tra item_id e item_name.
affiliation	string	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: "affiliation" è disponibile solo a livello di ambito dell'elemento.
coupon	string	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono indipendenti.
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 all'interno di una gerarchia o di una tassonomia delle categorie, 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, item_list_id a livello di evento viene ignorato. Se non è impostato, 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, item_list_name a livello di evento viene ignorato. Se non è impostato, 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 dettagli/opzioni dell'articolo.
location_id	string	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID posizione Google per San Francisco)	La sede fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo di Google corrispondente all'articolo associato. È possibile utilizzare anche un ID posizione personalizzato. Nota: "location id" è disponibile solo a livello di ambito dell'articolo.
price	number	No	10,01	Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato. Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
quantity	number	No	3	Quantità articolo. Se non impostato, quantity viene impostato su 1.

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "remove_from_cart", {
  currency: "USD",
  value: 30.03,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      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
    }
  ]
});

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	Sì	t-shirt	Termine cercato.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "search", {
  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 e categorie di contenuti popolari 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	Un identificatore dei contenuti selezionati.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "select_content", {
  content_type: "product",
  content_id: "C_12345"
});

select_item

Questo evento indica che un elemento è 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. Ignorato se impostato a livello di articolo.
item_list_name	string	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Ignorato se impostato a livello di articolo.
items	Array<Item>	Sì*		Gli articoli per l'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	ID dell'articolo. *È obbligatorio uno tra item_id e item_name.
item_name	string	Sì*	T-shirt Stan and Friends	Il nome dell'articolo. *È obbligatorio uno tra item_id e item_name.
affiliation	string	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: "affiliation" è disponibile solo a livello di ambito dell'elemento.
coupon	string	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono indipendenti.
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 all'interno di una gerarchia o di una tassonomia delle categorie, 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, item_list_id a livello di evento viene ignorato. Se non è impostato, 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, item_list_name a livello di evento viene ignorato. Se non è impostato, 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 dettagli/opzioni dell'articolo.
location_id	string	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID posizione Google per San Francisco)	La sede fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo di Google corrispondente all'articolo associato. È possibile utilizzare anche un ID posizione personalizzato. Nota: "location id" è disponibile solo a livello di ambito dell'articolo.
price	number	No	10,01	Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato. Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
quantity	number	No	3	Quantità articolo. Se non impostato, quantity viene impostato su 1.

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "select_item", {
  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",
      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. Ignorato se impostato a livello di articolo.
creative_slot	string	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'evento. Ignorato se impostato a livello di articolo.
promotion_id	string	No	P_12345	L'ID della promozione associata all'evento. Ignorato se impostato a livello di articolo.
promotion_name	string	No	Saldi estivi	Il nome della promozione associata all'evento. Ignorato se impostato a livello di articolo.
items	Array<Item>	No		Gli articoli per l'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
item_id	string	Sì*	SKU_12345	ID dell'articolo. *È obbligatorio uno tra item_id e item_name.
item_name	string	Sì*	T-shirt Stan and Friends	Il nome dell'articolo. *È obbligatorio uno tra item_id e item_name.
affiliation	string	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: "affiliation" è disponibile solo a livello di ambito dell'elemento.
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, creative_name a livello di evento viene ignorato. Se non è impostato, 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'elemento. Se impostato, creative_slot a livello di evento viene ignorato. Se non è impostato, 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 all'interno di una gerarchia o di una tassonomia delle categorie, 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, item_list_id a livello di evento viene ignorato. Se non è impostato, 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, item_list_name a livello di evento viene ignorato. Se non è impostato, 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 dettagli/opzioni dell'articolo.
location_id	string	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID posizione Google per San Francisco)	La sede fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo di Google corrispondente all'articolo associato. È possibile utilizzare anche un ID posizione personalizzato. Nota: "location id" è disponibile solo a livello di ambito dell'articolo.
price	number	No	10,01	Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato. Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id	string	No	P_12345	L'ID della promozione associata all'articolo. Se impostato, promotion_id a livello di evento viene ignorato. Se non è impostato, 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, promotion_name a livello di evento viene ignorato. Se non è impostato, viene utilizzato promotion_name a livello di evento, se presente.
quantity	number	No	3	Quantità articolo. Se non impostato, quantity viene impostato su 1.

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "select_promotion", {
  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",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 3
    }
  ],
});

share

Utilizza questo evento quando un utente ha condiviso contenuti.

Parametri

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "share", {
  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 o la disconnessione.

Parametri

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "sign_up", {
  method: "Google"
});

spend_virtual_currency

Questo evento misura la vendita di prodotti virtuali nella tua app e ti aiuta a identificare quelli più apprezzati.

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
value	number	Sì	5	Il valore della valuta virtuale.
virtual_currency_name	string	Sì	Gem	Nome della valuta virtuale.
item_name	string	No	Starter Boost	Il nome dell'elemento per cui viene utilizzata la valuta virtuale.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "spend_virtual_currency", {
  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 insieme a tutorial_complete per capire quanti utenti completano il tutorial.

Parametri

Non sono presenti parametri per questo evento.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "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

Non sono suggeriti parametri per questo evento.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "tutorial_complete");

unlock_achievement

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

Parametri

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "unlock_achievement", {
  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ì*	USD	Valuta degli articoli associati all'evento, nel formato ISO 4217 a tre lettere. Attribuisci alle metriche relative al valore dell'evento view_item il valore non contribuendo alle entrate * Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value	number	Sì*	30,03	Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax. * value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare value. * currency è obbligatorio se imposti value.
items	Array<Item>	Sì		Gli articoli per l'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
item_id	string	Sì*	SKU_12345	ID dell'articolo. *È obbligatorio uno tra item_id e item_name.
item_name	string	Sì*	T-shirt Stan and Friends	Il nome dell'articolo. *È obbligatorio uno tra item_id e item_name.
affiliation	string	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: "affiliation" è disponibile solo a livello di ambito dell'elemento.
coupon	string	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono indipendenti.
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 all'interno di una gerarchia o di una tassonomia delle categorie, 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, item_list_id a livello di evento viene ignorato. Se non è impostato, 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, item_list_name a livello di evento viene ignorato. Se non è impostato, 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 dettagli/opzioni dell'articolo.
location_id	string	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID posizione Google per San Francisco)	La sede fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo di Google corrispondente all'articolo associato. È possibile utilizzare anche un ID posizione personalizzato. Nota: "location id" è disponibile solo a livello di ambito dell'articolo.
price	number	No	10,01	Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato. Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
quantity	number	No	3	Quantità articolo. Se non impostato, quantity viene impostato su 1.

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "view_cart", {
  currency: "USD",
  value: 30.03,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      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 elementi più popolari visualizzati.

Parametri

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

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
item_id	string	Sì*	SKU_12345	ID dell'articolo. *È obbligatorio uno tra item_id e item_name.
item_name	string	Sì*	T-shirt Stan and Friends	Il nome dell'articolo. *È obbligatorio uno tra item_id e item_name.
affiliation	string	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: "affiliation" è disponibile solo a livello di ambito dell'elemento.
coupon	string	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono indipendenti.
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 all'interno di una gerarchia o di una tassonomia delle categorie, 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, item_list_id a livello di evento viene ignorato. Se non è impostato, 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, item_list_name a livello di evento viene ignorato. Se non è impostato, 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 dettagli/opzioni dell'articolo.
location_id	string	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID posizione Google per San Francisco)	La sede fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo di Google corrispondente all'articolo associato. È possibile utilizzare anche un ID posizione personalizzato. Nota: "location id" è disponibile solo a livello di ambito dell'articolo.
price	number	No	10,01	Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato. Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
quantity	number	No	3	Quantità articolo. Se non impostato, quantity viene impostato su 1.

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "view_item", {
  currency: "USD",
  value: 30.03,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ]
});

view_item_list

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
currency	string	Sì*	USD	Valuta degli articoli associati all'evento, nel formato ISO 4217 a tre lettere. Attribuisci alle metriche relative al valore dell'evento view_item il valore non contribuendo alle entrate * Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
item_list_id	string	No	related_products	L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Ignorato se impostato a livello di articolo.
item_list_name	string	No	Prodotti correlati	Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Ignorato se impostato a livello di articolo.
items	Array<Item>	Sì		Gli articoli per l'evento.

Parametri degli elementi

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
item_id	string	Sì*	SKU_12345	ID dell'articolo. *È obbligatorio uno tra item_id e item_name.
item_name	string	Sì*	T-shirt Stan and Friends	Il nome dell'articolo. *È obbligatorio uno tra item_id e item_name.
affiliation	string	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: "affiliation" è disponibile solo a livello di ambito dell'elemento.
coupon	string	No	SUMMER_FUN	Nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono indipendenti.
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 all'interno di una gerarchia o di una tassonomia delle categorie, 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, item_list_id a livello di evento viene ignorato. Se non è impostato, 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, item_list_name a livello di evento viene ignorato. Se non è impostato, 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 dettagli/opzioni dell'articolo.
location_id	string	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID posizione Google per San Francisco)	La sede fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo di Google corrispondente all'articolo associato. È possibile utilizzare anche un ID posizione personalizzato. Nota: "location id" è disponibile solo a livello di ambito dell'articolo.
price	number	No	10,01	Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato. Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
quantity	number	No	3	Quantità articolo. Se non impostato, quantity viene impostato su 1.

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "view_item_list", {
  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",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
  ]
});

view_promotion

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
creative_name	string	No	summer_banner2	Il nome della creatività promozionale. Ignorato se impostato a livello di articolo.
creative_slot	string	No	featured_app_1	Il nome dell'area della creatività promozionale associata all'evento. Ignorato se impostato a livello di articolo.
promotion_id	string	No	P_12345	L'ID della promozione associata all'evento. Ignorato se impostato a livello di articolo.
promotion_name	string	No	Saldi estivi	Il nome della promozione associata all'evento. Ignorato se impostato a livello di articolo.
items	Array<Item>	Sì*		Gli articoli per l'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	ID dell'articolo. *È obbligatorio uno tra item_id e item_name.
item_name	string	Sì*	T-shirt Stan and Friends	Il nome dell'articolo. *È obbligatorio uno tra item_id e item_name.
affiliation	string	No	Google Store	Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: "affiliation" è disponibile solo a livello di ambito dell'elemento.
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, creative_name a livello di evento viene ignorato. Se non è impostato, 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'elemento. Se impostato, creative_slot a livello di evento viene ignorato. Se non è impostato, 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 all'interno di una gerarchia o di una tassonomia delle categorie, 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, item_list_id a livello di evento viene ignorato. Se non è impostato, 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, item_list_name a livello di evento viene ignorato. Se non è impostato, 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 dettagli/opzioni dell'articolo.
location_id	string	No	ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID posizione Google per San Francisco)	La sede fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo di Google corrispondente all'articolo associato. È possibile utilizzare anche un ID posizione personalizzato. Nota: "location id" è disponibile solo a livello di ambito dell'articolo.
price	number	No	10,01	Il prezzo unitario monetario dell'articolo, in unità del parametro valuta specificato. Se all'articolo si applica uno sconto, imposta price sul prezzo unitario scontato e specifica lo sconto sul prezzo unitario nel parametro discount.
promotion_id	string	No	P_12345	L'ID della promozione associata all'articolo. Se impostato, promotion_id a livello di evento viene ignorato. Se non è impostato, 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, promotion_name a livello di evento viene ignorato. Se non è impostato, viene utilizzato promotion_name a livello di evento, se presente.
quantity	number	No	3	Quantità articolo. Se non impostato, quantity viene impostato su 1.

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

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "view_promotion", {
  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",
      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
    }
  ]
});

working_lead

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

Parametri

Nome	Tipo	Obbligatorio	Valore di esempio	Descrizione
currency	string	Sì*	USD	Valuta del value dell'evento, in formato ISO 4217 a tre lettere. * Se imposti value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
value	number	Sì*	30,03	Il valore monetario dell'evento. * value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare value. * currency è obbligatorio se imposti value.
lead_status	string	No	Conversazioni avviate	Lo stato del lead.

Esempio

L'esempio seguente è per le implementazioni di gtag.js:

gtag("event", "working_lead", {
  currency: "USD",
  value: 30.03,
  lead_status: "Started conversations"
});