> 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 spécialisée dans la publicité en ligne, la technologie des moteurs de recherche, le cloud computing et les logiciels informatiques. En tirant parti de la [Google Ads API](https://developers.google.com/google-ads/api/docs/start), vous pouvez tirer parti de la [enhanced conversions](https://support.google.com/google-ads/answer/9888656) fonctionnalité permettant d’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, de manière respectueuse de la confidentialité, des données de conversion First-party hachées depuis votre site Web.

{% hint style="info" %}
Vous devez effectuer les [étapes de configuration et de paramétrage](https://support.google.com/google-ads/answer/11062876) avant de pouvoir relier les enhanced conversions 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 se fait automatiquement, ce qui simplifie la saisie 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 de vos champs définis dans le data layer.

## Configuration de la destination

{% hint style="info" %}
Votre compte utilisateur doit disposer de droits d’administration dans les [Google Ads Manager Accounts](https://ads.google.com/intl/en/home/tools/manager-accounts/) où se trouve l’action de conversion. Lorsque 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 %}

### 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 configurés dans l'interface Commanders Act, comme suit : <code>Administration</code> ➜ <code>Identifiants du connecteur</code> ➜ <code>Ajouter des identifiants du connecteur</code> ➜ <code>Google Ads</code></td></tr><tr><td><code>Mappage</code></td><td><p><em><strong><code>Obligatoire</code></strong></em><br>Faites correspondre les noms de conversion Google Ads, là où les enhanced conversions sont appliquées, avec vos événements en renseignant les champs <code>Nom de conversion Google Ads</code> et <code>Votre nom d'é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 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> à 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 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 les enhanced conversions` ➜ sélectionnez `API` .
{% endhint %}

## Référence rapide

<table><thead><tr><th width="327">Propriétés Commanders Act</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 %}

## Mappages de champs

{% hint style="warning" %}
Au moins 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/région 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 [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:bleue;">`conversionAdjustments.0`</mark> ou <mark style="color:bleue;">`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>value</code></td><td><code>restatementValue.adjustedValue</code></td></tr><tr><td><code>devise</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 automatiquement ajustée. 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:bleue;">`user.email`</mark> est fourni, il est haché à l’aide de SHA256, sinon , <mark style="color:bleue;">`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:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/google/google-enhanced-conversion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.