# 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. En tirant parti du [Google Ads API](https://developers.google.com/google-ads/api/docs/start), vous pouvez exploiter la fonctionnalité de [conversions améliorées](https://support.google.com/google-ads/answer/9888656) pour envoyer des données first-party sous la 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 pour la 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 le Google Ads API.
{% endhint %}

## Fonctionnalités clés

La destination Google Enhanced Conversions fournit les principales fonctionnalité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 les é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.
* **Mappage intelligent**: le mappage des données peut être réajusté à l'aide des champs définis dans votre datalayer.

## Configuration de la destination

{% hint style="info" %}
Votre compte utilisateur doit disposer des droits d'administrateur dans les [Google Ads Manager Accounts](https://ads.google.com/intl/en/home/tools/manager-accounts/) où se trouve l'action de conversion. Lorsque cela est disponible, cette destination inclura également la valeur [`gclid`](https://support.google.com/google-ads/answer/9744275?hl=en) en recherchant les cookie 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 définis dans l'interface Commanders Act en suivant : <code>Administration</code> ➜ <code>Connector Credentials</code> ➜ <code>Add connector credentials</code> ➜ <code>Google Ads</code></td></tr><tr><td><code>Mapping</code></td><td><p><em><strong><code>Obligatoire</code></strong></em><br>Associez vos noms de conversion Google Ads, auxquels les conversions améliorées sont appliquées, à vos événements en renseignant les champs <code>Google Ads Conversion Name</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>Goals</code> ➜ <code>Summary</code> ➜ <code>Conversion action</code> (column) <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 de 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 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 `Enhanced conversions` ➜ cochez `Turn on enhanced conversions` ➜ sélectionnez `API` .
{% endhint %}

## Référence rapide

<table><thead><tr><th width="327">Événements 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 [Mapping](#configuration) pour plus de détails.
{% endhint %}

## Mappages des champs

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

* Email 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" %}
La plupart des propriétés peuvent être remappées à l'aide de notre fonctionnalité "Smart Mapping".\
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>value</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.\
> \&#xNAN;**\[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.\
> \&#xNAN;**\[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é.\
> \&#xNAN;**\[3]** Normalisé et haché via SHA256.\
> \&#xNAN;**\[4]** Voir [Configuration de la destination](#destination-setup) pour plus de détails.
> {% endhint %}


---

# Agent Instructions: 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.