UserData

Dati utente che contengono attributi e identificatori utente.

Rappresentazione JSON 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  }
}
Campi
userIdentifiers[]

object (UserIdentifier)

Informazioni di identificazione dell'utente. Obbligatorie.
transactionAttribute

object (TransactionAttribute)

Transazioni/attributi aggiuntivi associati all'utente. Obbligatorio quando aggiorni i dati delle vendite in negozio.
userAttribute

object (UserAttribute)

Attributi aggiuntivi associati all'utente. Obbligatorio quando aggiorni gli attributi Customer Match. che hanno una scadenza di 540 giorni.

TransactionAttribute

Attributo della transazione di vendita in negozio.

Rappresentazione JSON 
{
  "storeAttribute": {
    object (StoreAttribute)
  },
  "itemAttribute": {
    object (ItemAttribute)
  },
  "transactionDateTime": string,
  "transactionAmountMicros": number,
  "currencyCode": string,
  "conversionAction": string,
  "orderId": string,
  "customValue": string
}
Campi
storeAttribute

object (StoreAttribute)

Archivia gli attributi della transazione. Accessibile solo ai clienti nella lista consentita.
itemAttribute

object (ItemAttribute)

Attributi articolo della transazione.
transactionDateTime

string

Timestamp del momento in cui si è verificata la transazione. Obbligatorio. Il formato è "AAAA-MM-GG HH:MM:SS[+/-HH:MM]", dove [+/-HH:MM] è la differenza facoltativa di fuso orario rispetto al fuso orario UTC. Se l'offset non è presente, l'API utilizzerà per impostazione predefinita il fuso orario dell'account. Esempi: "2018-03-05 09:15:00" o "2018-02-01 14:34:30+03:00"
transactionAmountMicros

number

Importo della transazione in micro. Obbligatorio. L'importo della transazione in micro deve essere maggiore di 1000. Se vengono forniti gli attributi articolo, questo valore rappresenta il valore totale degli articoli dopo aver moltiplicato il prezzo unitario per articolo per la quantità fornita negli attributi degli articoli.
currencyCode

string

Codice valuta della transazione. Viene utilizzato il codice di tre lettere ISO 4217. Obbligatorio.
conversionAction

string

Il nome della risorsa dell'azione di conversione in cui registrare le conversioni. Obbligatorio.
orderId

string

ID ordine transazione. Accessibile solo ai clienti nella lista consentita.
customValue

string

Valore della variabile personalizzata per ogni transazione. Accessibile solo ai clienti nella lista consentita.

StoreAttribute

Archivia gli attributi della transazione.

Rappresentazione JSON 
{
  "storeCode": string
}
Campi
storeCode

string

Codice negozio da https://support.google.com/business/answer/3370250#storecode

ItemAttribute

Attributi articolo della transazione.

Rappresentazione JSON 
{
  "itemId": string,
  "countryCode": string,
  "languageCode": string,
  "quantity": string,
  "merchantId": string
}
Campi
itemId

string

Identificatore univoco di un prodotto. Può essere l'ID articolo di Merchant Center o il GTIN (Global Trade Item Number).
countryCode

string

Il codice del territorio CLDR (Common Local Data Repository) del paese associato al feed nel quale vengono caricati i tuoi articoli. Per saperne di più, consulta la pagina https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes.
languageCode

string

Codice ISO 639-1 della lingua associata al feed nel quale vengono caricati i tuoi articoli
quantity

string (int64 format)

Il numero di articoli venduti. Se non impostato, il valore predefinito è 1.
merchantId

string (int64 format)

ID dell'account Merchant Center.

UserAttribute

Attributo utente che può essere utilizzato solo con il tipo di prestazione CUSTOMER_MATCH_WITH_ATTRIBUTES.

Rappresentazione JSON 
{
  "lastPurchaseDateTime": string,
  "averagePurchaseCount": integer,
  "averagePurchaseValueMicros": string,
  "acquisitionDateTime": string,
  "lifecycleStage": string,
  "firstPurchaseDateTime": string,
  "eventAttribute": [
    {
      object (EventAttribute)
    }
  ],
  "lifetimeValueMicros": string,
  "lifetimeValueBucket": integer,
  "shoppingLoyalty": {
    object (ShoppingLoyalty)
  }
}
Campi
lastPurchaseDateTime

string

