> 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 spécialisée dans la publicité en ligne, les technologies des moteurs de recherche, le cloud computing et les logiciels. Cette destination vous permet d'améliorer la précision de la mesure de vos conversions hors ligne en important des conversions après clic qui contiennent des identifiants utilisateur hachés et quelques informations facultatives supplémentaires, afin d'aider Google Ads à associer la conversion à la publicité à l'origine du lead.

## Fonctionnalités clés

La destination Google Enhanced Conversions for Leads offre 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) couvre la méthode Google [uploadClickConversions](https://developers.google.com/google-ads/api/reference/rpc/v21/ConversionUploadService/UploadClickConversions?transport=rest), ce qui permet de faire correspondre correctement vos donné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 s’effectue automatiquement, ce qui simplifie la saisie.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Mappage intelligent**: le mappage des données peut être ajusté à l’aide des champs définis dans votre datalayer.
* **Prise en charge des données multi-éléments** : les informations contenues dans le tableau [item](https://doc.commandersact.com/developers/tracking/events-reference#item) sont transmises au partenaire.

## Configuration de la destination

Avant de configurer cette destination, consultez les prérequis suivants :

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

* Cliquez sur **Objectifs**
* Cliquez sur le menu déroulant **Conversion** dans la section du menu.
* Cliquez sur [**Récapitulatif**](https://ads.google.com/aw/conversions) → **Afficher toutes les actions de conversion**

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2F7x2VCtHpQCQng4QoRRVr%2Fgec_leads_230626_1.png?alt=media&amp;token=3a4589ae-1362-4b81-b6e0-f30f8174fa3a" alt=""><figcaption></figcaption></figure>

* Dans cette section, recherchez <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 :

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2FGwo4bfLY7nrUNiGwndK1%2Fgec_leads_230626_2.png?alt=media&amp;token=ec355c89-bdf5-442a-8589-93c67bf0330f" alt=""><figcaption></figcaption></figure>

Si vous devez créer une action de conversion prise en charge, procédez comme suit :

* Cliquez sur **Objectifs**
* Cliquez sur le menu déroulant **Conversion** dans la section du menu.
* Cliquez sur [**Récapitulatif**](https://ads.google.com/aw/conversions) → **+ Créer une action de conversion**

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2FS8MctNzWJskmCQGez4sg%2Fgec_leads_230626_3.png?alt=media&amp;token=d427c5bf-2dd6-4f8d-b261-eefb2fa03c5a" alt=""><figcaption></figcaption></figure>

* Cochez **Conversions hors ligne** uniquement, puis cliquez sur **Modifier les sources de données**

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2FmbnX2TJFdw6z1cX4UEmx%2Fgec_leads_230626_4.png?alt=media&amp;token=1b67d45c-a1db-49b8-aa2d-95bb66a95f38" alt=""><figcaption></figcaption></figure>

* Sélectionnez **Ignorer cette étape et configurer une source de données ultérieurement**

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2FF5qlFKyHnY5543He2Urc%2Fgec_leads_230626_5.png?alt=media&amp;token=b6276264-a2e6-4e83-8c17-d0bd4afa194a" alt=""><figcaption></figcaption></figure>

* Sélectionnez **Qualified lead** ou **Converted lead** et terminez la configuration de votre action de conversion.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2FyRjiSsDd38q6RM422get%2Fgec_leads_230626_6.png?alt=media&amp;token=d8470acd-90ac-45b1-b43d-b4b26f7255e7" alt=""><figcaption></figcaption></figure>

{% 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>\
• Indicateur <mark style="color:bleu;">`Activer les conversions améliorées pour les prospects`</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 pour les prospects`</mark> .
{% endhint %}

{% hint style="warning" %}
Le type d'action de conversion doit être <mark style="color:bleu;">`UPLOAD_CLICKS`</mark> , et doit exister dans le compte client de conversion Google Ads du compte Google Ads associé au clic. Suivez les étapes ci-dessus pour consulter vos actions de conversion actuelles et/ou créer une nouvelle action de conversion compatible. Pour en savoir plus, consultez ce [LIEN](https://developers.google.com/google-ads/api/docs/conversions/upload-offline#populate-click-conversions).
{% endhint %}

### Configuration

<table data-header-hidden="false" data-header-sticky><thead><tr><th>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, à l'emplacement suivant : <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 des noms de conversion</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Associez les noms de conversion Google Ads auxquels les conversions améliorées s'appliquent à vos événements en définissant les champs <code>Nom de conversion</code> et <code>Nom de votre événement</code> . Au moins une ligne est obligatoire. Vous trouverez les noms de conversion dans l'interface Google Ads à l'emplacement suivant : <code>Objectifs</code> ➜ <code>Récapitulatif</code> ➜ <code>Actions de conversion</code> (colonne).</td></tr><tr><td><code>Mappage des variables personnalisées</code></td><td>Les variables personnalisées ajoutent des données plus détaillées à vos conversions, ce qui vous permet de segmenter davantage vos rapports. Vous pouvez associer les noms de vos variables personnalisées à vos valeurs en définissant les champs <code>Nom de la variable personnalisée</code> et <code>Votre valeur</code> .<br>Pour en savoir plus, consultez ce <a href="https://support.google.com/google-ads/answer/9962082?hl=en">LIEN</a>.</td></tr><tr><td><code>ID de mesure Google Analytics</code></td><td>Vous pouvez ajouter l'« ID de mesure » Google Analytics, une chaîne telle que « SE23QCQ1Q8 », sans la partie initiale « G- ». Il sert de 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;">n'est pas exécutée !</mark>. Seules les erreurs sont renvoyées, et non 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 effectue toutes les vérifications de téléversement et renvoie les erreurs éventuelles. Si <code>false</code>, il effectue uniquement la validation de base des données d’entrée, ignore les vérifications de téléversement suivantes et renvoie un succès, même si aucun clic n’a été trouvé pour les identifiants utilisateur fournis. Pour en savoir plus, suivez ce <a href="https://developers.google.com/google-ads/api/rest/reference/rest/v17/customers/uploadClickConversions?hl=en#request-body">LINK</a>.</td></tr></tbody></table>

## 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>[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 %}

## Correspondances des champs

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

* Adresse e-mail de l’utilisateur
* Numéro de téléphone de l’utilisateur
  {% endhint %}

{% hint style="info" %}
Les propriétés peuvent être remappées à l’aide de notre fonctionnalité [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) \
Google Enhanced Conversions for Leads prend en charge les signaux de consentement. Pour en savoir plus, suivez ce [LINK](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 data-header-hidden="false" data-header-sticky><thead><tr><th width="265">Champs Smart Mapping</th><th width="410">Propriétés par défaut de Commanders Act</th><th>Propriétés Google</th></tr></thead><tbody><tr><td><code>ID de transaction</code></td><td><code>id</code></td><td><code>orderId</code></td></tr><tr><td><p><code>Google Click Id</code></p><p><code>-</code></p></td><td><p><code>partners.google.gclid</code></p><p><code>ID de mesure Google Analytics</code></p></td><td><code>gclid</code> <strong>[1]</strong></td></tr><tr><td><code>Google Braid</code></td><td><code>partners.google.gbraid</code></td><td><code>gbraid</code> <strong>[2]</strong></td></tr><tr><td><code>Google Web Braid</code></td><td><code>partners.google.wbraid</code></td><td><code>wbraid</code> <strong>[3]</strong></td></tr><tr><td><p><code>User Email Source</code></p><p><code>User Phone Source</code></p></td><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>E-mail de l’utilisateur</code></td><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>user.phone</code></td><td><code>hashedPhoneNumber</code> <strong>[4][5]</strong></td></tr><tr><td><code>Ad User Data Consent</code></td><td><code>user.google_consent_mode.ad_user_data</code></td><td><code>consent.adUserData</code></td></tr><tr><td><code>Ad Personalization Consent</code></td><td><code>user.google_consent_mode.ad_personalization</code></td><td><code>consent.adPersonalization</code></td></tr><tr><td><code>Ad User Data Consent</code></td><td><code>user.google_consent_mode.ad_user_data</code></td><td><code>consent.adUserData</code> <strong>[6]</strong></td></tr><tr><td><code>Ad Personalization Consent</code></td><td><code>user.google_consent_mode.ad_personalization</code></td><td><code>consent.adPersonalization</code> <strong>[6]</strong></td></tr><tr><td><code>Merchant Id</code></td><td><code>partners.google.merchant_id</code></td><td><code>cartData.merchantId</code></td></tr><tr><td><code>Feed Country Code</code></td><td><code>partners.google.feed_country_code</code></td><td><code>cartData.feedCountryCode</code></td></tr><tr><td><code>Feed Language Code</code></td><td><code>partners.google.feed_language_code</code></td><td><code>cartData.feedLanguageCode</code></td></tr><tr><td><code>Local Transaction Cost</code></td><td><code>partners.google.local_transaction_cost</code></td><td><code>cartData.localTransactionCost</code></td></tr><tr><td><code>ID de l’article</code></td><td><code>items.X.id</code></td><td><code>cartData.items.X.productId</code></td></tr><tr><td><code>Prix de l’article</code></td><td><code>items.X.product.price</code></td><td><code>cartData.items.X.unitPrice</code></td></tr><tr><td><code>Item Quantity</code></td><td><code>items.X.quantity</code></td><td><code>cartData.items.X.quantity</code></td></tr><tr><td><code>-</code></td><td><code>Mappage des noms de conversion</code></td><td><code>conversionAction</code> <strong>[7]</strong></td></tr><tr><td><code>Conversion Value</code></td><td><code>value</code></td><td><code>conversionValue</code></td></tr><tr><td><code>Devise</code></td><td><code>currency</code></td><td><code>currencyCode</code></td></tr><tr><td><code>-</code></td><td><code>Custom variable name</code></td><td><code>conversionCustomVariable</code> <strong>[8][9]</strong></td></tr><tr><td><code>-</code></td><td><code>Your value</code></td><td><code>value</code> <strong>[8][10]</strong></td></tr><tr><td><code>-</code></td><td><code>Validation uniquement</code></td><td><code>validateOnly</code> <strong>[11]</strong></td></tr><tr><td><code>-</code></td><td><code>Débogage activé</code></td><td><code>debugEnabled</code> <strong>[11]</strong></td></tr></tbody></table>

{% hint style="info" %}
**1.** Voir [ID de mesure Google Analytics](#configuration) dans [Configuration](#configuration) pour plus de détails.\
**2.** Identifiant de clic Google pour les clics associés aux conversions d'applications et provenant d'appareils iOS équipés d'iOS 14 ou version ultérieure.\
**3.** Identifiant de clic Google pour les clics associés aux conversions Web et provenant d'appareils iOS équipés d'iOS 14 ou version ultérieure.\
**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> ou <mark style="color:bleu;">`UNSPECIFIED`</mark> . Valeur par défaut : <mark style="color:bleu;">`FIRST_PARTY`</mark> .\
**5.** Hachée automatiquement si elle est fournie en texte brut.\
**6.** Valeurs acceptées : <mark style="color:bleu;">`true`</mark> , <mark style="color:bleu;">`1`</mark> ou <mark style="color:bleu;">`granted`</mark> si l'utilisateur a donné son 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 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éfinir 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éfinir 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/google/google-enhanced-conversions-for-leads.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
