Eventi consigliati di Google Analytics

Di seguito è riportato un elenco di eventi consigliati. Puoi anche creare e inviare i tuoi eventi personalizzati.

Quando crei nomi di eventi personalizzati, devi:

  1. Segui le regole di denominazione degli eventi.
  2. Evita nomi e prefissi riservati.
  3. Rispettare i limiti di raccolta degli eventi, ad esempio il limite di 40 caratteri per i nomi di eventi e parametri.

Per maggiori dettagli, consulta la guida introduttiva.

Se stai eseguendo l'upgrade da Measurement Protocol, consulta Esegui l'upgrade da Measurement Protocol per istruzioni.

Per tutte le proprietà

ad_impression

Questo evento è disponibile solo per gli stream di app.

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

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

Campi evento

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

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

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.

Esempio

L'esempio seguente mostra come inviare un evento ad_impression utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "ad_impression",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 3.99,
      "additionalEventParameters": [
        {
          "parameterName": "ad_platform",
          "value": "MoPub"
        },
        {
          "parameterName": "ad_source",
          "value": "AdColony"
        },
        {
          "parameterName": "ad_format",
          "value": "Banner"
        },
        {
          "parameterName": "ad_unit_name",
          "value": "Banner_03"
        }
      ]
    }
  ]
}

Measurement Protocol

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({
    "app_instance_id": "app_instance_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
      }
    }]
  })
});

earn_virtual_currency

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

Campi evento

Nome Tipo Obbligatorio Valore di esempio Descrizione
conversion_value number No 5 Il valore della valuta virtuale.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
virtual_currency_name string No Gem Nome della valuta virtuale.

Esempio

L'esempio seguente mostra come inviare un evento earn_virtual_currency utilizzando l'API Data Manager. Se stai eseguendo l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "earn_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

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
      }
    }]
  })
});

join_group

Registra questo evento quando un utente entra a far parte di 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 mostra come inviare un evento join_group utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "join_group",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "group_id",
          "value": "G_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

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 l'accesso.

Esempio

L'esempio seguente mostra come inviare un evento login utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "login",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

screen_view

Questo evento è disponibile solo per gli stream di app.

Utilizza questo evento per indicare che si è verificata una transizione di schermata.

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.

Esempio

L'esempio seguente mostra come inviare un evento screen_view utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "screen_view",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "additionalEventParameters": [
        {
          "parameterName": "screen_class",
          "value": "MainActivity"
        },
        {
          "parameterName": "screen_name",
          "value": "About"
        }
      ]
    }
  ]
}

Measurement Protocol

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({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

Registra questo evento per indicare quando l'utente ha eseguito una ricerca. Puoi utilizzare questo evento per identificare ciò che gli utenti cercano sul tuo sito web o nella tua app. Ad esempio, 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 mostra come inviare un evento search utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "search",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "t-shirts"
        }
      ]
    }
  ]
}

Measurement Protocol

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

select_content

Questo evento indica che un utente ha selezionato alcuni contenuti di un determinato tipo. Questo evento può aiutarti a identificare i contenuti e le categorie di contenuti più 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. Il valore deve includere almeno un carattere non numerico.

Esempio

L'esempio seguente mostra come inviare un evento select_content utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_content",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "content_type",
          "value": "product"
        },
        {
          "parameterName": "content_id",
          "value": "C_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

share

Utilizza questo evento quando un utente ha condiviso contenuti.

Campi evento

Nome Tipo Obbligatorio Valore di esempio Descrizione
cart_data.items Item[] No Gli articoli per l'evento.

Imposta il campo cart_data.items sull'oggetto Event.

Campi articolo

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì I_12345 Un identificatore univoco dell'elemento. Imposta il campo item_id sull'oggetto Item.
unit_price number Sì 27,67 Il prezzo unitario al netto di tasse, spese di spedizione e sconti con ambito evento (a livello di transazione) per questo articolo.

Se l'articolo ha uno sconto con ambito articolo, utilizza il prezzo unitario scontato. Ad esempio, se un articolo ha un prezzo unitario di 27,67 e uno sconto unitario di 6,66, imposta unitPrice su 21,01.
quantity number Sì 1 La quantità di unità acquistate per questo articolo specifico.

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.

Esempio

L'esempio seguente mostra come inviare un evento share utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "share",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "C_12345",
            "quantity": 1,
            "unitPrice": 27.67
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Twitter"
        },
        {
          "parameterName": "content_type",
          "value": "image"
        }
      ]
    }
  ]
}

Measurement Protocol

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 registrato un account. Utilizza questo evento per comprendere i diversi comportamenti degli utenti che hanno effettuato 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 mostra come inviare un evento sign_up utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "sign_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

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

spend_virtual_currency

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

Campi evento

Nome Tipo Obbligatorio Valore di esempio Descrizione
conversion_value number Sì 5 Il valore della valuta virtuale.
cart_data.items Item[] No Gli articoli per l'evento.

Imposta il campo cart_data.items sull'oggetto Event.

Campi articolo

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì I_12345 Un identificatore univoco dell'elemento. Imposta il campo item_id sull'oggetto Item.
unit_price number Sì 27,67 Il prezzo unitario al netto di tasse, spese di spedizione e sconti con ambito evento (a livello di transazione) per questo articolo.

