# 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échargeant des click conversions qui contiennent des identifiants utilisateur hachés et quelques détails optionnels supplémentaires qui aident Google Ads à faire correspondre la conversion à l'annonce qui a généré le lead.

## Principales fonctionnalités

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

* **Structure des events**: notre [Events reference](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 mappées vers les champs attendus de manière optimisée.
* **Mappings préconçus**: le mapping des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie les entrées 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é en utilisant vos champs définis dans le datalayer.
* **Support des données multi-item**: les informations incluses dans le [item](https://doc.commandersact.com/developers/tracking/events-reference#item) array 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éer et configurer votre action de conversion**

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

* Cliquez **Objectifs**
* Cliquez sur **Conversion** dans le menu déroulant de la section.
* Cliquez [**Résumé**](https://ads.google.com/aw/conversions)
* Cliquez **Nouvelle action de conversion**.
* Sélectionnez **Importer** dans la page "New conversion action".
* Sélectionnez **CRMs, fichiers ou autres sources de données** puis **Suivre les conversions à partir des clics**.
* Dans la section “Data Source”, vous pouvez sélectionner **Connect a new data source** : cela peut être fait à une étape ultérieure.
* Cliquez **Continuer**.
* Saisissez les paramètres pour 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 **Enregistrer et continuer**. La page suivante confirmera votre nouvelle action de conversion.
* Cliquez **Terminé**.\\

**2. Activer 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 [**Résumé**](https://ads.google.com/aw/conversions) et ouvrez le **enhanced conversions for leads** menu déroulant pour cocher la même case.\\

**3. Accepter les customer data terms**

Pour accepter les customer data terms cliquez sur [**Résumé**](https://ads.google.com/aw/conversions), sélectionnez **Settings** et cliquez sur le **Customer data terms** menu déroulant.
{% endhint %}

{% hint style="warning" %}
Le type d'action de conversion doit être `UPLOAD_CLICKS` , et doit exister dans le conversion customer Google Ads du compte Google Ads associé au clic. 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">Settings</th><th>Description</th></tr></thead><tbody><tr><td><code>Authentification</code></td><td><em><strong><code>Requis</code></strong></em><br>Vos identifiants Google Ads tel que définis dans l'interface Commanders Act suivant : <code>Administration</code> ➜ <code>Connector Credentials</code> ➜ <code>Ajouter des connector credentials</code> ➜ <code>Google Ads</code></td></tr><tr><td><code>Mapping</code><br><code>Noms de conversion</code></td><td><em><strong><code>Requis</code></strong></em><br>Mappez vos Google Ads conversion names, où les enhanced conversions sont appliquées, avec vos événements en définissant les champs <code>Conversion name</code> et <code>Votre nom d'é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>Conversion actions</code> (colonne).</td></tr><tr><td><code>Mapping</code><br><code>Variables personnalisées</code></td><td>Les custom variables ajoutent des données enrichies à vos conversions afin que vous puissiez segmenter davantage vos rapports. Vous pouvez mapper vos custom variable names avec vos valeurs en définissant les champs <code>Custom variable name</code> et <code>Your value</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 cookie disponibles.</td></tr><tr><td><code>Validate Only</code></td><td>Si activé, la requête est validée mais <mark style="color:orange;">pas 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 activé, le endpoint Google effectuera toutes les vérifications de téléchargement et renverra les erreurs si elles sont trouvées. Si <code>false</code>, il n'effectuera que la validation d'entrée de base, ignorera les vérifications de téléchargement ultérieures 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>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 %}

## Mappages de champs

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

* User email
* User phone
  {% endhint %}

{% hint style="info" %}
La plupart des propriétés peuvent être remappées en utilisant notre fonctionnalité "Smart Mapping".\
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:blue;">`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>valeurs</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>valeurs</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.  \
> \&#xNAN;**\[2]** Identifiant de clic Google pour les clics associés aux conversions d'app et provenant d'appareils iOS à partir d'iOS14.  \
> \&#xNAN;**\[3]** Identifiant de clic Google pour les clics associés aux conversions web et provenant d'appareils iOS à partir d'iOS14.  \
> \&#xNAN;**\[4]** Défini dans le <mark style="color:blue;">`userIdentifiers.X`</mark> . Valeurs acceptées : <mark style="color:blue;">`FIRST_PARTY`</mark> , <mark style="color:blue;">`THIRD_PARTY`</mark> ou <mark style="color:blue;">`UNSPECIFIED`</mark> . Valeur par défaut : <mark style="color:blue;">`FIRST_PARTY`</mark> .  \
> \&#xNAN;**\[5]** Haché automatiquement s'il est fourni en clair.  \
> \&#xNAN;**\[6]** Valeurs acceptées : <mark style="color:blue;">`true`</mark> , <mark style="color:blue;">`1`</mark> ou <mark style="color:blue;">`granted`</mark> lorsque l'utilisateur a accordé le consentement ou <mark style="color:blue;">`false`</mark> , <mark style="color:blue;">`0`</mark> ou <mark style="color:blue;">`denied`</mark> sinon. Si le consentement n'est pas spécifié, utilisez <mark style="color:blue;">`unspecified`</mark> . Toutes les valeurs string sont insensibles à la casse. Valeur par défaut <mark style="color:blue;">`granted`</mark> .  \
> \&#xNAN;**\[7]** Nom de ressource de conversion au format suivant : <mark style="color:blue;">`customers/[CUSTOMER_ID]/conversionActions/[CONVESION_ACTION_ID]`</mark>\
> \&#xNAN;**\[8]** Défini dans le chemin <mark style="color:blue;">`customVariables.X`</mark> .  \
> \&#xNAN;**\[9]** Nom de ressource de la variable personnalisée au format suivant :\ <mark style="color:blue;">`customers/[CUSTOMER_ID]/conversionCustomVariables/[VARIABLE_ID]`</mark>\
> \&#xNAN;**\[10]** Votre valeur pour la variable personnalisée. Voir [Mapping Custom Variables](#configuration) dans [Configuration](#configuration) pour plus de détails.  \
> \&#xNAN;**\[11]** Défini dans le chemin de base. Voir [Configuration](#configuration) pour plus de détails.
> {% endhint %}