Timestamp dell'ultimo acquisto effettuato dall'utente. Il formato è AAAA-MM-GG HH:MM:SS[+/-HH:MM], dove [+/-HH:MM] è la differenza facoltativa di fuso orario rispetto al fuso orario UTC. Se l'offset non è presente, l'API utilizzerà per impostazione predefinita il fuso orario dell'account.
averagePurchaseCount

integer

Il numero medio di acquisti effettuati dall'utente in un periodo di 30 giorni è stato definito dall'inserzionista.
averagePurchaseValueMicros

string (int64 format)

L'inserzionista ha definito il valore di acquisto medio in micro per l'utente.
acquisitionDateTime

string

Timestamp del momento in cui l'utente è stato acquisito. Il formato è AAAA-MM-GG HH:MM:SS[+/-HH:MM], dove [+/-HH:MM] è la differenza facoltativa di fuso orario rispetto al fuso orario UTC. Se l'offset non è presente, l'API utilizzerà per impostazione predefinita il fuso orario dell'account.
lifecycleStage

string

Campo facoltativo. L'inserzionista ha definito la fase del ciclo di vita dell'utente. I valori accettati sono "Lead", "Active" e "Churned".
firstPurchaseDateTime

string

Campo facoltativo. Timestamp del primo acquisto effettuato dall'utente. Il formato è AAAA-MM-GG HH:MM:SS[+/-HH:MM], dove [+/-HH:MM] è la differenza facoltativa di fuso orario rispetto al fuso orario UTC. Se l'offset non è presente, l'API utilizzerà per impostazione predefinita il fuso orario dell'account.
eventAttribute[]

object (EventAttribute)

Campo facoltativo. Gli eventi definiti dall'inserzionista e i relativi attributi. Tutti i valori nei campi nidificati sono obbligatori. Al momento questo campo è in versione beta.
lifetimeValueMicros

string (int64 format)

Il lifetime value definito dall'inserzionista per l'utente.
lifetimeValueBucket

integer

Bucket value value definito dall'inserzionista per l'utente. L'intervallo valido per un bucket con lifetime value va da 1 (basso) a 10 (alto), tranne per l'operazione di rimozione in cui è accettato anche 0.
shoppingLoyalty

object (ShoppingLoyalty)

I dati relativi alla fedeltà a Shopping. Shopping utilizza questi dati per offrire agli utenti un'esperienza migliore. Accessibile solo ai commercianti nella lista consentita con il consenso dell'utente.

ShoppingLoyalty

I dati relativi alla fedeltà a Shopping. Shopping utilizza questi dati per offrire agli utenti un'esperienza migliore. Accessibile solo ai commercianti nella lista consentita.

Rappresentazione JSON 
{
  "loyaltyTier": string
}
Campi
loyaltyTier

string

Il livello dell'abbonamento. Si tratta di una stringa in formato libero, in quanto ogni commerciante può avere il proprio sistema fedeltà. Ad esempio, potrebbe essere un numero compreso tra 1 e 10, una stringa come "Golden" o "Silver" o anche la stringa vuota "".

EventAttribute

Gli eventi definiti dall'inserzionista e i relativi attributi. Tutti i valori nei campi nidificati sono obbligatori.

Rappresentazione JSON 
{
  "event": string,
  "eventDateTime": string,
  "itemAttribute": [
    {
      object (EventItemAttribute)
    }
  ]
}
Campi
event

string

Obbligatorio. Evento definito dall'inserzionista da utilizzare per il remarketing. I valori accettati sono "Visualizzato", "Carrello", "Acquistato" e "Consigliato".
eventDateTime

string

Obbligatorio. Timestamp in cui si è verificato l'evento. Il formato è AAAA-MM-GG HH:MM:SS[+/-HH:MM], dove [+/-HH:MM] è la differenza facoltativa di fuso orario rispetto al fuso orario UTC. Se l'offset non è presente, l'API utilizzerà per impostazione predefinita il fuso orario dell'account.
itemAttribute[]

object (EventItemAttribute)

Obbligatorio. Attributi elemento dell'evento.

EventItemAttribute

Attributi elemento evento di Customer Match.

Rappresentazione JSON 
{
  "itemId": string
}
Campi
itemId

string

Campo facoltativo. Identificatore univoco di un prodotto. Può essere l'ID articolo di Merchant Center o il GTIN (Global Trade Item Number).