- Représentation JSON
- TransactionAttribute
- StoreAttribute
- ItemAttribute
- UserAttribute
- ShoppingLoyalty
- EventAttribute
- EventItemAttribute
Données utilisateur contenant des identifiants et des attributs utilisateur.
Représentation JSON |
---|
{ "userIdentifiers": [ { object ( |
Champs | |
---|---|
userIdentifiers[] |
Informations permettant d'identifier l'utilisateur (obligatoire). |
transactionAttribute |
Transactions/attributs supplémentaires associés à l'utilisateur. Obligatoire pour la mise à jour des données de ventes en magasin. |
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 |
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 ( |
Champs | |
---|---|
storeAttribute |
Stocker les attributs de la transaction. Accessible uniquement aux clients figurant sur la liste d'autorisation |
itemAttribute |
Attributs d'article de la transaction. |
transactionDateTime |
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 |
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 |
Code de devise de la transaction. Nous utilisons le code ISO 4217 à trois lettres. Obligatoire. |
conversionAction |
Nom de ressource de l'action de conversion pour laquelle les conversions doivent être comptabilisées. Obligatoire. |
orderId |
ID de commande de la transaction. Accessible uniquement aux clients figurant sur la liste d'autorisation |
customValue |
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 |
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 |
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 |
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 |
Code ISO 639-1 de la langue associée au flux dans lequel vos articles sont importés |
quantity |
Nombre d'articles vendus. Si cette clause n'est pas définie, la valeur par défaut est 1. |
merchantId |
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 ( |
Champs | |
---|---|
lastPurchaseDateTime |
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 |
Nombre moyen d'achats effectués par l'utilisateur sur une période de 30 jours défini par l'annonceur. |
averagePurchaseValueMicros |
Valeur moyenne des achats de l'utilisateur définie par l'annonceur en micros. |
acquisitionDateTime |
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 |
Facultatif. Étape du cycle de vie définie par l'annonceur pour l'utilisateur. Les valeurs acceptées sont "Prospect", "Actif" et "Perdu". |
firstPurchaseDateTime |
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[] |
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 |
Valeur vie client définie par l'annonceur pour l'utilisateur. |
lifetimeValueBucket |
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 |
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 |
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 ( |
Champs | |
---|---|
event |
Obligatoire. Événement défini par l'annonceur à utiliser pour le remarketing. Les valeurs acceptées sont "Consulté", "Panier", "Acheté" et "Recommandé". |
eventDateTime |
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[] |
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 |
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). |