Method: events.ingest

Carica un elenco di risorse Event dal Destination fornito.

Richiesta HTTP

POST https://datamanager.googleapis.com/v1/events:ingest

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "events": [
    {
      object (Event)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  }
}
Campi
destinations[]

object (Destination)

Obbligatorio. L'elenco delle destinazioni a cui inviare gli eventi.
events[]

object (Event)

Obbligatorio. L'elenco degli eventi da inviare alle destinazioni specificate. In una singola richiesta possono essere inviate al massimo 2000 risorse Event.
consent

object (Consent)

Facoltativo. Consenso a livello di richiesta da applicare a tutti gli utenti della richiesta. Il consenso a livello di utente sostituisce il consenso a livello di richiesta e può essere specificato in ogni Event.
validateOnly

boolean

Facoltativo. A scopo di test. Se true, la richiesta viene convalidata, ma non eseguita. Vengono restituiti solo gli errori, non i risultati.
encoding

enum (Encoding)

Facoltativo. Obbligatorio per i caricamenti di UserData. Il tipo di codifica degli identificatori utente. Per gli identificatori utente sottoposti ad hashing, questo è il tipo di codifica della stringa sottoposta ad hashing. Per gli identificatori utente sottoposti ad hashing criptato, questo è il tipo di codifica della stringa criptata esterna, ma non necessariamente della stringa sottoposta ad hashing interna, il che significa che la stringa sottoposta ad hashing interna potrebbe essere codificata in modo diverso rispetto alla stringa criptata esterna. Per i caricamenti non UserData, questo campo viene ignorato.
encryptionInfo

object (EncryptionInfo)

Facoltativo. Informazioni sulla crittografia per i caricamenti di UserData. Se non è impostato, si presume che i dati identificativi caricati siano sottoposti ad hashing, ma non criptati. Per i caricamenti non UserData, questo campo viene ignorato.

Corpo della risposta

Risposta da parte di IngestEventsRequest.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "requestId": string
}
Campi
requestId

string

L'ID generato automaticamente della richiesta.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/datamanager

Evento

Un evento che rappresenta un'interazione utente con il sito web o l'app di un inserzionista.

Rappresentazione JSON 
{
  "destinationReferences": [
    string
  ],
  "transactionId": string,
  "eventTimestamp": string,
  "lastUpdatedTimestamp": string,
  "userData": {
    object (UserData)
  },
  "consent": {
    object (Consent)
  },
  "adIdentifiers": {
    object (AdIdentifiers)
  },
  "currency": string,
  "conversionValue": number,
  "eventSource": enum (EventSource),
  "eventDeviceInfo": {
    object (DeviceInfo)
  },
  "cartData": {
    object (CartData)
  },
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "experimentalFields": [
    {
      object (ExperimentalField)
    }
  ],
  "userProperties": {
    object (UserProperties)
  }
}
Campi
destinationReferences[]

string

Facoltativo. Stringa di riferimento utilizzata per determinare la destinazione. Se è vuoto, l'evento verrà inviato a tutti i destinations nella richiesta.
transactionId

string

Facoltativo. L'identificatore univoco di questo evento. Obbligatorio per le conversioni che utilizzano più origini dati.
eventTimestamp

string (Timestamp format)

Obbligatorio. L'ora in cui si è verificato l'evento.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastUpdatedTimestamp

string (Timestamp format)

Facoltativo. L'ultima volta che l'evento è stato aggiornato.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
userData

object (UserData)

Facoltativo. Parti di dati forniti dall'utente, che rappresentano l'utente a cui è associato l'evento.
consent

object (Consent)

Facoltativo. Informazioni sul fatto che l'utente associato abbia fornito diversi tipi di consenso.
adIdentifiers

object (AdIdentifiers)

Facoltativo. Identificatori e altre informazioni utilizzate per abbinare l'evento di conversione ad altre attività online (ad esempio clic sugli annunci).
currency

string

Facoltativo. Il codice valuta associato a tutti i valori monetari all'interno di questo evento.
conversionValue

number

Facoltativo. Il valore di conversione associato all'evento, per le conversioni basate sul valore.
eventSource

enum (EventSource)

Facoltativo. Indicatore del luogo in cui si è verificato l'evento (web, app, negozio fisico e così via).
eventDeviceInfo

object (DeviceInfo)

Facoltativo. Informazioni raccolte sul dispositivo utilizzato (se presente) quando si è verificato l'evento.
cartData

object (CartData)

Facoltativo. Informazioni sulla transazione e sugli articoli associati all'evento.
customVariables[]

object (CustomVariable)

Facoltativo. Informazioni aggiuntive sulle coppie chiave/valore da inviare ai contenitori di conversione (azione di conversione o attività Floodlight).
experimentalFields[]

object (ExperimentalField)

Facoltativo. Un elenco di coppie chiave/valore per i campi sperimentali che potrebbero essere promossi per far parte dell'API.
userProperties

object (UserProperties)

Facoltativo. Informazioni valutate dall'inserzionista sull'utente al momento dell'evento.

AdIdentifiers

Identificatori e altre informazioni utilizzate per abbinare l'evento di conversione ad altre attività online (ad esempio clic sugli annunci).

Rappresentazione JSON 
{
  "sessionAttributes": string,
  "gclid": string,
  "gbraid": string,
  "wbraid": string,
  "landingPageDeviceInfo": {
    object (DeviceInfo)
  }
}
Campi
sessionAttributes

string

Facoltativo. Attributi sessione per l'attribuzione e la modellazione degli eventi.
gclid

string

Facoltativo. L'ID clic Google (gclid) associato a questo evento.
gbraid

string

