UserData

Dati utente che contengono identificatori e attributi utente.

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

object (UserIdentifier)

Informazioni che consentono l'identificazione dell'utente. Obbligatorie.
transactionAttribute

object (TransactionAttribute)

Attributi o transazioni 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. Questi ultimi scadono di 540 giorni.
consent

object (Consent)

L'impostazione del consenso per l'utente. Customer Match ignorerà questo campo e restituirà un avviso.

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 inclusi nella lista consentita.
itemAttribute

object (ItemAttribute)

Attributi degli articoli 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] indica la differenza opzionale del fuso orario rispetto al fuso orario UTC. Se l'offset non è presente, l'API utilizzerà il fuso orario dell'account come predefinito. 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 superiore a 1000. Se gli attributi degli articoli vengono forniti, rappresenta il valore totale degli articoli, dopo aver moltiplicato il prezzo unitario per articolo per la quantità specificata in ItemAttributes.
currencyCode

string

Codice valuta della transazione. Viene utilizzato il codice a tre lettere ISO 4217. obbligatorio.
conversionAction

string

Il nome della risorsa dell'azione di conversione per cui registrare le conversioni. obbligatorio.
orderId

string

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

string

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

StoreAttribute

Archivia gli attributi della transazione.

Rappresentazione JSON 
{
  "storeCode": string
}
Campi
storeCode

string

Codice negozio indicato all'indirizzo https://support.google.com/business/answer/3370250#storecode

ItemAttribute

Attributi degli articoli della transazione.

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

string

L'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 Locale Data Repository) del paese associato al feed nel quale vengono caricati gli 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, 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] indica la differenza facoltativa del fuso orario rispetto al fuso orario UTC. Se l'offset non è presente, l'API utilizzerà il fuso orario dell'account come predefinito.
averagePurchaseCount

integer

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

string (int64 format)

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

string

Timestamp dell'acquisizione dell'utente. Il formato è AAAA-MM-GG HH:MM:SS[+/-HH:MM], dove [+/-HH:MM] indica la differenza facoltativa del fuso orario rispetto al fuso orario UTC. Se l'offset non è presente, l'API utilizzerà il fuso orario dell'account come predefinito.
lifecycleStage

string

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

string

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

object (EventAttribute)

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

string (int64 format)

Lifetime value definito dall'inserzionista per l'utente.
lifetimeValueBucket

integer

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

object (ShoppingLoyalty)

I dati relativi ai programmi fedeltà per gli acquisti. 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 ai programmi fedeltà per gli acquisti. 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 una stringa vuota "".

EventAttribute

Eventi definiti dall'inserzionista e 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 del momento in cui si è verificato l'evento. Il formato è AAAA-MM-GG HH:MM:SS[+/-HH:MM], dove [+/-HH:MM] indica la differenza facoltativa del fuso orario rispetto al fuso orario UTC. Se l'offset non è presente, l'API utilizzerà il fuso orario dell'account come predefinito.
itemAttribute[]

object (EventItemAttribute)

obbligatorio. Attributi elemento dell'evento.

EventItemAttribute

Attributi elemento evento di Customer Match.

Rappresentazione JSON 
{
  "itemId": string
}
Campi
itemId

string

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