UserData

Données utilisateur contenant des identifiants et des attributs utilisateur.

Représentation JSON 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  },
  "consent": {
    object (Consent)
  }
}
Champs
userIdentifiers[]

object (UserIdentifier)

Informations permettant d'identifier l'utilisateur (obligatoire).
transactionAttribute

object (TransactionAttribute)

Transactions/attributs supplémentaires associés à l'utilisateur. Obligatoire pour la mise à jour des données de ventes en magasin.
userAttribute

object (UserAttribute)

Attributs supplémentaires associés à l'utilisateur. Obligatoire lors de la mise à jour des attributs de ciblage par liste de clients. Ils sont valables pendant 540 jours.
consent

object (Consent)

Paramètre de consentement de l'utilisateur. Le ciblage par liste de clients ignorera ce champ et renverra un avertissement.

TransactionAttribute

Attribut de la transaction de ventes en magasin.

Représentation JSON 
{
  "storeAttribute": {
    object (StoreAttribute)
  },
  "itemAttribute": {
    object (ItemAttribute)
  },
  "transactionDateTime": string,
  "transactionAmountMicros": number,
  "currencyCode": string,
  "conversionAction": string,
  "orderId": string,
  "customValue": string
}
Champs
storeAttribute

object (StoreAttribute)

Stocker les attributs de la transaction. Accessible uniquement aux clients figurant sur la liste d'autorisation
itemAttribute

object (ItemAttribute)

Attributs d'article de la transaction.
transactionDateTime

string

Code temporel de la transaction. Obligatoire. Le format est "AAAA-MM-JJ HH:MM:SS[+/-HH:MM]", où [+/-HH:MM] correspond à un décalage horaire facultatif par rapport à l'UTC. Si le décalage n'est pas défini, l'API utilise le fuseau horaire du compte par défaut. Exemples: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30+03:00"
transactionAmountMicros

number

Montant de la transaction en micros. Obligatoire. Le montant de la transaction en micros doit être supérieur à 1 000. Si des attributs d'article sont fournis, il s'agit de la valeur totale des articles, après multiplication du prix unitaire par article par la quantité indiquée dans ces attributs.
currencyCode

string

Code de devise de la transaction. Nous utilisons le code ISO 4217 à trois lettres. Obligatoire.
conversionAction

string

Nom de ressource de l'action de conversion pour laquelle les conversions doivent être comptabilisées. Obligatoire.
orderId

string

ID de commande de la transaction. Accessible uniquement aux clients figurant sur la liste d'autorisation
customValue

string

Valeur de la variable personnalisée pour chaque transaction. Accessible uniquement aux clients figurant sur la liste d'autorisation

StoreAttribute

Stocker les attributs de la transaction.

Représentation JSON 
{
  "storeCode": string
}
Champs
storeCode

string

Code de magasin sur https://support.google.com/business/answer/3370250#storecode

ItemAttribute

Attributs d'article de la transaction.

Représentation JSON 
{
  "itemId": string,
  "countryCode": string,
  "languageCode": string,
  "quantity": string,
  "merchantId": string
}
Champs
itemId

string

Identifiant unique d'un produit. Il peut s'agir de l'ID de l'article Merchant Center ou du code GTIN (Global Trade Item Number).
countryCode

string

Code CLDR (Common Locale Data Repository) du pays associé au flux dans lequel vos articles sont importés. Pour en savoir plus, consultez la page https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes.
languageCode

string

Code ISO 639-1 de la langue associée au flux dans lequel vos articles sont importés
quantity

string (int64 format)

Nombre d'articles vendus. Si cette clause n'est pas définie, la valeur par défaut est 1.
merchantId

string (int64 format)

ID du compte Merchant Center.

UserAttribute

Attribut utilisateur, ne peut être utilisé qu'avec le type de tâche CUSTOMER_MATCH_WITH_ATTRIBUTES.

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

string

Code temporel du dernier achat effectué par l'utilisateur Le format est AAAA-MM-JJ HH:MM:SS[+/-HH:MM], où [+/-HH:MM] correspond à un décalage horaire facultatif par rapport à l'UTC. Si le décalage n'est pas défini, l'API utilise le fuseau horaire du compte par défaut.
averagePurchaseCount

