> 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, 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 offline en téléchargeant des conversions de clics qui contiennent des identifiants utilisateur hachés et certains détails supplémentaires facultatifs qui aident Google Ads à faire correspondre la conversion à l'annonce 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 é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 s'effectue automatiquement, ce qui simplifie la saisie utilisateur.
* **Hachage automatique**: les informations sont hachées automatiquement 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-items**: 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, consultez les prérequis suivants :

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

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

<figure><img src="/files/b02c8aee6af87067b273e54607d360ce816929b6" alt=""><figcaption></figcaption></figure>

* Dans cette section, recherchez soit <mark style="color:bleu;">**`leads qualifiés`**</mark> ou <mark style="color:bleu;">**`lead converti`**</mark>: seuls ces types d'actions de conversion peuvent être utilisés avec Google Enhanced Conversions for Leads :

<figure><img src="/files/946119bf5b53edb2ef0b9f1e18b2174222db5d25" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/d91ed807df5015ceed49dcac16eca63e6926de21" alt=""><figcaption></figcaption></figure>

* Flag **Conversions offline** uniquement, puis cliquez sur **Modifier les sources de données**

<figure><img src="/files/590664e4daff776461f2729a20802c644ed6221a" alt=""><figcaption></figcaption></figure>

* Sélectionnez **Ignorez cette étape et configurez une source de données plus tard**

<figure><img src="/files/73ce947013a276533b2209b7286ee902a63f9890" alt=""><figcaption></figcaption></figure>

* Sélectionnez soit **lead qualifié** ou **lead converti** et terminez la configuration de votre action de conversion.

<figure><img src="/files/16591e5ed4049a1e2f0fa5d8d295d1246ec7b9ef" 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>\
• Cocher <mark style="color:bleu;">`Activer les conversions améliorées pour les leads`</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 leads`</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 client de conversion Google Ads du compte Google Ads associé au clic. Veuillez suivre les étapes ci-dessus pour consulter 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 [LINK](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 qu'ils sont définis dans l'interface Commanders Act, comme suit : <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</code><br><code>Noms des conversions</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Associez les noms de conversion Google Ads, où les conversions améliorées sont appliquées, à vos événements en configurant les champs <code>Nom de la conversion</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 comme suit : <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 de pouvoir segment vos rapports plus finement. Vous pouvez associer les noms de vos variables personnalisées à vos valeurs en configurant 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">LINK</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>Event Inspector</code>.</td></tr><tr><td><code>Débogage activé</code></td><td>Si cette option est activée, le point de terminaison Google effectuera toutes les vérifications de téléchargement et renverra des erreurs si elles sont détectées. Si <code>false</code>, il effectuera uniquement une validation de base des entrées, ignorera les vérifications de téléchargement suivantes 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">LINK</a>.</td></tr></tbody></table>

## Référence rapide

<table><thead><tr><th width="327">Commanders Act Events</th><th>Suivi Google</th></tr></thead><tbody><tr><td><code>[Tout événement]</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 %}

## Correspondances des champs

{% hint style="warning" %}
Au moins 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 [Mappage intelligent](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 [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><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>valeur</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>valeur</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éfini 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 brut.\
**6.** Valeurs acceptées : <mark style="color:bleu;">`true`</mark> , <mark style="color:bleu;">`1`</mark> ou <mark style="color:bleu;">`accordé`</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;">`refusé`</mark> sinon. Si le consentement n'est pas spécifié, utilisez <mark style="color:bleu;">`non spécifié`</mark> . Toutes les valeurs de chaîne sont insensibles à la casse. Valeur par défaut <mark style="color:bleu;">`accordé`</mark> .\
**7.** Nom de ressource de la conversion au format suivant : <mark style="color:bleu;">`customers/[CUSTOMER_ID]/conversionActions/[CONVESION_ACTION_ID]`</mark>\
**8.** Défini 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éfini 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.