> 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 le [conversions améliorées](https://support.google.com/google-ads/answer/9888656) la 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 les interactions avec les annonces.\
Les conversions améliorées complètent vos tags de conversion existants en envoyant de manière sécurisée, côté confidentialité, des données de conversion First-party hachées depuis votre site Web vers Google.

{% 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 conversions améliorées via Google Ads API.
{% endhint %}

## Fonctionnalités clés

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

* **Structure des événements**: notre [Référence des événements](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 événements s'effectue automatiquement, ce qui simplifie la saisie utilisateur.
* **Hachage automatique**: les informations sont hachées automatiquement conformément aux spécifications du partenaire.
* **Smart mapping**: le mapping 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;">`Conditions relatives aux données client`</mark> dans <mark style="color:bleu;">`Objectifs`</mark> → <mark style="color:bleu;">`Conversions`</mark> → <mark style="color:bleu;">`Paramètres`</mark>\
• Marquer <mark style="color:bleu;">`Activer les conversions améliorées`</mark> dans <mark style="color:bleu;">`Objectifs`</mark> → <mark style="color:bleu;">`Conversions`</mark> → <mark style="color:bleu;">`Paramètres`</mark> → <mark style="color:bleu;">`Conversions améliorées`</mark> .
{% endhint %}

{% hint style="info" %}
Votre compte utilisateur doit disposer de droits d’administrateur dans les [comptes administrateurs Google Ads](https://ads.google.com/intl/en/home/tools/manager-accounts/) où se trouve l’action de conversion. Lorsqu’elle 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;">`Afficher toutes les actions de conversion`</mark> → Sélectionnez votre action de conversion → <mark style="color:bleu;">`Pages Web`</mark> , et consultez la colonne <mark style="color:bleu;">`Valeur totale des conv.`</mark> .
{% endhint %}

### Configuration

<table><thead><tr><th width="357">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Authentification</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Vos identifiants Google Ads, tels que définis dans l’interface Commanders Act, selon ce qui suit : <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>Obligatoire</code></strong></em><br>Associez les noms de conversion Google Ads, pour lesquels les conversions améliorées sont appliquées, à vos événements en définissant 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 se trouvent 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’événement sera ignoré.</p></td></tr><tr><td><code>Google Analytics Property ID</code></td><td>Le GA Tracking ID est une chaîne comme « 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> à partir des 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 conversions améliorées 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 `Conversions améliorées` ➜ marquez `Activer les conversions améliorées` ➜ sélectionnez `API` .
{% endhint %}

## Référence rapide

<table><thead><tr><th width="327">Commanders Act Events</th><th>Google Tracking</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 %}

## Correspondances des champs

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

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

{% hint style="info" %}
Les propriétés peuvent être remappées à l'aide de notre [Mappage intelligent](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> avec ce dernier pour les propriétés utilisateur.
{% endhint %}

<table><thead><tr><th width="334">Propriétés Commanders Act</th><th>Propriétés Google</th></tr></thead><tbody><tr><td><code>id</code></td><td><code>orderId</code> <strong>[*]</strong></td></tr><tr><td><code>context.device.user_agent</code></td><td><code>userAgent</code></td></tr><tr><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</code></td><td><code>restatementValue.adjustedValue</code></td></tr><tr><td><code>currency</code></td><td><code>restatementValue.currencyCode</code></td></tr><tr><td><p><code>user.email</code></p><p><code>user.email_sha256</code></p></td><td><code>hashedEmail</code> <strong>[2]</strong></td></tr><tr><td><code>user.phone</code></td><td><code>hashedPhoneNumber</code> <strong>[3]</strong></td></tr><tr><td><code>user.firstname</code></td><td><code>addressInfo.hashedFirstName</code> <strong>[3]</strong></td></tr><tr><td><code>user.lastname</code></td><td><code>addressInfo.hashedLastName</code> <strong>[3]</strong></td></tr><tr><td><code>user.streetAddress</code></td><td><code>addressInfo.hashedStreetAddress</code> <strong>[3]</strong></td></tr><tr><td><code>user.city</code></td><td><code>addressInfo.city</code></td></tr><tr><td><code>user.state</code></td><td><code>addressInfo.state</code></td></tr><tr><td><code>user.country</code></td><td><code>addressInfo.countryCode</code></td></tr><tr><td><code>user.zipcode</code></td><td><code>addressInfo.postalCode</code></td></tr><tr><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.** Si <mark style="color:bleu;">`user.email`</mark> est fourni, il est haché à l’aide de SHA256, sinon , <mark style="color:bleu;">`user.email_sha256`</mark> est utilisé.\
**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.