# Adform

[Adform](https://site.adform.com/) est une entreprise mondiale de technologie publicitaire pour les médias numériques, spécialisée dans les technologies d’automatisation marketing programmatique en temps réel. À l’aide de cette destination, vous pouvez implémenter [server-side tracking](https://www.adformhelp.com/hc/en-us/articles/9740579489041-Use-Server-Side-Tracking).

## Principales fonctionnalités

La destination Adform fournit les principales fonctionnalités suivantes :

* **Structure des events**: notre [Référence des Events](https://community.commandersact.com/platform-x/developers/tracking/events-reference) couvre [Adform server-side tracking](https://www.adformhelp.com/hc/en-us/articles/9740579489041-Use-Server-Side-Tracking), ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappages prédéfinis**: le data mapping pour les destinations basées sur les events se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Smart mapping**: le data mapping 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 tableau [item ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)sont reliées à Partnerize.

## Configuration de la destination

{% hint style="info" %}
Un modèle de tag client-side nommé `Adform - Get 3rd Party Cookie ID`  est disponible dans notre bibliothèque pour vous aider à récupérer l’identifiant Adform Third-Party.
{% endhint %}

### Configuration

<table><thead><tr><th width="345">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Tracking Domain</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre tracking domain tel qu’il est défini dans l’interface Adform (ex. <code>a1.adform.net</code> ). Plus de détails sont disponibles en suivant ce <a href="https://www.adformhelp.com/hc/articles/9740579553169#UUID-f565672b-d386-6014-c06e-054f43b67a2d">LIEN</a>.</td></tr><tr><td><code>Tracking Setup Id</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre tracking ID client, que vous pouvez trouver sous <code>Site Tracking</code>  dans l’interface Adform (ex. <code>1257163</code> ).</td></tr><tr><td><code>Tracking Point Name Property</code></td><td>Votre property contenant le nom du tracking point. S’il n’est pas défini, la property mappée dans <code>Smart Mapping</code> nommée <code>Page URL (pageUrl)</code> sera utilisée.</td></tr><tr><td><code>Sélectionnez votre conteneur Adform third-party</code></td><td>Cela peut être soit <code>Cookie</code>  ou <code>Event</code> <code>property</code>, selon la manière dont vous fournissez la valeur de l’identifiant Adform third-party. Un modèle de tag client-side nommé <code>Adform - Get 3rd Party Cookie ID</code>  est disponible dans notre bibliothèque pour vous aider à récupérer cette valeur.</td></tr><tr><td><code>Third-Party Id Cookie Name</code></td><td>Si vous sélectionnez <code>Cookie</code> dans <code>Sélectionnez votre conteneur Adform third-party</code>, vous pouvez définir ici le nom de votre cookie Adform third-party.</td></tr><tr><td><code>Third-Party Id Property</code></td><td>Si vous sélectionnez <code>Event</code> <code>property</code> dans <code>Sélectionnez votre conteneur Adform third-party</code> , vous pouvez définir ici le nom de votre property Adform third-party.</td></tr><tr><td><code>Sélectionnez votre conteneur Adform first-party</code></td><td>Cela peut être soit <code>Cookie</code> ou <code>Event property</code> , selon la manière dont vous fournissez la valeur de l’identifiant Adform first-party.</td></tr><tr><td><code>First-Party Id Cookie Name</code></td><td>Si vous sélectionnez <code>Cookie</code> dans <code>Sélectionnez votre conteneur Adform first-party</code> , vous pouvez définir ici le nom de votre cookie Adform first-party. À utiliser uniquement pour les configurations hybrides, où une partie du site tracking est implémentée client-side afin de pouvoir transmettre la valeur qu’Adform a définie précédemment.</td></tr><tr><td><code>First-Party Id Cookie Domain</code></td><td>Si vous sélectionnez <code>Cookie</code> dans <code>Sélectionnez votre conteneur Adform first-party</code>, vous pouvez définir ici le domaine de votre cookie Adform first-party. À utiliser uniquement pour les configurations hybrides, où une partie du site tracking est implémentée client-side afin de pouvoir transmettre la valeur qu’Adform a définie précédemment.</td></tr><tr><td><code>First-Party Id Property</code></td><td>Si vous sélectionnez <code>Event property</code> dans <code>Sélectionnez votre conteneur Adform first-party</code>, vous pouvez définir ici le nom de votre property Adform first-party.</td></tr><tr><td><code>Custom Event Properties</code></td><td>Mappez vos propriétés d’event personnalisées en définissant leurs noms de champ dans <code>Adform property name</code> et en ajoutant le nom du champ contenant la valeur dans <code>Your event property</code>. Dans la colonne <code>Your event property path</code> vous devez conserver la valeur par défaut <code>Default (root)</code> car elle convient à la plupart des scénarios. Si vous sélectionnez soit <code>Dans "items" {items.X}</code> ou <code>Dans "product" {items.X.product}</code> cette destination recherchera la propriété d’event d’entrée à partir du niveau <a href="https://community.commandersact.com/platform-x/developers/tracking/events-reference#item">items </a>ou <a href="https://community.commandersact.com/platform-x/developers/tracking/events-reference#product">product </a>respectivement et ajoutera sa valeur comme entrée personnalisée dans le tableau "subVariables". L’opération avancée <code>As Adform subVariables Data</code> peut être associée à l’option de chemin de property <code>Default (root)</code> afin que la valeur de votre property soit définie comme entrée personnalisée dans le tableau "subVariables" pour chaque item. Plus de détails sur les variables personnalisées Adform sont disponibles en suivant ce <a href="https://www.adformhelp.com/hc/en-us/articles/9740579489041-Use-Server-Side-Tracking">LIEN</a> (section : "Add Custom Variables").</td></tr></tbody></table>

## Référence rapide

| Commanders Act Events  | Adform Tracking          |
| ---------------------- | ------------------------ |
| `[Any Event]` **\[1]** | `[Tracking Point Names]` |

{% hint style="info" %}
**\[1]** Veillez à appliquer [**Destination filters**](https://doc.commandersact.com/features/destinations/destination-filters) lors de la configuration de vos events pertinents pour cette destination. Les events personnalisés sont également pris en charge.
{% endhint %}

## Mappages de champs

{% hint style="info" %}
La plupart des propriétés peuvent être remappées à l’aide de notre fonctionnalité "Smart Mapping".\
Pour la création d’audiences et le retargeting, assurez-vous de transmettre un identifiant utilisateur.\
Les informations géographiques et relatives à l’appareil proviennent de l’IP et de l’agent utilisateur fournis.\
L’attribution standard Adform fonctionne uniquement si <mark style="color:blue;">`identity.cookieId`</mark> (cookie Adform 3rd party) ou <mark style="color:blue;">`identity.advertisingId`</mark> (mobile advertising ID) est transmis correctement.\
Le reporting Adform Cookieless Insights est activé en transmettant des valeurs dans <mark style="color:blue;">`userContext.userAgent`</mark> et <mark style="color:blue;">`userContext.userIp`</mark> .
{% endhint %}

<table><thead><tr><th width="347">Propriétés Commanders Act</th><th>Propriétés Adform</th></tr></thead><tbody><tr><td><p><code>Third-Party Id Cookie Name</code></p><p><code>Third-Party Id Property</code></p></td><td><code>identity.cookieId</code> <strong>[1]</strong></td></tr><tr><td><p><code>First-Party Id Cookie Name</code></p><p><code>First-Party Id Property</code></p></td><td><code>identity.firstPartyId.id</code> <strong>[1]</strong></td></tr><tr><td><p><code>First-Party Id Cookie Domain</code></p><p><code>(context.page.url)</code></p></td><td><code>identity.firstPartyId.domain</code> <strong>[2]</strong></td></tr><tr><td><code>Tracking Point Name Property</code></td><td><code>name</code></td></tr><tr><td><code>context.page.url</code></td><td><code>pageUrl</code></td></tr><tr><td><code>context.page.referrer</code></td><td><code>refererUrl</code></td></tr><tr><td><code>context.device.advertising_id</code></td><td><code>identity.advertisingId</code></td></tr><tr><td><code>partners.adform.provider_id</code></td><td><code>identity.eids.0.source</code></td></tr><tr><td><code>user.id</code></td><td><code>identity.eids.0.uids.0.id</code></td></tr><tr><td><code>context.device.user_agent</code></td><td><code>userContext.userAgent</code></td></tr><tr><td><code>context.device.ip</code></td><td><code>userContext.userIp</code></td></tr><tr><td><code>value</code></td><td><code>variables.sales</code></td></tr><tr><td><code>id</code></td><td><code>variables.orderid</code></td></tr><tr><td><code>items.X.id</code></td><td><code>variables.subVariables.X.productid</code></td></tr><tr><td><code>items.X.product.price</code></td><td><code>variables.subVariables.X.productsales</code></td></tr><tr><td><code>partners.adform.consent_string</code></td><td><code>compliance.gdprConsent</code> <strong>[3]</strong></td></tr></tbody></table>

{% hint style="info" %}

> **\[1]** Le nom du cookie ou la property est utilisé(e) en fonction de votre [Configuration](#configuration).  \
> \&#xNAN;**\[2]** L’ordre de priorité est indiqué dans la colonne de gauche.  \
> \&#xNAN;**\[3]** Consent string IAB TCF.
> {% endhint %}