> 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-conversions-for-leads.md).

# Google Enhanced Conversions for Leads

[Google](https://about.google/) est une entreprise technologique multinationale axée sur 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 la mesure de vos conversions hors ligne en téléversant des conversions de clic contenant des identifiants utilisateur hachés et quelques détails supplémentaires facultatifs qui aident Google Ads à associer la conversion à l'annonce qui a initié le lead.

## Fonctionnalités clés

La destination Google Enhanced Conversions for Leads 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) 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 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 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.
* **Prise en charge des données multi-éléments**: les informations incluses dans le [item](https://doc.commandersact.com/developers/tracking/events-reference#item) array sont envoyées au partenaire.

## Configuration de la destination

Avant de configurer cette destination, vous devez satisfaire aux prérequis Google suivants :

{% hint style="info" %}
**1. Afficher les actions de conversion prises en charge**

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

* Cliquez sur **Objectifs**
* Cliquez sur le **Conversion** menu déroulant de la section du menu.
* Cliquez sur [**Résumé**](https://ads.google.com/aw/conversions) → **Afficher toutes les actions de conversion**\
  \
  ![](/files/b02c8aee6af87067b273e54607d360ce816929b6)
* Dans cette section, recherchez soit <mark style="color:bleu;">**`Qualified leads`**</mark> ou <mark style="color:bleu;">**`Converted lead`**</mark>: seuls ces types d'actions de conversion peuvent être utilisés avec Google Enhanced Conversions for Leads :\
  \
  ![](/files/946119bf5b53edb2ef0b9f1e18b2174222db5d25)<br>

Si vous devez créer une action de conversion prise en charge, vous pouvez suivre ces étapes : &#x20;

* Cliquez sur **Objectifs**
* Cliquez sur le **Conversion** menu déroulant de la section du menu.
* Cliquez sur [**Résumé**](https://ads.google.com/aw/conversions) → **+ Créer une action de conversion**\
  \
  ![](/files/d91ed807df5015ceed49dcac16eca63e6926de21)
* Flag **Conversions hors ligne** uniquement, puis cliquez sur **Modifier les sources de données** \
  \
  ![](/files/590664e4daff776461f2729a20802c644ed6221a)
* Sélectionnez **Ignorer cette étape et configurer une source de données plus tard**\
  \
  ![](/files/73ce947013a276533b2209b7286ee902a63f9890)
* Sélectionnez soit **Qualified lead** ou **Converted lead** et terminez la configuration de votre action de conversion :\
  \
  ![](/files/16591e5ed4049a1e2f0fa5d8d295d1246ec7b9ef)

**2. Activez enhanced conversions for leads**

Cochez la case pour activer enhanced conversions for leads, ou vous pouvez le faire après avoir créé votre action de conversion en cliquant [**Résumé**](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 [**Résumé**](https://ads.google.com/aw/conversions), sélectionnez **Paramètres** et cliquez sur le menu déroulant **Conditions relatives aux données client** .
{% endhint %}

{% hint style="warning" %}
Le type d'action de conversion doit être <mark style="color:bleu;">`UPLOAD_CLICKS`</mark> , et doit exister dans le client de conversion Google Ads du compte Google Ads associé au clic. Veuillez suivre les étapes ci-dessus pour afficher vos actions de conversion actuelles et/ou créer une nouvelle action de conversion prise en charge. Plus de détails sont disponibles en suivant ce [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>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>Identifiants du connecteur</code> ➜ <code>Ajouter des identifiants du connecteur</code> ➜ <code>Google Ads</code></td></tr><tr><td><code>Mappage</code><br><code>Noms de conversion</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Mappez les noms de conversion Google Ads, où les conversions améliorées sont appliquées, avec vos événements en renseignant les champs <code>Nom de conversion</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 : <code>Objectifs</code> ➜ <code>Résumé</code> ➜ <code>Actions de conversion</code> (colonne).</td></tr><tr><td><code>Mappage</code><br><code>Variables personnalisées</code></td><td>Les variables personnalisées ajoutent des données plus riches à vos conversions afin que vous puissiez segmenter davantage vos rapports. Vous pouvez mapper les noms de vos variables personnalisées avec vos valeurs en définissant les champs <code>Nom de la variable personnalisée</code> et <code>Votre valeur</code> .<br>Plus de détails sont disponibles en suivant ce <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" de 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>Validation uniquement</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>Inspecteur d'événements</code>.</td></tr><tr><td><code>Débogage activé</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 s'il en trouve. Si <code>false</code>, il n'effectuera que la validation de base des entrées, 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 <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">Événements Commanders Act</th><th>Suivi Google</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 [Mappage des noms de conversion](#configuration) dans [Configuration](#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 de l'utilisateur
* Téléphone 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é.\
Google Enhanced Conversions for Leads prend en charge les signaux de consentement. Plus de détails sont disponibles en suivant ce [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>Propriétés Google</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>Mappage des noms de conversion</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>Nom de la variable personnalisée</code></td><td><code>conversionCustomVariable</code> <strong>[8][9]</strong></td></tr><tr><td><code>Votre valeur</code></td><td><code>value</code> <strong>[8][10]</strong></td></tr><tr><td><code>Validation uniquement</code></td><td><code>validateOnly</code> <strong>[11]</strong></td></tr><tr><td><code>Débogage activé</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 le <mark style="color:bleu;">`userIdentifiers.X`</mark> . Valeurs acceptées : <mark style="color:bleu;">`FIRST_PARTY`</mark> , <mark style="color:bleu;">`THIRD_PARTY`</mark> ou <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> ou <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> ou <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 sont pas sensibles à 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 variable personnalisée au format suivant :\ <mark style="color:bleu;">`customers/[CUSTOMER_ID]/conversionCustomVariables/[VARIABLE_ID]`</mark>\
**10.** Votre valeur pour la variable personnalisée. Voir [Mappage des variables personnalisées](#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
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-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.