Se l'articolo ha uno sconto con ambito articolo, utilizza il prezzo unitario scontato. Ad esempio, se un articolo ha un prezzo unitario di 27,67 e uno sconto unitario di 6,66, imposta unitPrice su 21,01.
quantity number Sì 1 La quantità di unità acquistate per questo articolo specifico.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_name string No Starter Boost Il nome dell'elemento per cui viene utilizzata la valuta virtuale.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
virtual_currency_name string Sì Gem Nome della valuta virtuale.

Esempio

L'esempio seguente mostra come inviare un evento spend_virtual_currency utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "spend_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "I_12345",
            "quantity": 1,
            "unitPrice": 27.67,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Starter Boost"
              }
            ]
          }
        ]
      },
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

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 del processo di onboarding. Utilizza questo evento in una canalizzazione con tutorial_complete per capire quanti utenti completano il tutorial.

Parametri

Non sono suggeriti parametri per questo evento.

Esempio

L'esempio seguente mostra come inviare un evento tutorial_begin utilizzando l'API Data Manager. Se stai eseguendo l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_begin",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

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 che l'utente ha completato la procedura di onboarding. Utilizza questo evento 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 mostra come inviare un evento tutorial_complete utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_complete",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

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"
    }]
  })
});

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.

Esempio

L'esempio seguente mostra come inviare un evento view_search_results utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_search_results",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "Clothing"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

campaign_details

Utilizza questo evento per inviare i dettagli della campagna che verranno applicati agli eventi con un timestamp maggiore o uguale a quello dell'evento campaign_details.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
campaign_id string No google_1234 L'ID 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 i test A/B e gli annunci con targeting basato sui contenuti per distinguere gli annunci o i link che puntano allo stesso URL.

Esempio

