# Google Search Ads 360 Enhanced Conversions

[Google](https://about.google/) est une entreprise technologique multinationale axée sur la publicité en ligne, la technologie de moteur de recherche, le cloud computing et les logiciels informatiques. En tirant parti de la [API de conversion hors ligne de Campaign Manager 360](https://developers.google.com/doubleclick-advertisers/guides/conversions_ec), vous pouvez exploiter la fonctionnalité "Enhanced Conversions" pour envoyer des données First-party, tout en offrant la possibilité de modifier la quantité et la valeur, sous la forme de [mises à jour de conversion batch](https://developers.google.com/doubleclick-advertisers/rest/v4/conversions/batchupdate).

{% hint style="warning" %}
Les "Enhanced Conversions" (EC) dans l'API Campaign Manager 360 (CM360) sont une solution hybride avec API, couverte par cette destination, et tag client : Voir notre template tag <mark style="color:blue;">gtag - Google SA360 - Floodlight for server-side Enhanced Conversions</mark> pour plus de détails. Google exige toujours des tags Floodlight pour obtenir les informations de conversion depuis les sites des annonceurs.
{% endhint %}

{% hint style="warning" %}
Google recommande de déclencher [mises à jour de conversion batch](https://developers.google.com/doubleclick-advertisers/rest/v4/conversions/batchupdate) **entre 90 minutes et 24 heures**, ce dernier étant la limite temporelle maximale, après le déclenchement du tag Floodlight côté client pour maximiser le matching EC. Après **30 minutes** se sont écoulées depuis le déclenchement du Floodlight côté client, vous pouvez déjà déclencher [mises à jour de conversion batch](https://developers.google.com/doubleclick-advertisers/rest/v4/conversions/batchupdate), mais il est recommandé de suivre la recommandation de Google indiquée ci-dessus. Plus de détails sont disponibles en suivant ce [LINK](https://developers.google.com/doubleclick-advertisers/guides/conversions_ec#recommended_setup).
{% endhint %}

## Principales fonctionnalités

La destination Google Search Ads 360 Enhanced Conversions offre 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 [batchupdate](https://developers.google.com/doubleclick-advertisers/rest/v4/conversions/batchupdate), 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.

## Configuration de la destination

Avant de configurer cette destination, vous devez remplir les exigences suivantes :

{% hint style="info" %}
**Accepter les ToS**

Connectez-vous au compte CM360 et choisissez l'annonceur avec lequel vous souhaitez implémenter EC. À gauche, ouvrez le menu <mark style="color:blue;">`Floodlight`</mark> ➜ <mark style="color:blue;">`Configuration`</mark>, et cochez la case sous la <mark style="color:blue;">`Enhanced conversions`</mark> section :\
\
![](https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-d45379f0544fe75edfa6c5b584852add7cac4925%2Fsa360ec_1.png?alt=media)\
\
Les utilisateurs CM360 disposant des rôles d'administrateur d'agence et de gestionnaire de compte DC devraient pouvoir accepter les ToS. Notez que l'acceptation des ToS peut également être effectuée dans la version précédente de Search Ads 360 (SA360), mais uniquement si l'annonceur CM360 contrôlant la configuration Floodlight est lié à un annonceur SA360. Dans ce cas, les ToS peuvent être acceptés dans l'annonceur lié sous <mark style="color:blue;">`Advertiser Settings`</mark> ➜ <mark style="color:blue;">`Advertiser Details`</mark> ➜ <mark style="color:blue;">`Enhanced conversions`</mark>:\
\
![](https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-392b080862e54da498e59809cfb4373665ad760d%2Fsa360ec_2.png?alt=media)\\

**Enrichissez votre tag Floodlight côté client**

Assurez-vous que les deux [**match\_id**](https://support.google.com/campaignmanager/answer/7554821?hl=en#custom\&zippy=%2Ccustom-fields) et [**transaction\_id**](https://support.google.com/campaignmanager/answer/7554821?hl=en#zippy=%2Cfields-in-the-event-snippet---overview) champs sont correctement définis.\
Si vous configurez votre tag côté client pour la première fois, vous pouvez vouloir utiliser notre template tag <mark style="color:blue;">gtag - Google SA360 - Floodlight for server-side Enhanced Conversions</mark>.
{% endhint %}

### Configuration

<table><thead><tr><th width="344">Settings</th><th>Description</th></tr></thead><tbody><tr><td><code>ID de configuration Floodlight</code></td><td><em><strong><code>Requis</code></strong></em><br>Identifiant de configuration Floodlight de la conversion concernée. Plus de détails sont disponibles en suivant ce <a href="https://developers.google.com/doubleclick-advertisers/rest/v4/Conversion">LINK</a>. <strong>[1]</strong></td></tr><tr><td><code>ID d'activité Floodlight</code></td><td><em><strong><code>Requis</code></strong></em><br>Identifiant d'activité Floodlight de la conversion concernée. Plus de détails sont disponibles en suivant ce <a href="https://developers.google.com/doubleclick-advertisers/rest/v4/Conversion">LINK</a>. <strong>[1]</strong></td></tr><tr><td><code>Match Id</code></td><td><em><strong><code>Requis</code></strong></em><br>Un identifiant unique créé par l'annonceur à transmettre également dans le Floodlight côté client. Cela ne peut contenir que des lettres, des chiffres, des underscores, des tirets et des points et est sensible à la casse. Maximum 100 caractères. Plus de détails sont disponibles en suivant ce <a href="https://support.google.com/campaignmanager/answer/7554821?hl=en#custom&#x26;zippy=%2Ccustom-fields">LINK</a> (Voir le nom du champ "match_id").</td></tr><tr><td><code>Quantité totale</code></td><td>Cochez cette option pour considérer la quantité totale au lieu du nombre de produits uniques.</td></tr></tbody></table>

{% hint style="info" %}
**\[1]** Pour trouver les deux valeurs, vous pouvez vous connecter au compte CM360 et sélectionner l'annonceur, puis localiser l'onglet <mark style="color:blue;">`Floodlight`</mark> dans le panneau de gauche. Ouvrez <mark style="color:blue;">`Floodlight`</mark> ➜ <mark style="color:blue;">`Activities`</mark> et trouvez/créez l'activité que vous utilisez pour recevoir les données EC. Les valeurs affichées, mises en évidence en vert ci-dessous, sont `(1)` <mark style="color:blue;">`ID de configuration Floodlight`</mark> `(2)` <mark style="color:blue;">`ID d'activité Floodlight`</mark> :\\

<img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-bbc88ee37cda4cf4cac5584a6fbcde1b3734df6a%2Fsa360ec_3.png?alt=media" alt="" data-size="original">
{% endhint %}

## Référence rapide

| Commanders Act Events  | Google Tracking API       |
| ---------------------- | ------------------------- |
| `[Any Event]` **\[1]** | `conversions.batchupdate` |

{% hint style="info" %}
**\[1]** Use [**Filtres de destination**](https://doc.commandersact.com/features/destinations/destination-filters) pour spécifier vos événements de correspondance.
{% endhint %}

## Mappages de champs

{% hint style="info" %}
La plupart des propriétés peuvent être remappées en utilisant notre fonctionnalité "Smart Mapping".\
Les propriétés Google sont définies à partir du chemin <mark style="color:blue;">`conversions.0`</mark> ou <mark style="color:blue;">`conversions.0.userIdentifiers.0`</mark> ce dernier pour les propriétés utilisateur.
{% endhint %}

<table><thead><tr><th width="375.6685580062746">Propriétés Commanders Act</th><th>Google Properties</th></tr></thead><tbody><tr><td><code>ID de configuration Floodlight</code></td><td><code>floodlightConfigurationId</code> <strong>[*][1]</strong></td></tr><tr><td><code>ID d'activité Floodlight</code></td><td><code>floodlightActivityId</code> <strong>[*][1]</strong></td></tr><tr><td><code>Match Id</code></td><td><code>matchId</code> <strong>[*][1]</strong></td></tr><tr><td><code>context.event_timestamp</code></td><td><code>timestampMicros</code> <strong>[*][2]</strong></td></tr><tr><td><code>id</code></td><td><code>ordinal</code> <strong>[*]</strong></td></tr><tr><td><code>valeurs</code></td><td><code>valeurs</code> <strong>[*]</strong></td></tr><tr><td><p><code>items.length</code></p><p><code>items.X.quantity</code></p></td><td><code>quantity</code> <strong>[*][3]</strong></td></tr><tr><td><code>user.email_sha256</code></td><td><code>hashedEmail</code> <strong>[4]</strong></td></tr><tr><td><code>user.phone</code></td><td><code>hashedPhoneNumber</code> <strong>[4]</strong></td></tr><tr><td><code>user.firstname</code></td><td><code>addressInfo.hashedFirstName</code> <strong>[4]</strong></td></tr><tr><td><code>user.lastname</code></td><td><code>addressInfo.hashedLastName</code> <strong>[4]</strong></td></tr><tr><td><code>user.street</code></td><td><code>addressInfo.hashedStreetAddress</code> <strong>[4]</strong></td></tr><tr><td><code>user.city</code></td><td><code>addressInfo.city</code></td></tr><tr><td><code>user.state</code></td><td><code>addressInfo.state</code></td></tr><tr><td><code>user.country</code></td><td><code>addressInfo.countryCode</code></td></tr><tr><td><code>user.zipcode</code></td><td><code>addressInfo.postalCode</code></td></tr><tr><td><code>partners.google.non_personalized_ad</code></td><td><code>nonPersonalizedAd</code></td></tr><tr><td><code>partners.google.child_directed_treatment</code></td><td><code>childDirectedTreatment</code></td></tr><tr><td><code>partners.google.limit_ad_tracking</code></td><td><code>limitAdTracking</code></td></tr></tbody></table>

{% hint style="info" %}

> **\[\*]** Propriété obligatoire.  \
> \&#xNAN;**\[1]** Voir [Configuration](#configuration) pour plus de détails sur ces propriétés obligatoires.  \
> \&#xNAN;**\[2]** Le timestamp en millisecondes est automatiquement converti en microsecondes.  \
> \&#xNAN;**\[3]** Voir [Configuration ](#configuration)(<mark style="color:blue;">`Quantité totale`</mark>) pour plus de détails.  \
> \&#xNAN;**\[4]** Normalisé et hashé automatiquement s'il est transmis en clair.
> {% endhint %}