UserData

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

Représentation JSON 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  }
}
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 expirent pendant 540 jours.

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)

Enregistrer 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

Horodatage 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 aucun décalage n'est défini, l'API utilise par défaut le fuseau horaire du compte. 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 avoir multiplié le prix unitaire par article par la quantité indiquée dans ces attributs.
currencyCode

string

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

string

Nom de ressource de l'action de conversion à associer aux rapports sur les conversions. 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

Enregistrer les attributs de la transaction

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

string

Code de magasin à partir de 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, utilisable uniquement 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 aucun décalage n'est défini, l'API utilise par défaut le fuseau horaire du compte.
averagePurchaseCount

integer

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

string (int64 format)

Valeur d'achat moyenne définie par l'annonceur en micro-unités pour l'utilisateur.
acquisitionDateTime

string

Horodatage 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 aucun décalage n'est défini, l'API utilise par défaut le fuseau horaire du compte.
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 aucun décalage n'est défini, l'API utilise par défaut le fuseau horaire du compte.
eventAttribute[]

object (EventAttribute)

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

string (int64 format)

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

integer

Ensemble de valeurs vie client définies par l'annonceur pour l'utilisateur. La plage valide pour un bucket de valeur vie est comprise entre 1 (faible) et 10 (élevé), sauf pour l'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 d'un nombre compris entre 1 et 10, d'une chaîne comme "Or" ou "Argent", ou encore 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ée" 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 aucun décalage n'est défini, l'API utilise par défaut le fuseau horaire du compte.
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).