> 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-enhanced-conversion.md).

# Google Enhanced Conversions

[Google ](https://about.google/)est une entreprise technologique multinationale qui se concentre sur la publicité en ligne, la technologie des moteurs de recherche, le cloud computing et les logiciels. En tirant parti de la [Google Ads API](https://developers.google.com/google-ads/api/docs/start), vous pouvez exploiter la [enhanced conversions](https://support.google.com/google-ads/answer/9888656) fonctionnalité pour envoyer des données First-party sous forme d’ajustements de conversion. Google utilise ces données supplémentaires pour améliorer le reporting de vos conversions en ligne générées par des interactions publicitaires.\
Les enhanced conversions complètent vos balises de conversion existantes en envoyant à Google des données de conversion First-party hachées depuis votre site web, de manière respectueuse de la confidentialité.

{% hint style="info" %}
Vous devez terminer les [étapes de configuration et de paramétrage](https://support.google.com/google-ads/answer/11062876) avant de pouvoir relier les enhanced conversions via l’API Google Ads.
{% endhint %}

## Fonctionnalités clés

La destination Google Enhanced Conversions offre les fonctionnalités clés suivantes :

* **Structure Events**: notre [référence Events](https://community.commandersact.com/platform-x/developers/tracking/events-reference) prend en charge la méthode Google [uploadConversionAdjustments](https://developers.google.com/google-ads/api/reference/rpc/v20/ConversionAdjustmentUploadService/UploadConversionAdjustments?transport=rest), 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 events se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Smart Mapping**: le mappage des données peut être réajusté à l’aide des champs définis dans votre datalayer.

## Configuration de la destination

{% hint style="warning" %}
Dans [Google Ads](https://ads.google.com/), vous devez effectuer les actions suivantes :\
• Accepter <mark style="color:bleu;">`les conditions relatives aux données clients`</mark> sous <mark style="color:bleu;">`Objectifs`</mark> → <mark style="color:bleu;">`Conversions`</mark> → <mark style="color:bleu;">`Paramètres`</mark>\
• Cocher <mark style="color:bleu;">`Activer enhanced conversions`</mark> sous <mark style="color:bleu;">`Objectifs`</mark> → <mark style="color:bleu;">`Conversions`</mark> → <mark style="color:bleu;">`Paramètres`</mark> → <mark style="color:bleu;">`enhanced conversions`</mark> .
{% endhint %}

{% hint style="info" %}
Votre compte utilisateur doit disposer des droits d’administration dans les [comptes Google Ads Manager](https://ads.google.com/intl/en/home/tools/manager-accounts/) où se trouve l’action de conversion. Lorsqu’il est disponible, cette destination inclura également la [`gclid`](https://support.google.com/google-ads/answer/9744275?hl=en) valeur en recherchant les cookies suivants dans cet ordre de priorité :

1. `_gcl_aw`
2. `_gcl_dc`
3. `_gac_[GA_PROPERTY_ID]`
   {% endhint %}

{% hint style="info" %}
Les rapports Google Ads affichent les valeurs mises à jour/ajustées après **24/48 heures**. Par exemple, vous pouvez consulter la section <mark style="color:bleu;">`Objectifs`</mark> → <mark style="color:bleu;">`Conversions`</mark> → <mark style="color:bleu;">`Résumé`</mark> → <mark style="color:bleu;">`Voir toutes les actions de conversion`</mark> → Sélectionnez votre action de conversion → <mark style="color:bleu;">`Pages web`</mark> , et voir la colonne <mark style="color:bleu;">`Valeur conv. totale`</mark> .
{% endhint %}

### Configuration

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="357">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Authentification</code></td><td><em><strong><code>Requise</code></strong></em><br>Vos identifiants Google Ads tels que définis dans l’interface Commanders Act selon : <code>Administration</code> ➜ <code>Identifiants du connecteur</code> ➜ <code>Ajouter des identifiants de connecteur</code> ➜ <code>Google Ads</code></td></tr><tr><td><code>Mappage</code></td><td><p><em><strong><code>Requise</code></strong></em><br>Associez vos noms de conversion Google Ads, là où les enhanced conversions sont appliquées, à vos events en renseignant les champs <code>Nom de conversion Google Ads</code> et <code>Nom de votre événement</code> . Au moins une ligne est requise. Les noms de conversion peuvent être trouvés dans l’interface Google Ads en suivant :</p><p><code>Objectifs</code> ➜ <code>Résumé</code> ➜ <code>Action de conversion</code> (colonne) <strong>[1]</strong><br>Si aucune action de conversion n’est trouvée, l’event sera ignoré.</p></td></tr><tr><td><code>ID de la propriété Google Analytics</code></td><td>L’ID de suivi GA est une chaîne du type "UA-XXXXXX-Y" ou "G-XXXXXXXXXX" pour Google Analytics 4. Il est utilisé comme méthode alternative pour récupérer le <a href="https://support.google.com/google-ads/answer/9744275?hl=en"><code>gclid</code></a> depuis les cookies. Voir <a href="#destination-setup">Configuration de la destination</a> pour plus de détails.</td></tr></tbody></table>

{% hint style="info" %}
**1.** Les enhanced conversions doivent être activées pour votre action de conversion. Cela se fait dans l’interface Google Ads en suivant ces étapes : cliquez sur l’action de conversion ➜ développez `enhanced conversions` ➜ cochez `Activer enhanced conversions` ➜ sélectionnez `API` .
{% endhint %}

## Référence rapide

<table><thead><tr><th width="327">Events de Commanders Act</th><th>Suivi Google</th></tr></thead><tbody><tr><td><code>[Tout événement]</code> <strong>[1]</strong></td><td><code>customers.uploadConversionAdjustments</code></td></tr></tbody></table>

{% hint style="info" %}
**1.** Voir [Mappage](#configuration) pour plus de détails.
{% endhint %}

## Mappages de champs

{% hint style="warning" %}
Au moins l’un des identifiants suivants doit être fourni :

* E-mail utilisateur
* Téléphone utilisateur
* Prénom utilisateur
* Nom de famille utilisateur
* Adresse postale utilisateur
* Ville utilisateur
* État utilisateur
* Pays utilisateur
* Code postal utilisateur
  {% endhint %}

{% 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é.\
Les propriétés Google sont définies à partir du chemin <mark style="color:bleu;">`conversionAdjustments.0`</mark> ou <mark style="color:bleu;">`conversionAdjustments.0.userIdentifiers.X`</mark> pour les propriétés utilisateur.
{% endhint %}

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="284">Champs Smart Mapping</th><th width="300">Propriétés par défaut de Commanders Act</th><th>Propriétés Google</th></tr></thead><tbody><tr><td><code>ID de transaction</code></td><td><code>id</code></td><td><code>orderId</code> <strong>[*]</strong></td></tr><tr><td><code>Agent utilisateur de l’appareil</code></td><td><code>context.device.user_agent</code></td><td><code>userAgent</code></td></tr><tr><td><code>Horodatage de l’événement</code></td><td><code>event_timestamp</code></td><td><code>gclidDateTimePair.conversionDateTime</code> <strong>[1]</strong><br><code>adjustmentDateTime</code> <strong>[1]</strong></td></tr><tr><td><code>Valeur de la transaction</code></td><td><code>value</code></td><td><code>restatementValue.adjustedValue</code></td></tr><tr><td><code>Devise</code></td><td><code>currency</code></td><td><code>restatementValue.currencyCode</code></td></tr><tr><td><code>E-mail utilisateur</code></td><td><code>user.email</code></td><td><code>hashedEmail</code> <strong>[2]</strong></td></tr><tr><td><code>Téléphone utilisateur</code></td><td><code>user.phone</code></td><td><code>hashedPhoneNumber</code> <strong>[3]</strong></td></tr><tr><td><code>Prénom utilisateur</code></td><td><code>user.firstname</code></td><td><code>addressInfo.hashedFirstName</code> <strong>[3]</strong></td></tr><tr><td><code>Nom de famille utilisateur</code></td><td><code>user.lastname</code></td><td><code>addressInfo.hashedLastName</code> <strong>[3]</strong></td></tr><tr><td><code>Adresse utilisateur</code></td><td><code>user.streetAddress</code></td><td><code>addressInfo.hashedStreetAddress</code> <strong>[3]</strong></td></tr><tr><td><code>Ville utilisateur</code></td><td><code>user.city</code></td><td><code>addressInfo.city</code></td></tr><tr><td><code>État utilisateur</code></td><td><code>user.state</code></td><td><code>addressInfo.state</code></td></tr><tr><td><code>Pays utilisateur</code></td><td><code>user.country</code></td><td><code>addressInfo.countryCode</code></td></tr><tr><td><code>Code postal utilisateur</code></td><td><code>user.zipcode</code></td><td><code>addressInfo.postalCode</code></td></tr><tr><td><code>-</code></td><td><code>cookie _gcl_aw</code><br><code>cookie _gcl_dc</code><br><code>cookie _gac_[GA_PROPERTY_ID]</code></td><td><code>gclidDateTimePair.gclid</code> <strong>[4]</strong></td></tr></tbody></table>

{% hint style="info" %}
**\*** Propriété obligatoire.\
**1.** Cette valeur est ajustée automatiquement. Voir [GclidDateTimePair](https://developers.google.com/google-ads/api/rest/reference/rest/v11/customers/uploadConversionAdjustments#gcliddatetimepair) pour plus de détails.\
**2.** Haché automatiquement s’il est fourni en texte brut. Propriétés par défaut : <mark style="color:bleu;">`user.email`</mark> et <mark style="color:bleu;">`user.email_sha256`</mark> dans cet ordre présenté.\
**3.** Normalisé et haché via SHA256.\
**4.** Voir [Configuration de la destination](#destination-setup) pour plus de détails.
{% 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-enhanced-conversion.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.