Facoltativo. L'identificatore dei clic associati agli eventi app e provenienti da dispositivi iOS a partire da iOS 14.
wbraid

string

Facoltativo. L'identificatore dei clic associati agli eventi web e provenienti da dispositivi iOS a partire da iOS 14.
landingPageDeviceInfo

object (DeviceInfo)

Facoltativo. Informazioni raccolte sul dispositivo utilizzato (se presente) al momento dell'accesso al sito dell'inserzionista dopo l'interazione con l'annuncio.

DeviceInfo

Informazioni sul dispositivo utilizzato (se presente) quando si è verificato l'evento.

Rappresentazione JSON 
{
  "userAgent": string,
  "ipAddress": string
}
Campi
userAgent

string

Facoltativo. La stringa user agent del dispositivo per il contesto specificato.
ipAddress

string

Facoltativo. L'indirizzo IP del dispositivo per il contesto specificato.

Nota: Google Ads non supporta la corrispondenza degli indirizzi IP per gli utenti finali nello Spazio economico europeo (SEE), nel Regno Unito (UK) o in Svizzera (CH). Aggiungi una logica per escludere in modo condizionale la condivisione degli indirizzi IP degli utenti di queste regioni e assicurati di fornire agli utenti informazioni chiare e complete sui dati raccolti sui tuoi siti, nelle tue app e in altre proprietà e di ottenere il consenso ove richiesto dalla legge o da eventuali norme di Google vigenti. Per ulteriori dettagli, consulta la pagina Informazioni sulle importazioni delle conversioni offline.

EventSource

L'origine dell'evento.

Enum
EVENT_SOURCE_UNSPECIFIED EventSource non specificato. Non deve mai essere utilizzato.
WEB L'evento è stato generato da un browser web.
APP L'evento è stato generato da un'app.
IN_STORE L'evento è stato generato da una transazione in negozio.
PHONE L'evento è stato generato da una chiamata.
OTHER L'evento è stato generato da altre fonti.

CartData

I dati del carrello associati all'evento.

Rappresentazione JSON 
{
  "merchantId": string,
  "merchantFeedLabel": string,
  "merchantFeedLanguageCode": string,
  "transactionDiscount": number,
  "items": [
    {
      object (Item)
    }
  ]
}
Campi
merchantId

string

Facoltativo. L'ID Merchant Center associato agli articoli.
merchantFeedLabel

string

Facoltativo. L'etichetta del feed di Merchant Center associata al feed degli articoli.
merchantFeedLanguageCode

string

Facoltativo. Il codice lingua ISO 639-1 associato al feed Merchant Center degli articoli in cui vengono caricati i tuoi articoli.
transactionDiscount

number

Facoltativo. La somma di tutti gli sconti associati alla transazione.
items[]

object (Item)

Facoltativo. L'elenco degli elementi associati all'evento.

Elemento

Rappresenta un articolo nel carrello associato all'evento.

Rappresentazione JSON 
{
  "merchantProductId": string,
  "quantity": string,
  "unitPrice": number
}
Campi
merchantProductId

string

Facoltativo. L'ID prodotto all'interno dell'account Merchant Center.
quantity

string (int64 format)

Facoltativo. Il numero di questo elemento associato all'evento.
unitPrice

number

Facoltativo. Il prezzo unitario al netto di tasse, spese di spedizione ed eventuali sconti a livello di transazione.

CustomVariable

Variabile personalizzata per le conversioni degli annunci.

Rappresentazione JSON 
{
  "variable": string,
  "value": string,
  "destinationReferences": [
    string
  ]
}
Campi
variable

string

Facoltativo. Il nome della variabile personalizzata da impostare. Se la variabile non viene trovata per la destinazione specificata, verrà ignorata.
value

string

Facoltativo. Il valore da memorizzare per la variabile personalizzata.
destinationReferences[]

string

Facoltativo. Stringa di riferimento utilizzata per determinare a quale dei Event.destination_references deve essere inviata la variabile personalizzata. Se il campo è vuoto, verrà utilizzato Event.destination_references.

ExperimentalField

Campo sperimentale che rappresenta i campi non ufficiali.

Rappresentazione JSON 
{
  "field": string,
  "value": string
}
Campi
field

string

Facoltativo. Il nome del campo da utilizzare.
value

string

Facoltativo. Il valore del campo da impostare.

UserProperties

Informazioni valutate dall'inserzionista sull'utente al momento dell'evento. Per maggiori dettagli, consulta la pagina https://support.google.com/google-ads/answer/14007601.

Rappresentazione JSON 
{
  "customerType": enum (CustomerType),
  "customerValueBucket": enum (CustomerValueBucket)
}
Campi
customerType

enum (CustomerType)

Facoltativo. Tipo di cliente associato all'evento.
customerValueBucket

enum (CustomerValueBucket)

Facoltativo. Il valore del cliente valutato dall'inserzionista.

CustomerType

Tipo di cliente associato all'evento.

Enum
CUSTOMER_TYPE_UNSPECIFIED CustomerType non specificato. Non deve mai essere utilizzato.
NEW Il cliente non ha mai acquistato dall'inserzionista.
RETURNING Il cliente sta tornando all'inserzionista.
REENGAGED Il cliente ha interagito di nuovo con l'inserzionista.

CustomerValueBucket

Il valore del cliente valutato dall'inserzionista.

Enum
CUSTOMER_VALUE_BUCKET_UNSPECIFIED Unspecified CustomerValueBucket. Non deve mai essere utilizzato.
LOW Il cliente ha un valore basso.
MEDIUM Il cliente ha un valore medio.
HIGH Il cliente è di alto valore.