L'esempio seguente mostra come inviare un evento campaign_details utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "campaign_details",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "campaign_id",
          "value": "google_1234"
        },
        {
          "parameterName": "campaign",
          "value": "Summer_fun"
        },
        {
          "parameterName": "source",
          "value": "google"
        },
        {
          "parameterName": "medium",
          "value": "cpc"
        },
        {
          "parameterName": "term",
          "value": "summer+travel"
        },
        {
          "parameterName": "content",
          "value": "logolink"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

Vendite online

add_payment_info

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

Campi evento

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

* Le metriche relative al valore dell'evento view_item non contribuiscono alle entrate

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

* Imposta conversion_value sulla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_value.
cart_data.items Item[] Sì Gli articoli per l'evento.

Imposta il campo cart_data.items sull'oggetto Event.
cart_data.coupon_codes string[] No SUMMER_FUN Il codice coupon associato all'evento.


Imposta il campo coupon_codes sull'oggetto CartData.
* Fornisci un solo codice coupon in questo elenco.
* Questo è indipendente dai codici coupon a livello di articolo.

Campi articolo

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì I_12345 Un identificatore univoco dell'elemento. Imposta il campo item_id sull'oggetto Item.
unit_price number Sì 27,67 Il prezzo unitario al netto di tasse, spese di spedizione e sconti con ambito evento (a livello di transazione) per questo articolo.

Se l'articolo ha uno sconto con ambito articolo, utilizza il prezzo unitario scontato. Ad esempio, se un articolo ha un prezzo unitario di 27,67 e uno sconto unitario di 6,66, imposta unitPrice su 21,01.
quantity number Sì 1 La quantità di unità acquistate per questo articolo specifico.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
payment_type string No Carta di credito Il metodo di pagamento scelto.

Esempio

L'esempio seguente mostra come inviare un evento add_payment_info utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_payment_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "payment_type",
          "value": "Credit Card"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_shipping_info

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

Campi evento

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

* Le metriche relative al valore dell'evento view_item non contribuiscono alle entrate

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

* Imposta conversion_value sulla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_value.
cart_data.items Item[] Sì Gli articoli per l'evento.

Imposta il campo cart_data.items sull'oggetto Event.
cart_data.coupon_codes string[] No SUMMER_FUN Il codice coupon associato all'evento.


Imposta il campo coupon_codes sull'oggetto CartData.
* Fornisci un solo codice coupon in questo elenco.
* Questo è indipendente dai codici coupon a livello di articolo.

Campi articolo

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì I_12345 Un identificatore univoco dell'elemento. Imposta il campo item_id sull'oggetto Item.
unit_price number Sì 27,67 Il prezzo unitario al netto di tasse, spese di spedizione e sconti con ambito evento (a livello di transazione) per questo articolo.

Se l'articolo ha uno sconto con ambito articolo, utilizza il prezzo unitario scontato. Ad esempio, se un articolo ha un prezzo unitario di 27,67 e uno sconto unitario di 6,66, imposta unitPrice su 21,01.
quantity number Sì 1 La quantità di unità acquistate per questo articolo specifico.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
shipping_tier string No Suolo Il livello di spedizione (ad es. Ground, Air, Next-day) selezionato per la consegna dell'articolo acquistato.

Esempio

L'esempio seguente mostra come inviare un evento add_shipping_info utilizzando l'API Data Manager. Se stai eseguendo l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_shipping_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping_tier",
          "value": "Ground"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_cart

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

Campi evento

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

* Le metriche relative al valore dell'evento view_item non contribuiscono alle entrate

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

* Imposta conversion_value sulla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_value.
cart_data.items Item[] Sì Gli articoli per l'evento.

Imposta il campo cart_data.items sull'oggetto Event.

Campi articolo

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì I_12345 Un identificatore univoco dell'elemento. Imposta il campo item_id sull'oggetto Item.
unit_price number Sì 27,67 Il prezzo unitario al netto di tasse, spese di spedizione e sconti con ambito evento (a livello di transazione) per questo articolo.

Se l'articolo ha uno sconto con ambito articolo, utilizza il prezzo unitario scontato. Ad esempio, se un articolo ha un prezzo unitario di 27,67 e uno sconto unitario di 6,66, imposta unitPrice su 21,01.
quantity number Sì 1 La quantità di unità acquistate per questo articolo specifico.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_name string Sì* T-shirt Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare item_id o 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 nell'ambito dell'elemento.
coupon string No SUMMER_FUN Il nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
discount number No 2,22 Il valore dello sconto monetario unitario associato all'articolo.
index number No 5 L'indice/la posizione dell'articolo in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata come parte di una gerarchia o tassonomia di categorie, questa sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o la 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 parametro item_list_id a livello di evento viene ignorato.
Se non viene 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, il parametro item_list_name a livello di evento viene ignorato.
Se non viene 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 luogo 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'elemento associato. Puoi anche utilizzare un ID località personalizzato.
Nota: location_id è disponibile solo nell'ambito dell'elemento.
Oltre ai parametri prescritti, puoi includere fino a 27 parametri personalizzati nell'array items.

Esempio

L'esempio seguente mostra come inviare un evento add_to_cart utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "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 più popolari nella tua app.

Campi evento

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

* Le metriche relative al valore dell'evento view_item non contribuiscono alle entrate

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

* Imposta conversion_value sulla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_value.
cart_data.items Item[] Sì Gli articoli per l'evento.

Imposta il campo cart_data.items sull'oggetto Event.

Campi articolo

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì I_12345 Un identificatore univoco dell'elemento. Imposta il campo item_id sull'oggetto Item.
unit_price number Sì 27,67 Il prezzo unitario al netto di tasse, spese di spedizione e sconti con ambito evento (a livello di transazione) per questo articolo.

Se l'articolo ha uno sconto con ambito articolo, utilizza il prezzo unitario scontato. Ad esempio, se un articolo ha un prezzo unitario di 27,67 e uno sconto unitario di 6,66, imposta unitPrice su 21,01.
quantity number Sì 1 La quantità di unità acquistate per questo articolo specifico.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_name string Sì* T-shirt Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare item_id o 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 nell'ambito dell'elemento.
coupon string No SUMMER_FUN Il nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
discount number No 2,22 Il valore dello sconto monetario unitario associato all'articolo.
index number No 5 L'indice/la posizione dell'articolo in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata come parte di una gerarchia o tassonomia di categorie, questa sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o la 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 parametro item_list_id a livello di evento viene ignorato.
Se non viene 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, il parametro item_list_name a livello di evento viene ignorato.
Se non viene 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 luogo 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'elemento associato. Puoi anche utilizzare un ID località personalizzato.
Nota: location_id è disponibile solo nell'ambito dell'elemento.
Oltre ai parametri prescritti, puoi includere fino a 27 parametri personalizzati nell'array items.

Esempio

L'esempio seguente mostra come inviare un evento add_to_wishlist utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_wishlist",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

begin_checkout

Questo evento indica che un utente ha avviato un pagamento.

Campi evento

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

* Le metriche relative al valore dell'evento view_item non contribuiscono alle entrate

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

* Imposta conversion_value sulla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_value.
cart_data.items Item[] Sì Gli articoli per l'evento.

Imposta il campo cart_data.items sull'oggetto Event.
cart_data.coupon_codes string[] No SUMMER_FUN Il codice coupon associato all'evento.


Imposta il campo coupon_codes sull'oggetto CartData.
* Fornisci un solo codice coupon in questo elenco.
* Questo è indipendente dai codici coupon a livello di articolo.

Campi articolo

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì I_12345 Un identificatore univoco dell'elemento. Imposta il campo item_id sull'oggetto Item.
unit_price number Sì 27,67 Il prezzo unitario al netto di tasse, spese di spedizione e sconti con ambito evento (a livello di transazione) per questo articolo.

Se l'articolo ha uno sconto con ambito articolo, utilizza il prezzo unitario scontato. Ad esempio, se un articolo ha un prezzo unitario di 27,67 e uno sconto unitario di 6,66, imposta unitPrice su 21,01.
quantity number Sì 1 La quantità di unità acquistate per questo articolo specifico.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_name string Sì* T-shirt Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare item_id o 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 nell'ambito dell'elemento.
coupon string No SUMMER_FUN Il nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
discount number No 2,22 Il valore dello sconto monetario unitario associato all'articolo.
index number No 5 L'indice/la posizione dell'articolo in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata come parte di una gerarchia o tassonomia di categorie, questa sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o la 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 parametro item_list_id a livello di evento viene ignorato.
Se non viene 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, il parametro item_list_name a livello di evento viene ignorato.
Se non viene 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 luogo 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'elemento associato. Puoi anche utilizzare un ID località personalizzato.
Nota: location_id è disponibile solo nell'ambito dell'elemento.
Oltre ai parametri prescritti, puoi includere fino a 27 parametri personalizzati nell'array items.

Esempio

L'esempio seguente mostra come inviare un evento begin_checkout utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "begin_checkout",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

in_app_purchase

Questo evento è disponibile solo per gli stream di app.

Utilizza questo evento quando un utente effettua un acquisto in-app.

Campi evento

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* USD Valuta del conversion_value dell'evento, nel formato ISO 4217 a tre lettere.

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

* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_value.
transaction_id string No T_12345 L'identificatore univoco di una transazione.

Il parametro transaction_id consente di evitare gli eventi duplicati per un acquisto. Imposta il campo transaction_id sull'oggetto Event.
cart_data.items Item[] No Gli articoli per l'evento.

Imposta il campo cart_data.items sull'oggetto Event.

Campi articolo

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì I_12345 Un identificatore univoco dell'elemento. Imposta il campo item_id sull'oggetto Item.
unit_price number Sì 27,67 Il prezzo unitario al netto di tasse, spese di spedizione e sconti con ambito evento (a livello di transazione) per questo articolo.

Se l'articolo ha uno sconto con ambito articolo, utilizza il prezzo unitario scontato. Ad esempio, se un articolo ha un prezzo unitario di 27,67 e uno sconto unitario di 6,66, imposta unitPrice su 21,01.
quantity number Sì 1 La quantità di unità acquistate per questo articolo specifico.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
product_id string No ABC123456789 L'ID del prodotto.
subscription boolean No true

Indica se l'acquisto è un abbonamento.
Se non viene impostato, il valore predefinito è false.
free_trial boolean No true

Indica se l'evento riguarda una prova senza costi di un abbonamento.
Se non viene impostato, il valore predefinito è false.
price_is_discounted boolean No false

Indica se price è scontato.
Se non viene impostato, il valore predefinito è false.

Esempio

L'esempio seguente mostra come inviare un evento in_app_purchase utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "in_app_purchase",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "transactionId": "T_12345",
      "conversionValue": 30.03,
      "cartData": {
        "items": [
          {
            "itemId": "ABC123456789",
            "quantity": 3,
            "unitPrice": 10.01
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "subscription",
          "value": true
        },
        {
          "parameterName": "free_trial",
          "value": false
        },
        {
          "parameterName": "price_is_discounted",
          "value": false
        }
      ]
    }
  ]
}

