> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/google/google-ads-store-sales.md).

# Google Ads Store Sales

{% hint style="info" %}
Cette destination est actuellement en revue finale et sera bientôt disponible.
{% endhint %}

[Google Ads](https://ads.google.com/) 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](https://developers.google.com/data-manager/api) pour envoyer les données d'événements pour [les conversions de ventes en magasin Google Ads](https://support.google.com/google-ads/topic/9941533?db=lindseyvolta).

## 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](https://community.commandersact.com/platform-x/developers/tracking/events-reference) correspond [à la structure d'événements de Google](https://developers.google.com/data-manager/api/reference/rest/v1/events/ingest), 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

{% hint style="warning" %}
Les conversions de ventes en magasin ne sont disponibles que pour les comptes figurant sur une allowlist Google. Plus de détails sont disponibles en suivant ce [LINK](https://support.google.com/google-ads/answer/15885010).
{% endhint %}

### Configuration

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="324">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Identifiants</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Vos identifiants Google Ads tels que définis dans l'interface Commanders Act en suivant : <code>Administration</code> ➜ <code>Identifiants du connecteur</code> ➜ <code>Ajouter des identifiants du connecteur</code> ➜ <code>Google Ads</code></td></tr><tr><td><code>Identifiant de magasin</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>L'identifiant représentant un magasin physique où l'événement a eu lieu. Plus de détails sont disponibles en suivant ce <a href="https://support.google.com/business/answer/3370250#storecode&#x26;zippy=%2Cbusiness-code">LINK</a>.</td></tr><tr><td><code>Mappage</code></td><td><p><em><strong><code>Obligatoire</code></strong></em><br>Associez les noms de conversion Google Ads à vos événements en définissant les champs <code>Nom de conversion Google Ads</code> et <code>le nom de votre événement</code>. Le nom de conversion doit être du type <code>STORE_SALES</code>. Au moins une ligne est requise. Les noms de conversion se trouvent dans l'interface Google Ads en suivant :</p><p><code>Objectifs</code> ➜ <code>Résumé</code> ➜ <code>Action de conversion</code> (colonne)</p></td></tr><tr><td><code>Variables personnalisées</code></td><td>Variable personnalisée pour les conversions publicitaires. Associez votre <code>nom de variable personnalisée</code> à <code>votre valeur</code>. Plus de détails sont disponibles en suivant ce <a href="https://developers.google.com/data-manager/api/reference/rest/v1/events/ingest#CustomVariable">LINK</a>.</td></tr><tr><td><code>Champs expérimentaux</code></td><td>Les champs expérimentaux représentent des champs non officiels. Associez votre <code>nom de champ expérimental</code> à <code>votre valeur</code>. Plus de détails sont disponibles en suivant ce <a href="https://developers.google.com/data-manager/api/reference/rest/v1/events/ingest#ExperimentalField">LINK</a>.</td></tr><tr><td><code>Propriétés utilisateur supplémentaires</code></td><td>Propriétés utilisateur supplémentaires pour l'utilisateur associé à cet événement. Associez votre <code>nom de champ utilisateur</code> à <code>votre valeur</code>. Plus de détails sont disponibles en suivant ce <a href="https://developers.google.com/data-manager/api/reference/rest/v1/events/ingest#UserProperty">LINK</a>.</td></tr><tr><td><code>Identifiants utilisateur de Third-party</code></td><td>Définissez ce indicateur si vos identifiants utilisateur proviennent d'une source Third-party.</td></tr><tr><td><code>Validation uniquement</code></td><td>À 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.</td></tr></tbody></table>

## Mappages de champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l'aide de notre [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#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 : <mark style="color:blue;">`cartData`</mark> propriété d'un événement de ventes en magasin si un élément du <mark style="color:purple;">`cartData`</mark> ne possède pas l'une des propriétés Google suivantes : <mark style="color:blue;">`merchantProductId`</mark> ou <mark style="color:blue;">`unitPrice`</mark>. Plus de détails sont disponibles en suivant ce [LINK](https://developers.google.com/data-manager/api/devguides/events/send-events#google-ads-store-sales).
{% endhint %}

<table data-header-hidden="false" data-header-sticky data-full-width="true"><thead><tr><th width="291">Champs Smart Mapping</th><th width="378">Propriétés par défaut de Commanders Act</th><th>Propriétés Google</th></tr></thead><tbody><tr><td><code>-</code></td><td><code>Identifiant de magasin</code></td><td><code>eventLocation.storeId</code> <strong>[*]</strong></td></tr><tr><td><code>ID de transaction</code></td><td><code>id</code></td><td><code>transactionId</code> <strong>[*][1]</strong></td></tr><tr><td><code>Valeur de transaction</code></td><td><code>value</code></td><td><code>conversionValue</code> <strong>[*][1]</strong></td></tr><tr><td><code>Devise</code></td><td><code>currency</code></td><td><code>currency</code> <strong>[*][1]</strong></td></tr><tr><td><code>Horodatage de l'événement</code></td><td><code>context.event_timestamp</code></td><td><code>eventTimestamp</code> <strong>[1][2]</strong></td></tr><tr><td><code>E-mail de l'utilisateur</code></td><td><code>user.email</code></td><td><code>emailAddress</code> <strong>[3][4]</strong></td></tr><tr><td><code>Téléphone de l'utilisateur</code></td><td><code>user.phone</code></td><td><code>phoneNumber</code> <strong>[3][4]</strong></td></tr><tr><td><code>Prénom de l'utilisateur</code></td><td><code>user.firstname</code></td><td><code>address.givenName</code> <strong>[3][4]</strong></td></tr><tr><td><code>Nom de famille de l'utilisateur</code></td><td><code>user_lastname</code></td><td><code>address.familyName</code> <strong>[3][4]</strong></td></tr><tr><td><code>Pays de l'utilisateur</code></td><td><code>user.country</code></td><td><code>address.regionCode</code> <strong>[3]</strong></td></tr><tr><td><code>Code postal de l'utilisateur</code></td><td><code>user.zipcode</code></td><td><code>address.postalCode</code> <strong>[3]</strong></td></tr><tr><td><code>Consent adUserData</code></td><td><code>partners.google.consent_ad_user_data</code></td><td><code>consent.adUserData</code> <strong>[5]</strong></td></tr><tr><td><code>Consent adPersonalization</code></td><td><code>partners.google.consent_ad_pers</code></td><td><code>consent.adPersonalization</code> <strong>[5]</strong></td></tr><tr><td><code>Identifiant marchand</code></td><td><code>partners.google.merchant_id</code></td><td><code>merchantId</code> <strong>[6]</strong></td></tr><tr><td><code>Libellé du flux marchand</code></td><td><code>partners.google.merchant_feed_label</code></td><td><code>merchantFeedLabel</code> <strong>[6]</strong></td></tr><tr><td><code>Code langue du flux marchand</code></td><td><code>partners.google.merchant_feed_lang_code</code></td><td><code>merchantFeedLanguageCode</code> <strong>[6]</strong></td></tr><tr><td><code>Remise de transaction</code></td><td><code>discount_value</code></td><td><code>transactionDiscount</code> <strong>[6]</strong></td></tr><tr><td><code>Liste d'articles</code></td><td><code>items</code></td><td><code>items</code> <strong>[6]</strong></td></tr><tr><td><code>ID produit marchand</code></td><td><code>items.X.product.id</code></td><td><code>merchantProductId</code> <strong>[7][8]</strong></td></tr><tr><td><code>Quantité</code></td><td><code>items.X.quantity</code></td><td><code>quantity</code> <strong>[7][9]</strong></td></tr><tr><td><code>Prix</code></td><td><code>items.x.product.price</code></td><td><code>unitPrice</code> <strong>[7][10]</strong></td></tr><tr><td><code>Valeur de conversion</code></td><td><code>items.x.product.conv_value</code></td><td><code>conversionValue</code> <strong>[7][11]</strong></td></tr><tr><td><code>-</code></td><td><code>Variables personnalisées</code></td><td><code>customVariables.X.value</code> <strong>[12]</strong></td></tr><tr><td><code>-</code></td><td><code>Champs expérimentaux</code></td><td><code>experimentalFields.X.value</code> <strong>[13]</strong></td></tr><tr><td><code>Type de client</code></td><td><code>partners.google.customer_type</code></td><td><code>customerType</code> <strong>[14][15]</strong></td></tr><tr><td><code>Tranche de valeur client</code></td><td><code>partners.google.customer_value_bucket</code></td><td><code>customerValueBucket</code> <strong>[14]</strong></td></tr><tr><td><code>-</code></td><td><code>Propriétés utilisateur supplémentaires</code></td><td><code>additionalUserProperties.X.value</code> <strong>[14][16]</strong></td></tr><tr><td><code>ID utilisateur</code></td><td><code>user.id</code></td><td><code>userId</code></td></tr><tr><td><code>Ville</code></td><td><code>partners.google.city</code></td><td><code>city</code> <strong>[17]</strong></td></tr><tr><td><code>Code de subdivision</code></td><td><code>partners.google.subdiv_code</code></td><td><code>subdivisionCode</code> <strong>[17]</strong></td></tr><tr><td><code>Code de région</code></td><td><code>partners.google.region_code</code></td><td><code>regionCode</code> <strong>[17]</strong></td></tr><tr><td><code>Code de sous-continent</code></td><td><code>partners.google.subcont_code</code></td><td><code>subcontinentCode</code> <strong>[17]</strong></td></tr><tr><td><code>Code de continent</code></td><td><code>partners.google.cont_code</code></td><td><code>continentCode</code> <strong>[17]</strong></td></tr></tbody></table>

{% hint style="info" %}
**\*** Propriété obligatoire.\
**1.** Défini dans <mark style="color:blue;">`events.X`</mark> .\
**2.** S'il n'est pas transmis, l'horodatage actuel est utilisé.\
**3.** Défini dans <mark style="color:blue;">`events.X.userData.userIndentifiers.X`</mark> .\
**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 <mark style="color:blue;">`Consent adUserData`</mark> et <mark style="color:blue;">`Consent adPersonalization`</mark> ont priorité sur le consentement transmis via client-side.\
**6.** Défini dans <mark style="color:blue;">`cartData`</mark> .\
**7.** Défini dans <mark style="color:blue;">`cartData.items.X`</mark> .\
**8.** Le [identifiant du produit](https://developers.google.com/data-manager/api/devguides/events/send-events#google-ads-store-sales) au sein du compte Merchant Center. Plus de détails sont disponibles en suivant ce [LINK](https://developers.google.com/data-manager/api/devguides/events/send-events#google-ads-store-sales).\
**9.** Valeur par défaut si non définie : <mark style="color:blue;">`1`</mark> .\
**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 <mark style="color:blue;">`27.67`</mark> et une remise unitaire de <mark style="color:blue;">`6.66`</mark>, alors définissez unitPrice à <mark style="color:blue;">`21.01`</mark>.\
**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 <mark style="color:blue;">`10.00`</mark> chacun, définissez ceci avec <mark style="color:blue;">`10.00`</mark> et la quantité à <mark style="color:blue;">`2`</mark>. Notez que bien que ce champ soit facultatif pour les articles individuels, le <mark style="color:blue;">`Valeur de transaction`</mark> champ Smart Mapping est requis.\
**12.** Voir <mark style="color:blue;">`Variables personnalisées`</mark> dans [Configuration](#configuration) pour plus de détails.\
**13.** Voir <mark style="color:blue;">`Champs expérimentaux`</mark> dans [Configuration](#configuration) pour plus de détails.\
**14.** Défini dans <mark style="color:blue;">`userProperties`</mark> .\
**15.** Ceci est automatiquement défini si la propriété <mark style="color:blue;">`user.status`</mark> est renseignée avec les informations appropriées. Le champ "Smart Mapping" <mark style="color:blue;">`Source de l'événement`</mark> a priorité sur <mark style="color:blue;">`user.status`</mark>.\
**16.** Voir <mark style="color:blue;">`Propriétés utilisateur supplémentaires`</mark> dans [Configuration](#configuration) pour plus de détails.\
**17.** Défini dans <mark style="color:blue;">`eventLocation`</mark> .
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/google/google-ads-store-sales.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.