For the complete documentation index, see llms.txt. This page is also available as Markdown.

Google Ads Store Sales

Cette destination est actuellement en revue finale et sera bientôt disponible.

Google Ads est une plateforme de publicité en ligne où les entreprises paient pour diffuser leurs annonces dans l'écosystème de Google, principalement dans les résultats de recherche, les sites web, les applications et les vidéos. En utilisant cette destination, vous pouvez exploiter Data Manager API pour envoyer les données d'événements pour les conversions de ventes en magasin Google Ads.

Fonctionnalités clés

La destination Google Ads Store Sales fournit les fonctionnalités clés suivantes :

  • Structure des événements: notre modèle de référence des événements correspond à la structure d'événements de Google, ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.

  • Mappages prédéfinis: le mappage des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie les saisies utilisateur.

  • Hachage automatique: les informations sont automatiquement hachées conformément aux spécifications du partenaire.

  • Propriétés personnalisées: vous pouvez envoyer librement des propriétés personnalisées selon vos besoins spécifiques.

  • Smart Mapping: le mappage des données peut être réajusté à l'aide de vos champs définis dans votre data layer.

  • Prise en charge du mode batch: plusieurs événements sont envoyés avec une seule requête, au lieu d'un par un.

Configuration de la destination

Configuration

Paramètres
Description

Identifiants

Obligatoire Vos identifiants Google Ads tels que définis dans l'interface Commanders Act en suivant : AdministrationIdentifiants du connecteurAjouter des identifiants du connecteurGoogle Ads

Identifiant de magasin

Obligatoire L'identifiant représentant un magasin physique où l'événement a eu lieu. Plus de détails sont disponibles en suivant ce LINK.

Mappage

Obligatoire Associez les noms de conversion Google Ads à vos événements en définissant les champs Nom de conversion Google Ads et le nom de votre événement. Le nom de conversion doit être du type STORE_SALES. Au moins une ligne est requise. Les noms de conversion se trouvent dans l'interface Google Ads en suivant :

ObjectifsRésuméAction de conversion (colonne)

Variables personnalisées

Variable personnalisée pour les conversions publicitaires. Associez votre nom de variable personnalisée à votre valeur. Plus de détails sont disponibles en suivant ce LINK.

Champs expérimentaux

Les champs expérimentaux représentent des champs non officiels. Associez votre nom de champ expérimental à votre valeur. Plus de détails sont disponibles en suivant ce LINK.

Propriétés utilisateur supplémentaires

Propriétés utilisateur supplémentaires pour l'utilisateur associé à cet événement. Associez votre nom de champ utilisateur à votre valeur. Plus de détails sont disponibles en suivant ce LINK.

Identifiants utilisateur de Third-party

Définissez ce indicateur si vos identifiants utilisateur proviennent d'une source Third-party.

Validation uniquement

À des fins de test. Si cette option est cochée, la requête est validée mais non exécutée. Seules les erreurs sont renvoyées, pas les résultats.

Mappages de champs

Les propriétés peuvent être remappées à l'aide de notre Smart Mapping fonctionnalité. L'API Data Manager supprime actuellement l'intégralité de la propriété blue cartData d'un événement de ventes en magasin si un élément du purple ne possède pas l'une des propriétés Google suivantes : cartData propriété d'un événement de ventes en magasin si un élément du cartData ne possède pas l'une des propriétés Google suivantes : merchantProductId ou unitPrice. Plus de détails sont disponibles en suivant ce LINK.

Champs Smart Mapping
Propriétés par défaut de Commanders Act
Propriétés Google

-

Identifiant de magasin

eventLocation.storeId [*]

ID de transaction

id

transactionId [*][1]

Valeur de transaction

value

conversionValue [*][1]

Devise

currency

currency [*][1]

Horodatage de l'événement

context.event_timestamp

eventTimestamp [1][2]

E-mail de l'utilisateur

user.email

emailAddress [3][4]

Téléphone de l'utilisateur

user.phone

phoneNumber [3][4]

Prénom de l'utilisateur

user.firstname

address.givenName [3][4]

Nom de famille de l'utilisateur

user_lastname

address.familyName [3][4]

Pays de l'utilisateur

user.country

address.regionCode [3]

Code postal de l'utilisateur

user.zipcode

address.postalCode [3]

Consent adUserData

partners.google.consent_ad_user_data

consent.adUserData [5]

Consent adPersonalization

partners.google.consent_ad_pers

consent.adPersonalization [5]

Identifiant marchand

partners.google.merchant_id

merchantId [6]

Libellé du flux marchand

partners.google.merchant_feed_label

merchantFeedLabel [6]

Code langue du flux marchand

partners.google.merchant_feed_lang_code

merchantFeedLanguageCode [6]

Remise de transaction

discount_value

transactionDiscount [6]

Liste d'articles

items

items [6]

ID produit marchand

items.X.product.id

merchantProductId [7][8]

Quantité

items.X.quantity

quantity [7][9]

Prix

items.x.product.price

unitPrice [7][10]

Valeur de conversion

items.x.product.conv_value

conversionValue [7][11]

-

Variables personnalisées

customVariables.X.value [12]

-

Champs expérimentaux

experimentalFields.X.value [13]

Type de client

partners.google.customer_type

customerType [14][15]

Tranche de valeur client

partners.google.customer_value_bucket

customerValueBucket [14]

-

Propriétés utilisateur supplémentaires

additionalUserProperties.X.value [14][16]

ID utilisateur

user.id

userId

Ville

partners.google.city

city [17]

Code de subdivision

partners.google.subdiv_code

subdivisionCode [17]

Code de région

partners.google.region_code

regionCode [17]

Code de sous-continent

partners.google.subcont_code

subcontinentCode [17]

Code de continent

partners.google.cont_code

continentCode [17]

* Propriété obligatoire. 1. Défini dans events.X . 2. S'il n'est pas transmis, l'horodatage actuel est utilisé. 3. Défini dans events.X.userData.userIndentifiers.X . 4. S'il est défini en clair, il est automatiquement normalisé et haché via SHA256. 5. Ceci est automatiquement défini si le consentement est transmis via client-side. Les champs Smart Mapping Consent adUserData et Consent adPersonalization ont priorité sur le consentement transmis via client-side. 6. Défini dans cartData . 7. Défini dans cartData.items.X . 8. Le identifiant du produit au sein du compte Merchant Center. Plus de détails sont disponibles en suivant ce LINK. 9. Valeur par défaut si non définie : 1 . 10. Le prix unitaire hors taxes, frais de livraison et toute remise au niveau de la transaction. Si l'article bénéficie d'une remise spécifique à l'article, utilisez le prix unitaire remisé. Par exemple, si un article a un prix unitaire de 27.67 et une remise unitaire de 6.66, alors définissez unitPrice à 21.01. 11. La valeur de conversion pour une seule unité de cet article. Par exemple, si deux unités d'un article sont achetées pour 10.00 chacun, définissez ceci avec 10.00 et la quantité à 2. Notez que bien que ce champ soit facultatif pour les articles individuels, le Valeur de transaction champ Smart Mapping est requis. 12. Voir Variables personnalisées dans Configuration pour plus de détails. 13. Voir Champs expérimentaux dans Configuration pour plus de détails. 14. Défini dans userProperties . 15. Ceci est automatiquement défini si la propriété user.status est renseignée avec les informations appropriées. Le champ "Smart Mapping" Source de l'événement a priorité sur user.status. 16. Voir Propriétés utilisateur supplémentaires dans Configuration pour plus de détails. 17. Défini dans eventLocation .

Mis à jour

Ce contenu vous a-t-il été utile ?