Measurement Protocol

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({
    "app_instance_id": "app_instance_id",
    "events":[{
      "name":"in_app_purchase",
      "params":{
        "currency": "USD",
        "value": 30.03,
        "quantity": 3,
        "transaction_id": "T_12345",
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

purchase

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

Campi evento

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

* Le metriche relative al valore dell'evento view_item non contribuiscono alle entrate

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

* Imposta conversion_value sulla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_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. Imposta il campo transaction_id sull'oggetto Event.
user_properties.customer_type CustomerType No NEW Se la conversione proviene da un cliente NEW o RETURNING.
cart_data.items Item[] Sì Gli articoli per l'evento.

Imposta il campo cart_data.items sull'oggetto Event.
cart_data.coupon_codes string[] No SUMMER_FUN Il codice coupon associato all'evento.


Imposta il campo coupon_codes sull'oggetto CartData.
* Fornisci un solo codice coupon in questo elenco.
* Questo è indipendente dai codici coupon a livello di articolo.

Campi articolo

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì I_12345 Un identificatore univoco dell'elemento. Imposta il campo item_id sull'oggetto Item.
unit_price number Sì 27,67 Il prezzo unitario al netto di tasse, spese di spedizione e sconti con ambito evento (a livello di transazione) per questo articolo.

Se l'articolo ha uno sconto con ambito articolo, utilizza il prezzo unitario scontato. Ad esempio, se un articolo ha un prezzo unitario di 27,67 e uno sconto unitario di 6,66, imposta unitPrice su 21,01.
quantity number Sì 1 La quantità di unità acquistate per questo articolo specifico.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
shipping number No 3,33 Costo di spedizione associato a una transazione.
tax number No 1.11 Gli oneri fiscali associati a una transazione.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_name string Sì* T-shirt Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare item_id o 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 nell'ambito dell'elemento.
coupon string No SUMMER_FUN Il nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
discount number No 2,22 Il valore dello sconto monetario unitario associato all'articolo.
index number No 5 L'indice/la posizione dell'articolo in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata come parte di una gerarchia o tassonomia di categorie, questa sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o la 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 parametro item_list_id a livello di evento viene ignorato.
Se non viene 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, il parametro item_list_name a livello di evento viene ignorato.
Se non viene 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 luogo 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'elemento associato. Puoi anche utilizzare un ID località personalizzato.
Nota: location_id è disponibile solo nell'ambito dell'elemento.
Oltre ai parametri prescritti, puoi includere fino a 27 parametri personalizzati nell'array items.

Esempio

L'esempio seguente mostra come inviare un evento purchase utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "purchase",
      "transactionId": "TRANSACTION_ID",
      "conversionValue": 83.99,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "userProperties": {
        "customerType": "RETURNING"
      },
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 3,
            "unitPrice": 10.01,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Stan and Friends Tee"
              },
              {
                "parameterName": "affiliation",
                "value": "Google Merchandise Store"
              },
              {
                "parameterName": "discount",
                "value": "2.22"
              },
              {
                "parameterName": "index",
                "value": "0"
              },
              {
                "parameterName": "item_brand",
                "value": "Google"
              },
              {
                "parameterName": "item_category",
                "value": "Apparel"
              },
              {
                "parameterName": "item_category2",
                "value": "Adult"
              },
              {
                "parameterName": "item_category3",
                "value": "Shirts"
              },
              {
                "parameterName": "item_category4",
                "value": "Crew"
              },
              {
                "parameterName": "item_category5",
                "value": "Short sleeve"
              },
              {
                "parameterName": "item_list_id",
                "value": "related_products"
              },
              {
                "parameterName": "item_list_name",
                "value": "Related Products"
              },
              {
                "parameterName": "item_variant",
                "value": "green"
              },
              {
                "parameterName": "location_id",
                "value": "ChIJIQBpAG2ahYAR_6128GcTUEo"
              },
              {
                "parameterName": "google_business_vertical",
                "value": "retail"
              }
            ]
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": "3.33"
        },
        {
          "parameterName": "tax",
          "value": "1.11"
        }
      ]
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

refund

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

Campi evento

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

* Le metriche relative al valore dell'evento view_item non contribuiscono alle entrate

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

* Imposta conversion_value sulla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_value.
transaction_id string Sì T_12345 L'identificatore univoco di una transazione.
cart_data.items Item[] No Gli articoli per l'evento.

Imposta il campo cart_data.items sull'oggetto Event.
cart_data.coupon_codes string[] No SUMMER_FUN Il codice coupon associato all'evento.


Imposta il campo coupon_codes sull'oggetto CartData.
* Fornisci un solo codice coupon in questo elenco.
* Questo è indipendente dai codici coupon a livello di articolo.

Campi articolo

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì I_12345 Un identificatore univoco dell'elemento. Imposta il campo item_id sull'oggetto Item.
unit_price number Sì 27,67 Il prezzo unitario al netto di tasse, spese di spedizione e sconti con ambito evento (a livello di transazione) per questo articolo.

Se l'articolo ha uno sconto con ambito articolo, utilizza il prezzo unitario scontato. Ad esempio, se un articolo ha un prezzo unitario di 27,67 e uno sconto unitario di 6,66, imposta unitPrice su 21,01.
quantity number Sì 1 La quantità di unità acquistate per questo articolo specifico.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
shipping number No 3,33 Costo di spedizione associato a una transazione.
tax number No 1.11 Gli oneri fiscali associati a una transazione.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_name string Sì* T-shirt Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare item_id o 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 nell'ambito dell'elemento.
coupon string No SUMMER_FUN Il nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
discount number No 2,22 Il valore dello sconto monetario unitario associato all'articolo.
index number No 5 L'indice/la posizione dell'articolo in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata come parte di una gerarchia o tassonomia di categorie, questa sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o la 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 parametro item_list_id a livello di evento viene ignorato.
Se non viene 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, il parametro item_list_name a livello di evento viene ignorato.
Se non viene 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 luogo 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'elemento associato. Puoi anche utilizzare un ID località personalizzato.
Nota: location_id è disponibile solo nell'ambito dell'elemento.
Oltre ai parametri prescritti, puoi includere fino a 27 parametri personalizzati nell'array items.

Esempio

L'esempio seguente mostra come inviare un evento refund utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "refund",
      "conversionValue": 30.03,
      "currency": "USD",
      "transactionId": "T_12345",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": 3.33
        },
        {
          "parameterName": "tax",
          "value": 1.11
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

remove_from_cart

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

Campi evento

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

* Le metriche relative al valore dell'evento view_item non contribuiscono alle entrate

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

* Imposta conversion_value sulla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_value.
cart_data.items Item[] Sì Gli articoli per l'evento.

Imposta il campo cart_data.items sull'oggetto Event.

Campi articolo

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì I_12345 Un identificatore univoco dell'elemento. Imposta il campo item_id sull'oggetto Item.
unit_price number Sì 27,67 Il prezzo unitario al netto di tasse, spese di spedizione e sconti con ambito evento (a livello di transazione) per questo articolo.

Se l'articolo ha uno sconto con ambito articolo, utilizza il prezzo unitario scontato. Ad esempio, se un articolo ha un prezzo unitario di 27,67 e uno sconto unitario di 6,66, imposta unitPrice su 21,01.
quantity number Sì 1 La quantità di unità acquistate per questo articolo specifico.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_name string Sì* T-shirt Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare item_id o 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 nell'ambito dell'elemento.
coupon string No SUMMER_FUN Il nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
discount number No 2,22 Il valore dello sconto monetario unitario associato all'articolo.
index number No 5 L'indice/la posizione dell'articolo in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata come parte di una gerarchia o tassonomia di categorie, questa sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o la 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 parametro item_list_id a livello di evento viene ignorato.
Se non viene 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, il parametro item_list_name a livello di evento viene ignorato.
Se non viene 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 luogo 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'elemento associato. Puoi anche utilizzare un ID località personalizzato.
Nota: location_id è disponibile solo nell'ambito dell'elemento.
Oltre ai parametri prescritti, puoi includere fino a 27 parametri personalizzati nell'array items.

Esempio

L'esempio seguente mostra come inviare un evento remove_from_cart utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "remove_from_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_item

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

Campi evento

Nome Tipo Obbligatorio Valore di esempio Descrizione
cart_data.items Item[] Sì* Gli articoli per l'evento.

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

Imposta il campo cart_data.items sull'oggetto Event.

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.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_name string Sì* T-shirt Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare item_id o 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 nell'ambito dell'elemento.
coupon string No SUMMER_FUN Il nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
discount number No 2,22 Il valore dello sconto monetario unitario associato all'articolo.
index number No 5 L'indice/la posizione dell'articolo in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata come parte di una gerarchia o tassonomia di categorie, questa sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o la 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 parametro item_list_id a livello di evento viene ignorato.
Se non viene 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, il parametro item_list_name a livello di evento viene ignorato.
Se non viene 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 luogo 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'elemento associato. Puoi anche utilizzare un ID località personalizzato.
Nota: location_id è disponibile solo nell'ambito dell'elemento.
Oltre ai parametri prescritti, puoi includere fino a 27 parametri personalizzati nell'array items.

Esempio

L'esempio seguente mostra come inviare un evento select_item utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_item",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_promotion

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

Campi evento

Nome Tipo Obbligatorio Valore di esempio Descrizione
cart_data.items Item[] No Gli articoli per l'evento.

Imposta il campo cart_data.items sull'oggetto Event.

Campi articolo

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì I_12345 Un identificatore univoco dell'elemento. Imposta il campo item_id sull'oggetto Item.
unit_price number Sì 27,67 Il prezzo unitario al netto di tasse, spese di spedizione e sconti con ambito evento (a livello di transazione) per questo articolo.

Se l'articolo ha uno sconto con ambito articolo, utilizza il prezzo unitario scontato. Ad esempio, se un articolo ha un prezzo unitario di 27,67 e uno sconto unitario di 6,66, imposta unitPrice su 21,01.
quantity number Sì 1 La quantità di unità acquistate per questo articolo specifico.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
creative_name string No summer_banner2 Il nome della creatività promozionale.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'evento.
promotion_id string No P_12345 L'ID della promozione associata all'evento.
promotion_name string No Saldi estivi Il nome della promozione associata all'evento.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_name string Sì* T-shirt Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare item_id o 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 nell'ambito dell'elemento.
coupon string No SUMMER_FUN Il nome/codice del coupon associato all'articolo.

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

Se non viene impostato, il valore predefinito è a livello di evento creative_name.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'articolo.

Se non viene impostato, il valore predefinito è a livello di evento creative_slot.
discount number No 2,22 Il valore dello sconto monetario unitario associato all'articolo.
index number No 5 L'indice/la posizione dell'articolo in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata come parte di una gerarchia o tassonomia di categorie, questa sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o la 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 parametro item_list_id a livello di evento viene ignorato.
Se non viene 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, il parametro item_list_name a livello di evento viene ignorato.
Se non viene 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 luogo 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'elemento associato. Puoi anche utilizzare un ID località personalizzato.
Nota: location_id è disponibile solo nell'ambito dell'elemento.
promotion_id string No P_12345 L'ID della promozione associata all'articolo.

Se non viene impostato, il valore predefinito è a livello di evento promotion_id.
promotion_name string No Saldi estivi Il nome della promozione associata all'articolo.

Se non viene impostato, il valore predefinito è a livello di evento promotion_name.
Oltre ai parametri prescritti, puoi includere fino a 27 parametri personalizzati nell'array items.

Esempio

L'esempio seguente mostra come inviare un evento select_promotion utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_cart

Questo evento indica che un utente ha visualizzato il carrello.

Campi evento

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

* Le metriche relative al valore dell'evento view_item non contribuiscono alle entrate

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

* Imposta conversion_value sulla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_value.
cart_data.items Item[] Sì Gli articoli per l'evento.

Imposta il campo cart_data.items sull'oggetto Event.

Campi articolo

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì I_12345 Un identificatore univoco dell'elemento. Imposta il campo item_id sull'oggetto Item.
unit_price number Sì 27,67 Il prezzo unitario al netto di tasse, spese di spedizione e sconti con ambito evento (a livello di transazione) per questo articolo.

Se l'articolo ha uno sconto con ambito articolo, utilizza il prezzo unitario scontato. Ad esempio, se un articolo ha un prezzo unitario di 27,67 e uno sconto unitario di 6,66, imposta unitPrice su 21,01.
quantity number Sì 1 La quantità di unità acquistate per questo articolo specifico.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_name string Sì* T-shirt Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare item_id o 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 nell'ambito dell'elemento.
coupon string No SUMMER_FUN Il nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
discount number No 2,22 Il valore dello sconto monetario unitario associato all'articolo.
index number No 5 L'indice/la posizione dell'articolo in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata come parte di una gerarchia o tassonomia di categorie, questa sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o la 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 parametro item_list_id a livello di evento viene ignorato.
Se non viene 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, il parametro item_list_name a livello di evento viene ignorato.
Se non viene 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 luogo 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'elemento associato. Puoi anche utilizzare un ID località personalizzato.
Nota: location_id è disponibile solo nell'ambito dell'elemento.
Oltre ai parametri prescritti, puoi includere fino a 27 parametri personalizzati nell'array items.

Esempio

L'esempio seguente mostra come inviare un evento view_cart utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_cart",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_item

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

Campi evento

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

* Le metriche relative al valore dell'evento view_item non contribuiscono alle entrate

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

* Imposta conversion_value sulla somma di (price * quantity) per tutti gli elementi in items. Non includere shipping o tax.
* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_value.
cart_data.items Item[] Sì Gli articoli per l'evento.

Imposta il campo cart_data.items sull'oggetto Event.

Campi articolo

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì I_12345 Un identificatore univoco dell'elemento. Imposta il campo item_id sull'oggetto Item.
unit_price number Sì 27,67 Il prezzo unitario al netto di tasse, spese di spedizione e sconti con ambito evento (a livello di transazione) per questo articolo.

Se l'articolo ha uno sconto con ambito articolo, utilizza il prezzo unitario scontato. Ad esempio, se un articolo ha un prezzo unitario di 27,67 e uno sconto unitario di 6,66, imposta unitPrice su 21,01.
quantity number Sì 1 La quantità di unità acquistate per questo articolo specifico.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_name string Sì* T-shirt Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare item_id o 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 nell'ambito dell'elemento.
coupon string No SUMMER_FUN Il nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
discount number No 2,22 Il valore dello sconto monetario unitario associato all'articolo.
index number No 5 L'indice/la posizione dell'articolo in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata come parte di una gerarchia o tassonomia di categorie, questa sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o la 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 parametro item_list_id a livello di evento viene ignorato.
Se non viene 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, il parametro item_list_name a livello di evento viene ignorato.
Se non viene 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 luogo 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'elemento associato. Puoi anche utilizzare un ID località personalizzato.
Nota: location_id è disponibile solo nell'ambito dell'elemento.
Oltre ai parametri prescritti, puoi includere fino a 27 parametri personalizzati nell'array items.

Esempio

L'esempio seguente mostra come inviare un evento view_item utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ],
      }
    }]
  })
});

