Utilizza i mapping nelle tabelle per mappare una richiesta di raccolta dei dati Measurement Protocol (/mp/collect) al relativo equivalente IngestEventsRequest nell'API Data Manager.
Campi della richiesta
Richiesta /mp/collect (Measurement Protocol) |
IngestEventsRequest (API Data Manager) |
Note |
|---|---|---|
measurement_id (parametro di query) |
destinations |
Mappa per product_destination_id per eventi web. Per maggiori dettagli, consulta Campi di destinazione. |
firebase_app_id (parametro di query) |
destinations |
Mappa a product_destination_id per gli eventi app. Per maggiori dettagli, consulta Campi di destinazione. |
api_secret (parametro di query) |
Nessun equivalente | Consulta Configurare l'accesso API per scoprire come autenticare le richieste nell'API Data Manager. |
consent |
consent |
Impostato su un oggetto Consent. |
events |
events |
Impostato su un elenco di risorse Event. Per maggiori dettagli, consulta la sezione Campi evento. |
client_id |
events.client_id |
Obbligatorio per gli eventi web. |
app_instance_id |
events.app_instance_id |
Obbligatorio per gli eventi app. |
user_id |
events.user_id |
Facoltativo. un identificatore unico per un utente. |
timestamp_micros |
events.event_timestamp |
In Measurement Protocol, questo valore può essere fornito a livello di richiesta o per un singolo evento. Nell'API Data Manager non è presente un timestamp a livello di richiesta. Imposta event_timestamp su ogni evento all'ora in cui si è verificato l'evento.
Per maggiori dettagli, vedi Formato per il timestamp. |
user_properties |
events.user_properties |
Impostato su un oggetto UserProperties. L'API Data Manager non supporta l'impostazione dei timestamp per le singole proprietà utente. I timestamp associati alle modifiche alle proprietà utente vengono dedotti dal timestamp dell'evento (event_timestamp). |
user_data |
events.user_data |
Impostato su un oggetto UserData. Per maggiori dettagli, vedi Campi identificatore dell'utente. |
non_personalized_ads |
events.consent.ad_personalization |
Se non_personalized_ads è true, imposta ad_personalization su DENIED. |
user_location |
events.event_location |
Per maggiori dettagli, consulta Campi della posizione utente. |
ip_override |
events.event_device_info.ip_address |
|
device |
events.event_device_info |
Per maggiori dettagli, vedi Campi del dispositivo. |
user_agent |
events.event_device_info.user_agent |
|
validation_behavior |
Nessun equivalente | Utilizza Diagnostica per recuperare lo stato del caricamento, nonché gli errori e gli avvisi per i singoli eventi durante l'elaborazione downstream. Se IngestEventsRequest non va a buon fine (ad esempio, a causa della mancanza di campi obbligatori), non vengono elaborati eventi e devi risolvere l'errore e riprovare a inviare la richiesta. Per ulteriori informazioni, consulta la sezione Informazioni sugli errori dell'API. |
/debug/mp/collect |
validate_only |
Imposta validate_only su true per convalidare gli eventi senza importare dati, in modo simile al server di convalida di Measurement Protocol. |
| Nessun equivalente | encoding |
Obbligatorio per i caricamenti di UserData. Impostato su Encoding utilizzato per i valori UserIdentifier. |
Campi destinazione
Measurement Protocol invia gli eventi direttamente a uno stream di dati specifico utilizzando il parametro di query
measurement_id o firebase_app_id.
L'API Data Manager utilizza un oggetto Destination per specificare dove inviare i dati.
Per saperne di più sulle destinazioni, consulta Configurare le destinazioni.
Ecco come mappare i campi di Measurement Protocol ai campi equivalenti in un Destination:
| Measurement Protocol | Destination (API Data Manager) |
Note |
|---|---|---|
measurement_id (parametro di query) |
product_destination_id |
Impostato sull'ID misurazione dello stream di dati web di Google Analytics |
firebase_app_id (parametro di query) |
product_destination_id |
Impostato sull'ID app Firebase dello stream di dati dell'app Google Analytics |
| Nessun equivalente | operating_account |
Imposta account_id sull'ID proprietà Google Analytics. Imposta account_type su GOOGLE_ANALYTICS_PROPERTY. |
| Nessun equivalente | login_account |
Imposta account_id sull'ID proprietà Google Analytics. Imposta account_type su GOOGLE_ANALYTICS_PROPERTY. |
Campi evento
Measurement Protocol events[] |
Event (API Data Manager) |
Note |
|---|---|---|
name |
event_name |
Se event_name utilizza un nome riservato, l'API rifiuta l'evento con un errore INVALID_EVENT_NAME. |
| Nessun equivalente | event_source |
Imposta WEB se l'evento è stato generato da un browser web e APP se è stato generato da un'app. |
| Nessun equivalente | destination_references |
Obbligatorio se l'elenco destinations a livello di richiesta contiene più di un Destination Google Analytics. Aggiungi una voce per specificare la destinazione che deve ricevere l'evento. |
timestamp_micros |
event_timestamp |
Per maggiori dettagli, vedi Formato per il timestamp. |
params.currency |
currency |
|
params.value |
conversion_value |
|
params.customer_type |
user_properties.customer_type |
In Measurement Protocol, il parametro customer_type è impostato come parametro evento. Nell'API Data Manager, impostalo nel campo customer_type dell'oggetto UserProperties dell'evento. |
params.transaction_id |
transaction_id |
Obbligatorio per alcuni eventi e casi d'uso. Per ulteriori dettagli, consulta Convertire i dati in oggetti Event. |
params.items |
cart_data.items |
Per maggiori dettagli, consulta Campi degli articoli per i dati del carrello. |
params.coupon |
cart_data.coupon_codes |
Utilizza il campo coupon_codes per fornire i coupon applicati al carrello. Fornisci un solo coupon per Google Analytics. Questo è indipendente dai coupon a livello di Item, che possono essere impostati utilizzando cart_data.items.additional_item_parameters per i singoli articoli. |
params.session_id |
additional_event_parameters |
Mappa di una voce con parameter_name impostato su session_id. |
params.engagement_time_msec |
additional_event_parameters |
Mappa di una voce con parameter_name impostato su engagement_time_msec. |
Altro in params |
additional_event_parameters |
Mappa altri parametri come un elenco di oggetti con |
Campi identificatore dell'utente
Measurement Protocol user_data |
UserIdentifier (API Data Manager) |
Note |
|---|---|---|
sha256_email_address[] |
email_address |
Imposta l'indirizzo email formattato e sottoposto ad hashing. Puoi anche criptare l'indirizzo email sottoposto ad hashing. |
sha256_phone_number[] |
phone_number |
Impostato sul numero di telefono formattato e sottoposto ad hashing. Puoi anche criptare il numero di telefono sottoposto ad hashing. |
address[] |
address |
Impostato su un oggetto AddressInfo. Segui le linee guida sulla formattazione e sull'hashing. |
address[].sha256_first_name |
address.given_name |
Impostato sul nome dato formattato e sottoposto ad hashing. Puoi anche criptare il nome dato sottoposto ad hashing. |
address[].sha256_last_name |
address.family_name |
Imposta il cognome formattato e sottoposto ad hashing. Puoi anche criptare il nome della famiglia sottoposto ad hashing. |
address[].country |
address.region_code |
|
address[].postal_code |
address.postal_code |
|
address[].city |
Nessun equivalente | Non supportato nella versione attuale dell'API Data Manager. |
address[].region |
Nessun equivalente | Non supportato nella versione attuale dell'API Data Manager. |
address[].sha256_street |
Nessun equivalente | Non supportato nella versione attuale dell'API Data Manager. |
Campi degli articoli per i dati del carrello
Measurement Protocol items[] |
Item (API Data Manager) |
Note |
|---|---|---|
item_id |
item_id |
Obbligatorio. |
item_name |
additional_item_parameters |
Mappa di una voce con parameter_name impostato su item_name. |
quantity |
quantity |
Obbligatorio. |
price |
unit_price |
Obbligatorio. |
| Altri campi articolo | additional_item_parameters |
Mappa altri parametri articolo (ad esempio |
Campi relativi alla località dell'utente
Measurement Protocol user_location |
EventLocation (API Data Manager) |
Note |
|---|---|---|
city |
city |
Il nome della città in cui si è verificato l'evento. |
country_id |
region_code |
Impostato sul codice regione CLDR di due lettere. |
region_id |
subdivision_code |
Impostato sul codice di suddivisione ISO 3166-2. |
continent_id |
continent_code |
Impostato sul codice continente nel formato UN M49. |
subcontinent_id |
subcontinent_code |
Impostato sul codice del subcontinente nel formato UN M49. |
Campi dispositivo
Measurement Protocol device |
DeviceInfo (API Data Manager) |
Note |
|---|---|---|
category |
category |
|
language |
language_code |
|
screen_resolution |
screen_height e screen_width |
In Measurement Protocol, screen_resolution viene fornito come stringa ("1280x720"). Nell'API Data Manager, invia screen_height e screen_width come valori interi separati. |
operating_system |
operating_system |
|
operating_system_version |
operating_system_version |
|
model |
model |
|
brand |
brand |
|
browser |
browser |
|
browser_version |
browser_version |