# Partnerize

[Partnerize](https://partnerize.com/)[ ](https://www.awin.com)fournit un réseau d'affiliation mondial reliant les entreprises aux clients.\
Avec cette destination, vous pouvez implémenter [server-side tracking](https://help.phgsupport.com/hc/en-us/articles/360020395238-Tracking-Partnerize-Server-to-Server-S2S-Integration).

## Fonctionnalités clés

La destination Partnerize fournit 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) exploite [suivi des lead et des ventes Partnerize](https://help.phgsupport.com/hc/en-us/articles/360020395238-Tracking-Partnerize-Server-to-Server-S2S-Integration), 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 les événements se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Mappage intelligent**: le mappage des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Prise en charge des données multi-éléments**: les informations incluses dans le [item ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)array est relié à Partnerize.
* **Commission group**: rémunérez différents produits en fonction de vos catégories.

## Configuration de la destination

### Configuration

<table><thead><tr><th width="357">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>ID de campagne</code></td><td><p><em><strong><code>Obligatoire</code></strong></em></p><p>Un identifiant unique attribué à la campagne et fourni par Partnerize. Ce paramètre prend en charge des valeurs dynamiques <strong>[1].</strong></p></td></tr><tr><td><code>Sélectionnez votre support de click ref</code></td><td>Cela peut être soit <code>Cookie</code> ou <code>Event property</code>, selon la manière dont vous fournissez la valeur CJ "Click Reference".</td></tr><tr><td><code>Nom du cookie pour le suivi des clics</code></td><td>Si vous sélectionnez <code>Cookie</code> dans <code>Sélectionnez votre support de click ref</code>, vous pouvez définir votre nom de cookie ici.</td></tr><tr><td><code>Event property contenant click ref</code></td><td>Si vous sélectionnez <code>Event property</code> dans <code>Sélectionnez votre support de click ref</code>, vous pouvez définir votre event property ici. <strong>[2]</strong></td></tr><tr><td><code>Chaîne d’URL de conversion personnalisée</code></td><td>Le "Conversion URL" Partnerize peut varier selon vos besoins spécifiques. Grâce à ce paramètre, vous pouvez ajouter une chaîne personnalisée avant le <a href="https://help.phgsupport.com/hc/en-us/articles/360020395238-Tracking-Partnerize-Server-to-Server-S2S-Integration#h_01FANB7W0RHFZJFAYNXJJ8AWD6">campaign</a> paramètre (p. ex. https://prf.hn/conversion/tracking_mode:api/[CUSTOM_STRING]campaign:...).</td></tr><tr><td><code>Optionnel : Partnerize Device (device)</code></td><td>Vous pouvez définir une propriété contenant les valeurs autorisées suivantes : "bot", "desktop", "mobile", "tablet" et "Other". Plus de détails sont disponibles via ce <a href="https://help.phgsupport.com/hc/en-us/articles/360020395238-Tracking-Partnerize-Server-to-Server-S2S-Integration#h_01FANBMH24SWP0F1A9M1D0E14T">LIEN</a>. <strong>[2]</strong></td></tr><tr><td><code>Optionnel : Partnerize Context (context)</code></td><td>Vous pouvez définir une propriété contenant les valeurs autorisées suivantes : "web", "m_web", "m_app", "in_app", "cd_d", "cd_p", "other" et "offline". Plus de détails sont disponibles via ce <a href="https://help.phgsupport.com/hc/en-us/articles/360020395238-Tracking-Partnerize-Server-to-Server-S2S-Integration#h_01FANBMH24SWP0F1A9M1D0E14T">LIEN</a>. <strong>[2]</strong></td></tr><tr><td><code>Propriétés d’événement personnalisées</code></td><td><p>Mappez vos propriétés d’événement personnalisées en définissant leurs noms de champ dans <code>Nom de la propriété Partnerize</code> et en ajoutant le nom du champ contenant la valeur dans <code>Your event property</code>. Ex. si vous saisissez<code>size</code>dans la <code>Nom de la propriété Partnerize</code> et <code>items.0.product.size</code> dans <code>Your event property</code>, vous aurez une propriété d’événement personnalisée dans Partnerize appelée<code>size</code>avec une valeur basée sur le contenu du champ <code>items.0.product.size</code> <strong>[2]</strong>.</p><p><br>Dans la colonne <code>Votre chemin de propriété d’event</code> vous devez conserver la valeur par défaut <code>Default (root)</code> car cela ajoutera un paramètre personnalisé au <a href="https://help.phgsupport.com/hc/en-us/articles/360020395238-Tracking-Partnerize-Server-to-Server-S2S-Integration#h_01FANB7W0RHFZJFAYNXJJ8AWD6">Base Level</a> (p. ex. voir <a href="https://help.phgsupport.com/hc/en-us/articles/360020395238-Tracking-Partnerize-Server-to-Server-S2S-Integration#h_01FANB7W0RHFZJFAYNXJJ8AWD6">campaign</a>) qui correspond mieux à la plupart des cas. Si vous sélectionnez soit <code>In "items" {items.X}</code> ou <code>In "product" {items.X.product}</code> cette destination recherchera la propriété d’event en 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>niveau respectivement et l’ajoutez comme un <a href="https://help.phgsupport.com/hc/en-us/articles/360020395238-Tracking-Partnerize-Server-to-Server-S2S-Integration#h_01FADKCBAZCZTRFZG43N1DP8TW">Basket Data</a> paramètre.<br>L’opération avancée <code>En tant que Basket Data Partnerize</code> peut être associée à l’option de chemin de propriété <code>Default (root)</code> afin que la valeur de votre propriété soit définie comme une entrée personnalisée dans le "Basket Data" Partnerize pour chaque élément.</p></td></tr></tbody></table>

{% hint style="info" %}

> **\[1]** Cette fonctionnalité vous permet de définir une propriété d’événement contenant une valeur dynamique en ajoutant deux accolades ouvrantes (`{{`) devant le nom de votre propriété et deux accolades fermantes (`}}`) à la fin (par ex. `{{myEventPropertyPathAndName}}`).\
> \&#xNAN;**\[2]** En utilisant des "points" (".") vous pouvez naviguer plus en profondeur vers le champ spécifique dont vous souhaitez obtenir la valeur. Voir [Référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) pour plus de détails sur les noms de champs standard par event. Vous pouvez aussi définir librement des champs personnalisés : il n’y a aucune limite.
> {% endhint %}

## Référence rapide

| Événements Commanders Act | Suivi Partnerize |
| ------------------------- | ---------------- |
| `generate_lead`           | `lead`           |
| `purchase`                | `sale`           |

## Mappages des champs

{% hint style="info" %}
La plupart des propriétés peuvent être remappées à l’aide de notre fonctionnalité "Smart Mapping".\
Les deux paramètres<mark style="color:bleu;">`clickref`</mark>et<mark style="color:bleu;">`conversionref`</mark>sont obligatoires.\
Les deux [Basket Data](https://help.phgsupport.com/hc/en-us/articles/360020395238-Tracking-Partnerize-Server-to-Server-S2S-Integration#h_01FADKCBAZCZTRFZG43N1DP8TW) paramètres<mark style="color:bleu;">`category`</mark>et<mark style="color:bleu;">`quantity`</mark>sont requis, tandis que<mark style="color:bleu;">`value`</mark>est nécessaire si vous souhaitez attribuer une commission sur une base en pourcentage.
{% endhint %}

<table><thead><tr><th width="432">Propriétés Commanders Act</th><th>Propriétés Partnerize</th></tr></thead><tbody><tr><td><code>ID de campagne</code></td><td><code>campaign</code> <strong>[*]</strong></td></tr><tr><td><p><code>Nom du cookie pour le suivi des clics</code> ou</p><p><code>Event property contenant click ref</code></p></td><td><code>clickref</code> <strong>[*][1]</strong></td></tr><tr><td><code>id</code></td><td><code>conversionref</code> <strong>[*]</strong></td></tr><tr><td><code>currency</code></td><td><code>currency</code> <strong>[*]</strong></td></tr><tr><td><code>items.X.affiliation</code></td><td><code>category</code> <strong>[*]</strong></td></tr><tr><td><code>items.X.quantity</code></td><td><code>quantity</code> <strong>[*]</strong></td></tr><tr><td><code>partners.partnerize.device</code></td><td><code>device</code> <strong>[2]</strong></td></tr><tr><td><code>partners.partnerize.context</code></td><td><code>context</code> <strong>[2]</strong></td></tr><tr><td><code>user.type</code></td><td><code>customertype</code></td></tr><tr><td><code>coupon</code></td><td><code>voucher</code></td></tr><tr><td><code>country</code></td><td><code>country</code> <strong>[3]</strong></td></tr><tr><td><code>items.X.id</code></td><td><code>sku</code></td></tr><tr><td><code>items.X.product.price</code></td><td><code>value</code></td></tr><tr><td><code>Your event property</code></td><td><code>conversion_time</code> <strong>[4]</strong></td></tr><tr><td><code>Your event property</code></td><td><code>Nom de la propriété Partnerize</code> <strong>[5]</strong></td></tr></tbody></table>

{% hint style="info" %}

> **\[\*]** Propriété obligatoire.\
> \&#xNAN;**\[1]** Voir [Configuration](#configuration) pour plus de détails. si aucune valeur n’est fournie, le cookie par défaut nommé [<mark style="color:bleu;">**clickref**</mark>](https://help.phgsupport.com/hc/en-us/articles/360020395238-Tracking-Partnerize-Server-to-Server-S2S-Integration#h_01FADK3BAYNPZ8FC9YF08WVAWB) est utilisé.\
> \&#xNAN;**\[2]** Voir [valeurs valides](https://help.phgsupport.com/hc/en-us/articles/360020395238-Tracking-Partnerize-Server-to-Server-S2S-Integration#h_01FANBMH24SWP0F1A9M1D0E14T).\
> \&#xNAN;**\[3]** Standard ISO 3166.\
> \&#xNAN;**\[4]** Cela doit être défini dans le<mark style="color:bleu;">`Propriétés d’événement personnalisées`</mark>en ajoutant le champ <mark style="color:bleu;">`conversion_time`</mark>en<mark style="color:bleu;">`Nom de la propriété Partnerize`</mark>et en définissant un champ contenant un horodatage Unix epoch (10 ou 13 chiffres) dans<mark style="color:bleu;">`Your event property`</mark>.\
> \&#xNAN;**\[5]** Voir<mark style="color:bleu;">`Propriétés d’événement personnalisées`</mark>dans [Configuration ](#configuration)pour plus de détails sur la manière dont vous pouvez relier des propriétés personnalisées à Partnerize.
> {% endhint %}