# Google Enhanced Conversions for Leads

[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. Cette destination vous permet d’améliorer la précision de votre mesure des conversions hors ligne en téléversant des conversions de clics contenant des identifiants utilisateur hachés et certains détails supplémentaires facultatifs qui aident Google Ads à faire correspondre la conversion à la publicité qui a initié le lead.

## Fonctionnalités clés

La destination Google Enhanced Conversions for Leads fournit les fonctionnalités clés suivantes :

* **Structure des events**: notre [Référence des events](https://community.commandersact.com/platform-x/developers/tracking/events-reference) couvre la méthode Google [uploadClickConversions](https://developers.google.com/google-ads/api/reference/rpc/v21/ConversionUploadService/UploadClickConversions?transport=rest), ce qui signifie que vos données sont correctement bridgées vers les champs attendus de manière optimisée.
* **Mappings préconfigurés**: le mapping des données pour les destinations basées sur les 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 mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Prise en charge des données multi-éléments**: les informations incluses dans le [item](https://doc.commandersact.com/developers/tracking/events-reference#item) le tableau est envoyé au partenaire.

## Configuration de la destination

Avant de configurer cette destination, vous devez remplir les prérequis Google suivants :

{% hint style="info" %}
**1. Créez et configurez votre action de conversion**

Connectez-vous à [Google Ads ](https://ads.google.com/home/)et :

* Cliquez sur **Goals**
* Cliquez sur le menu déroulant **Conversion** dans la section du menu.
* Cliquez sur [**Summary**](https://ads.google.com/aw/conversions)
* Cliquez sur **Nouvelle action de conversion**.
* Sélectionnez **Import** dans la page « New conversion action ».
* Sélectionnez **CRMs, files, or other data sources** puis **Track conversions from clicks**.
* Dans la section « Data Source », vous pouvez sélectionner **Connect a new data source**: cela peut être fait ultérieurement.
* Cliquez sur **Continue**.
* Saisissez les paramètres de cette action de conversion. Pour plus de détails sur les paramètres, consultez [Set up offline conversion imports](https://support.google.com/google-ads/answer/7012522?sjid=17218141641119059045-EU).
* Cliquez sur **Save and continue**. La page suivante confirmera votre nouvelle action de conversion.
* Cliquez sur **Done**.\\

**2. Activez les enhanced conversions for leads**

Cochez la case pour activer les enhanced conversions for leads, ou vous pouvez le faire après avoir créé votre action de conversion en cliquant sur [**Summary**](https://ads.google.com/aw/conversions) et ouvrez le menu déroulant **enhanced conversions for leads** pour cocher la même case.\\

**3. Acceptez les conditions relatives aux données client**

Pour accepter les conditions relatives aux données client, cliquez sur [**Summary**](https://ads.google.com/aw/conversions), sélectionnez **Paramètres** et cliquez sur le menu déroulant **Customer data terms** .
{% endhint %}

{% hint style="warning" %}
Le type d’action de conversion doit être `UPLOAD_CLICKS` , et doit exister dans le client de conversion Google Ads du compte Google Ads associé au clic. Plus de détails sont disponibles en suivant ce lien [LIEN](https://developers.google.com/google-ads/api/docs/conversions/upload-offline#populate-click-conversions).
{% endhint %}

### Configuration

<table><thead><tr><th width="252">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Authentication</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>Ajouter des credentials de connecteur</code> ➜ <code>Google Ads</code></td></tr><tr><td><code>Mappage</code><br><code>Conversion Names</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Mappez vos noms de conversion Google Ads, où les enhanced conversions sont appliquées, avec vos événements en définissant les champs <code>Conversion name</code> and <code>Your event name</code> . Au moins une ligne est requise. Les noms de conversion se trouvent dans l’interface Google Ads en suivant : <code>Goals</code> ➜ <code>Summary</code> ➜ <code>Conversion actions</code> (colonne).</td></tr><tr><td><code>Mappage</code><br><code>Custom Variables</code></td><td>Les custom variables enrichissent vos conversions avec davantage de données afin que vous puissiez segmenter plus finement vos rapports. Vous pouvez faire correspondre vos noms de custom variable avec vos valeurs en définissant les champs <code>Custom variable name</code> and <code>Your value</code> .<br>Plus de détails sont disponibles en suivant ce lien <a href="https://support.google.com/google-ads/answer/9962082?hl=en">LIEN</a>.</td></tr><tr><td><code>Google Analytics</code><br><code>Measurement Id</code></td><td>Vous pouvez ajouter le « Measurement Id » Google Analytics, qui est une chaîne comme « SE23QCQ1Q8 » sans la partie initiale « G- ». Il est utilisé comme méthode supplémentaire pour récupérer votre <code>gclid</code> à partir des cookies disponibles.</td></tr><tr><td><code>Validate Only</code></td><td>Si cette option est activée, la requête est validée mais <mark style="color:orange;">non exécutée !</mark>. Seules les erreurs sont renvoyées, pas les résultats, dans l’onglet <code>Event Inspector</code>.</td></tr><tr><td><code>Debug Enabled</code></td><td>Si cette option est activée, le point de terminaison Google effectuera tous les contrôles de téléversement et renverra les erreurs, le cas échéant. Si <code>false</code>, il effectuera uniquement une validation d’entrée de base, ignorera les contrôles de téléversement suivants et renverra un succès même si aucun clic n’a été trouvé pour les identifiants utilisateur fournis. Plus de détails sont disponibles en suivant ce lien <a href="https://developers.google.com/google-ads/api/rest/reference/rest/v17/customers/uploadClickConversions?hl=en#request-body">LIEN</a>.</td></tr></tbody></table>

## Référence rapide

<table><thead><tr><th width="327">Events Commanders Act</th><th>Google Tracking</th></tr></thead><tbody><tr><td><code>[Any Event]</code> <strong>[1]</strong></td><td><code>customers.uploadClickConversions</code></td></tr></tbody></table>

{% hint style="info" %}

> **1.** Voir [Mapping Conversion Names](#configuration) dans [Configuration](#configuration) pour plus de détails.
> {% endhint %}

## Mappings des champs

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

* User email
* User phone
  {% 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) feature.\
Google Enhanced Conversions for Leads prend en charge les signaux de consentement. Plus de détails sont disponibles en suivant ce lien [LIEN](https://developers.google.com/google-ads/api/rest/reference/rest/v17/Consent). Les propriétés Google sont définies à partir du chemin <mark style="color:bleu;">`conversions[0]`</mark> .
{% endhint %}

<table><thead><tr><th width="424">Propriétés Commanders Act</th><th>Google Properties</th></tr></thead><tbody><tr><td><code>id</code></td><td><code>orderId</code></td></tr><tr><td><p><code>partners.google.gclid</code></p><p><code>Google Analytics Measurement Id</code></p></td><td><code>gclid</code> <strong>[1]</strong></td></tr><tr><td><code>partners.google.gbraid</code></td><td><code>gbraid</code> <strong>[2]</strong></td></tr><tr><td><code>partners.google.wbraid</code></td><td><code>wbraid</code> <strong>[3]</strong></td></tr><tr><td><p><code>partners.google.email_source</code></p><p><code>partners.google.phone_source</code></p></td><td><code>userIdentifierSource</code> <strong>[4]</strong></td></tr><tr><td><code>user.email_sha256</code></td><td><code>hashedEmail</code> <strong>[4][5]</strong></td></tr><tr><td><code>user.phone</code></td><td><code>hashedPhoneNumber</code> <strong>[4][5]</strong></td></tr><tr><td><code>user.google_consent_mode.ad_user_data</code></td><td><code>consent.adUserData</code></td></tr><tr><td><code>user.google_consent_mode.ad_personalization</code></td><td><code>consent.adPersonalization</code></td></tr><tr><td><code>partners.google.aduserdata</code></td><td><code>consent.adUserData</code> <strong>[6]</strong></td></tr><tr><td><code>partners.google.adpers</code></td><td><code>consent.adPersonalization</code> <strong>[6]</strong></td></tr><tr><td><code>partners.google.merchant_id</code></td><td><code>cartData.merchantId</code></td></tr><tr><td><code>partners.google.feed_country_code</code></td><td><code>cartData.feedCountryCode</code></td></tr><tr><td><code>partners.google.feed_language_code</code></td><td><code>cartData.feedLanguageCode</code></td></tr><tr><td><code>partners.google.local_transaction_cost</code></td><td><code>cartData.localTransactionCost</code></td></tr><tr><td><code>items.X.id</code></td><td><code>cartData.items.X.productId</code></td></tr><tr><td><code>items.X.product.price</code></td><td><code>cartData.items.X.unitPrice</code></td></tr><tr><td><code>tems.X.quantity</code></td><td><code>cartData.items.X.quantity</code></td></tr><tr><td><code>Mapping Conversion Names</code></td><td><code>conversionAction</code> <strong>[7]</strong></td></tr><tr><td><code>value</code></td><td><code>conversionValue</code></td></tr><tr><td><code>currency</code></td><td><code>currencyCode</code></td></tr><tr><td><code>Custom variable name</code></td><td><code>conversionCustomVariable</code> <strong>[8][9]</strong></td></tr><tr><td><code>Your value</code></td><td><code>value</code> <strong>[8][10]</strong></td></tr><tr><td><code>Validate Only</code></td><td><code>validateOnly</code> <strong>[11]</strong></td></tr><tr><td><code>Debug Enabled</code></td><td><code>debugEnabled</code> <strong>[11]</strong></td></tr></tbody></table>

{% hint style="info" %}

> **1.** Voir [Google Analytics Measurement Id](#configuration) dans [Configuration](#configuration) pour plus de détails.\
> **2.** Identifiant de clic Google pour les clics associés aux conversions d’application et provenant d’appareils iOS à partir d’iOS14.\
> **3.** Identifiant de clic Google pour les clics associés aux conversions web et provenant d’appareils iOS à partir d’iOS14.\
> **4.** Définissez dans <mark style="color:bleu;">`userIdentifiers.X`</mark> . Valeurs acceptées : <mark style="color:bleu;">`FIRST_PARTY`</mark> , <mark style="color:bleu;">`THIRD_PARTY`</mark> soit de <mark style="color:bleu;">`UNSPECIFIED`</mark> . Valeur par défaut : <mark style="color:bleu;">`FIRST_PARTY`</mark> .\
> **5.** Haché automatiquement s’il est fourni en texte clair.\
> **6.** Valeurs acceptées : <mark style="color:bleu;">`true`</mark> , <mark style="color:bleu;">`1`</mark> soit de <mark style="color:bleu;">`granted`</mark> lorsque l’utilisateur a accordé le consentement ou <mark style="color:bleu;">`false`</mark> , <mark style="color:bleu;">`0`</mark> soit de <mark style="color:bleu;">`denied`</mark> sinon. Si le consentement n’est pas spécifié, utilisez <mark style="color:bleu;">`unspecified`</mark> . Toutes les valeurs de chaîne ne tiennent pas compte de la casse. Valeur par défaut <mark style="color:bleu;">`granted`</mark> .\
> **7.** Nom de ressource de conversion au format suivant : <mark style="color:bleu;">`customers/[CUSTOMER_ID]/conversionActions/[CONVESION_ACTION_ID]`</mark>\
> **8.** Définissez dans le chemin <mark style="color:bleu;">`customVariables.X`</mark> .\
> **9.** Nom de ressource de la custom variable au format suivant :\ <mark style="color:bleu;">`customers/[CUSTOMER_ID]/conversionCustomVariables/[VARIABLE_ID]`</mark>\
> **10.** Votre valeur pour la custom variable. Voir [Mapping Custom Variables](#configuration) dans [Configuration](#configuration) pour plus de détails.\
> **11.** Définissez dans le chemin de base. Voir [Configuration](#configuration) 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-conversions-for-leads.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.