integer

Nombre moyen d'achats effectués par l'utilisateur sur une période de 30 jours défini par l'annonceur.
averagePurchaseValueMicros

string (int64 format)

Valeur moyenne des achats de l'utilisateur définie par l'annonceur en micros.
acquisitionDateTime

string

Code temporel de l'acquisition de l'utilisateur. Le format est AAAA-MM-JJ HH:MM:SS[+/-HH:MM], où [+/-HH:MM] correspond à un décalage horaire facultatif par rapport à l'UTC. Si le décalage n'est pas défini, l'API utilise le fuseau horaire du compte par défaut.
lifecycleStage

string

Facultatif. Étape du cycle de vie définie par l'annonceur pour l'utilisateur. Les valeurs acceptées sont "Prospect", "Actif" et "Perdu".
firstPurchaseDateTime

string

Facultatif. Code temporel du premier achat effectué par l'utilisateur Le format est AAAA-MM-JJ HH:MM:SS[+/-HH:MM], où [+/-HH:MM] correspond à un décalage horaire facultatif par rapport à l'UTC. Si le décalage n'est pas défini, l'API utilise le fuseau horaire du compte par défaut.
eventAttribute[]

object (EventAttribute)

Facultatif. Événements définis par l'annonceur et leurs attributs Toutes les valeurs des champs imbriqués sont obligatoires. Actuellement, ce champ est en version bêta.
lifetimeValueMicros

string (int64 format)

Valeur vie client définie par l'annonceur pour l'utilisateur.
lifetimeValueBucket

integer

Ensemble de valeur vie définie par l'annonceur pour l'utilisateur. La plage valide pour un bucket de valeur vie est comprise entre 1 (faible) et 10 (élevé), sauf en cas d'opération de suppression où la valeur 0 est également acceptée.
shoppingLoyalty

object (ShoppingLoyalty)

Données liées à la fidélité à un achat. Shopping utilise ces données pour offrir une meilleure expérience aux utilisateurs. Accessible uniquement aux marchands figurant sur la liste d'autorisation, avec le consentement de l'utilisateur

ShoppingLoyalty

Données liées à la fidélité à un achat. Shopping utilise ces données pour offrir une meilleure expérience aux utilisateurs. Accessible uniquement aux marchands figurant sur la liste d'autorisation.

Représentation JSON 
{
  "loyaltyTier": string
}
Champs
loyaltyTier

string

Niveau de souscription. Il s'agit d'une chaîne au format libre, car chaque marchand peut disposer de son propre système de fidélité. Il peut s'agir, par exemple, d'un nombre compris entre 1 et 10, d'une chaîne telle que "Golden" ou "Silver", ou même d'une chaîne vide "".

EventAttribute

Événements définis par l'annonceur et leurs attributs Toutes les valeurs des champs imbriqués sont obligatoires.

Représentation JSON 
{
  "event": string,
  "eventDateTime": string,
  "itemAttribute": [
    {
      object (EventItemAttribute)
    }
  ]
}
Champs
event

string

Obligatoire. Événement défini par l'annonceur à utiliser pour le remarketing. Les valeurs acceptées sont "Consulté", "Panier", "Acheté" et "Recommandé".
eventDateTime

string

Obligatoire. Horodatage de l'événement. Le format est AAAA-MM-JJ HH:MM:SS[+/-HH:MM], où [+/-HH:MM] correspond à un décalage horaire facultatif par rapport à l'UTC. Si le décalage n'est pas défini, l'API utilise le fuseau horaire du compte par défaut.
itemAttribute[]

object (EventItemAttribute)

Obligatoire. Attributs d'élément de l'événement.

EventItemAttribute

Attributs d'élément d'événement du ciblage par liste de clients.

Représentation JSON 
{
  "itemId": string
}
Champs
itemId

string

Facultatif. Identifiant unique d'un produit. Il peut s'agir de l'ID de l'article Merchant Center ou du code GTIN (Global Trade Item Number).