view_item_list

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

Campi evento

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

* Le metriche relative al valore dell'evento view_item non contribuiscono alle entrate

* Se imposti conversion_value, currency è obbligatorio per calcolare accuratamente le metriche relative alle entrate.
cart_data.items Item[] Sì Gli articoli per l'evento.

Imposta il campo cart_data.items sull'oggetto Event.

Campi articolo

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì I_12345 Un identificatore univoco dell'elemento. Imposta il campo item_id sull'oggetto Item.
unit_price number Sì 27,67 Il prezzo unitario al netto di tasse, spese di spedizione e sconti con ambito evento (a livello di transazione) per questo articolo.

Se l'articolo ha uno sconto con ambito articolo, utilizza il prezzo unitario scontato. Ad esempio, se un articolo ha un prezzo unitario di 27,67 e uno sconto unitario di 6,66, imposta unitPrice su 21,01.
quantity number Sì 1 La quantità di unità acquistate per questo articolo specifico.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_name string Sì* T-shirt Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare item_id o 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 nell'ambito dell'elemento.
coupon string No SUMMER_FUN Il nome/codice del coupon associato all'articolo.

I parametri coupon a livello di evento e di articolo sono indipendenti.
discount number No 2,22 Il valore dello sconto monetario unitario associato all'articolo.
index number No 5 L'indice/la posizione dell'articolo in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata come parte di una gerarchia o tassonomia di categorie, questa sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o la 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 parametro item_list_id a livello di evento viene ignorato.
Se non viene 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, il parametro item_list_name a livello di evento viene ignorato.
Se non viene 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 luogo 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'elemento associato. Puoi anche utilizzare un ID località personalizzato.
Nota: location_id è disponibile solo nell'ambito dell'elemento.
Oltre ai parametri prescritti, puoi includere fino a 27 parametri personalizzati nell'array items.

Esempio

L'esempio seguente mostra come inviare un evento view_item_list utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item_list",
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_promotion

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

Campi evento

Nome Tipo Obbligatorio Valore di esempio Descrizione
cart_data.items Item[] Sì* Gli articoli per l'evento.

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

Imposta il campo cart_data.items sull'oggetto Event.

Campi articolo

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_id string Sì I_12345 Un identificatore univoco dell'elemento. Imposta il campo item_id sull'oggetto Item.
unit_price number Sì 27,67 Il prezzo unitario al netto di tasse, spese di spedizione e sconti con ambito evento (a livello di transazione) per questo articolo.

Se l'articolo ha uno sconto con ambito articolo, utilizza il prezzo unitario scontato. Ad esempio, se un articolo ha un prezzo unitario di 27,67 e uno sconto unitario di 6,66, imposta unitPrice su 21,01.
quantity number Sì 1 La quantità di unità acquistate per questo articolo specifico.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
creative_name string No summer_banner2 Il nome della creatività promozionale.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'evento.
promotion_id string No P_12345 L'ID della promozione associata all'evento.
promotion_name string No Saldi estivi Il nome della promozione associata all'evento.

Parametri degli elementi

Nome Tipo Obbligatorio Valore di esempio Descrizione
item_name string Sì* T-shirt Stan and Friends

Il nome dell'articolo.

*È obbligatorio specificare item_id o 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 nell'ambito dell'elemento.
coupon string No SUMMER_FUN Il nome/codice del coupon associato all'articolo.

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

Se non viene impostato, il valore predefinito è a livello di evento creative_name.
creative_slot string No featured_app_1 Il nome dell'area della creatività promozionale associata all'articolo.

Se non viene impostato, il valore predefinito è a livello di evento creative_slot.
discount number No 2,22 Il valore dello sconto monetario unitario associato all'articolo.
index number No 5 L'indice/la posizione dell'articolo in un elenco.
item_brand string No Google Il brand dell'articolo.
item_category string No Abbigliamento La categoria dell'articolo. Se utilizzata come parte di una gerarchia o tassonomia di categorie, questa sarà la prima categoria.
item_category2 string No Adulto La seconda gerarchia di categorie o la 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 parametro item_list_id a livello di evento viene ignorato.
Se non viene 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, il parametro item_list_name a livello di evento viene ignorato.
Se non viene 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 luogo 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'elemento associato. Puoi anche utilizzare un ID località personalizzato.
Nota: location_id è disponibile solo nell'ambito dell'elemento.
promotion_id string No P_12345 L'ID della promozione associata all'articolo.

Se non viene impostato, il valore predefinito è a livello di evento promotion_id.
promotion_name string No Saldi estivi Il nome della promozione associata all'articolo.

Se non viene impostato, il valore predefinito è a livello di evento promotion_name.
Oltre ai parametri prescritti, puoi includere fino a 27 parametri personalizzati nell'array items.

Esempio

L'esempio seguente mostra come inviare un evento view_promotion utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

Videogiochi

level_up

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

Parametri

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

Esempio

L'esempio seguente mostra come inviare un evento level_up utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "level_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

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 migliori punteggi 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 personaggio che ha ottenuto il punteggio.

Esempio

L'esempio seguente mostra come inviare un evento post_score utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "post_score",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "score",
          "value": 10000
        },
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

unlock_achievement

Registra questo evento quando l'utente ha sbloccato un obiettivo. Questo evento può aiutarti a capire in che modo gli utenti interagiscono con 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 mostra come inviare un evento unlock_achievement utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "unlock_achievement",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "achievement_id",
          "value": "A_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

Generazione di lead

close_convert_lead

Registra questo evento quando un lead qualificato viene convertito correttamente in un cliente. In genere, questo indica la fine del processo di lead nurturing, ad esempio quando viene firmato un contratto, inizia un abbonamento a pagamento o viene completata una vendita finale.

  • Nota:per monitorare l'acquisizione iniziale dei lead, ad esempio l'invio di moduli, le iscrizioni alle newsletter o le richieste di demo, utilizza l'evento generate_lead.

Campi evento

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* USD Valuta del conversion_value dell'evento, nel formato ISO 4217 a tre lettere.

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

* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_value.

Esempio

L'esempio seguente mostra come inviare un evento close_convert_lead utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_convert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_convert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

close_unconvert_lead

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

Campi evento

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* USD Valuta del conversion_value dell'evento, nel formato ISO 4217 a tre lettere.

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

* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_value.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
unconvert_lead_reason string No Nessuna risposta Il motivo per cui il lead non è stato convertito.

Esempio

L'esempio seguente mostra come inviare un evento close_unconvert_lead utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_unconvert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "unconvert_lead_reason",
          "value": "Never responded"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded"
      }
    }]
  })
});

disqualify_lead

Questo evento misura quando un utente viene contrassegnato come non qualificato per diventare un lead, insieme al motivo della squalifica.

Campi evento

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* USD Valuta del conversion_value dell'evento, nel formato ISO 4217 a tre lettere.

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

* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_value.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
disqualified_lead_reason string No Non voglio acquistare Il motivo per cui un lead è stato contrassegnato come non idoneo.

Esempio

L'esempio seguente mostra come inviare un evento disqualify_lead utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "disqualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "disqualified_lead_reason",
          "value": "Not looking to buy"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "disqualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "disqualified_lead_reason": "Not looking to buy"
      }
    }]
  })
});

generate_lead

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

Campi evento

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* USD Valuta del conversion_value dell'evento, nel formato ISO 4217 a tre lettere.

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

* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_value.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
lead_source string No Fiera L'origine del lead.

Esempio

L'esempio seguente mostra come inviare un evento generate_lead utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "generate_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_source",
          "value": "Trade show"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_source": "Trade show"
      }
    }]
  })
});

qualify_lead

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

Campi evento

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* USD Valuta del conversion_value dell'evento, nel formato ISO 4217 a tre lettere.

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

* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_value.

Esempio

L'esempio seguente mostra come inviare un evento qualify_lead utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "qualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "qualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

working_lead

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

Campi evento

Nome Tipo Obbligatorio Valore di esempio Descrizione
currency string Sì* USD Valuta del conversion_value dell'evento, nel formato ISO 4217 a tre lettere.

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

* conversion_value è in genere obbligatorio per generare report significativi. Se contrassegni l'evento come evento chiave, ti consigliamo di impostare conversion_value.
* currency è obbligatorio se imposti conversion_value.

Parametri

Nome Tipo Obbligatorio Valore di esempio Descrizione
lead_status string No Conversazioni avviate Lo stato del lead.

Esempio

L'esempio seguente mostra come inviare un evento working_lead utilizzando l'API Data Manager. Se esegui l'upgrade da Measurement Protocol, utilizza le schede per eseguire la migrazione delle richieste all'API Data Manager.

API Data Manager


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "working_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_status",
          "value": "Started conversations"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations"
      }
    }]
  })
});