# Gérer les intégrations

### Étape n°1 - Paramètres

Les paramètres d'intégration sont une étape cruciale pour rassembler les éléments permettant à Didomi d'établir des connexions avec les applications tierces que vous avez choisies.

Les paramètres requis varient d'une intégration à l'autre. En savoir plus sur chaque paramètre via nos infobulles et dans notre [Documentation pour développeurs](https://developers.didomi.io/integrations/introduction).

![](https://support.didomi.io/hubfs/Screenshot_2023-01-12_at_13-28-56-png.png)

### Étape n°2 - Options

Améliorez votre intégration avec des paramètres optionnels :

* Mode upsert : garantir que les préférences des utilisateurs sont transférées pour les profils non identifiés dans l'application tierce.
* Mode bidirectionnel : récupérer les préférences des utilisateurs depuis l'application tierce vers Didomi et assurer la synchronisation des deux côtés. Cette option peut ne pas être prise en charge pour toutes les intégrations.
* E-mail transactionnel : demander un fournisseur d'e-mails spécifique pour vos e-mails transactionnels. Une fois cette option sélectionnée, vous devrez effectuer la configuration d'e-mail nécessaire comme expliqué dans ce [Documentation pour développeurs](https://developers.didomi.io/integrations/emailing).
* Options spécifiques : en fonction de l'application tierce à laquelle vous vous connectez, des options supplémentaires peuvent être demandées à cette étape. En savoir plus sur chaque paramètre via nos infobulles et dans notre [Documentation pour développeurs](https://developers.didomi.io/integrations/introduction).

![](https://support.didomi.io/hubfs/Screenshot_2023-01-12_at_13-29-34-png.png)

### Étape n°3 - Mappage

À cette étape, il vous sera demandé de configurer le mappage entre les attributs de votre arbre de configuration et les attributs de l'application tierce qui seront poussés par l'intégration Didomi.

Pour rappel, les attributs de votre arbre de configuration peuvent être :

* Un finalité
* Une préférence
* Une valeur au sein d'une préférence

![](https://support.didomi.io/hubfs/Screenshot_2023-01-12_at_13-49-08-png.png)

Pour configurer le mappage :

1. Sélectionnez votre attribut d'arbre de configuration : allez à la ligne correspondante.
2. Saisissez manuellement le nom ou sélectionnez l'attribut de l'application tierce dans la liste déroulante (la sélection dans la liste déroulante peut ne pas être disponible pour les applications tierces dont les API ne le prennent pas en charge).
   1. Si la sélection dans la liste déroulante est possible, vous pouvez facilement rechercher l'attribut de l'application tierce par nom ou par ID.

#### **Recommandations de mappage**

Le mappage le plus approprié dépend de vos besoins et de la façon dont les attributs de l'application tierce sont construits de votre côté.

Nous fournissons nos recommandations générales pour un mappage optimal et efficace :

👉 Collecte de valeurs chaîne (choix multiple) :

L'objectif ici est que, lorsque votre utilisateur sélectionne une valeur spécifique dans une préférence donnée (valeurs chaîne), cette valeur soit reflétée dans les attributs du profil sous forme de texte :

* Dans ce cas, notre recommandation est de mapper votre préférence avec l'attribut chaîne/texte de l'application tierce où la valeur sélectionnée sera poussée. **\<image preference mapped to 3rd party attribute>**

👉 Collecte de valeurs booléennes (choix unique) :

Cela peut être nécessaire dans l'un des deux cas d'utilisation suivants :

1. Lorsque votre utilisateur choisit une option au sein d'une finalité (choix “Oui” ou “Non”), vous souhaitez que cela se reflète dans son attribut de profil booléen.
   * Dans ce cas, vous devez simplement mapper la finalité avec un attribut de l'application tierce qui a un **boolean** type. **\<image purpose mapped to 3rd party attribute>**
2. Lorsque vous choisissez une valeur spécifique au sein d'une préférence. Prenons un exemple :
   1. Vous avez un attribut booléen appelé “OPTIN” dans votre application tierce
   2. Dans la plateforme Didomi Preference Management, vous collectez le statut « opt-in » via une préférence comme ci-dessous :
   * Pour la sélection de valeur : plus précisément, lorsque l'utilisateur sélectionne la valeur optin, nous voulons que cela se reflète dans l'attribut booléen OPTIN. Dans ce cas, vous pouvez simplement mapper la valeur optin avec l'attribut OPTIN. Ainsi, lorsque l'utilisateur sélectionne la valeur optin, elle sera reflétée comme “Oui” dans l'attribut OPTIN **\<image preference value mapped to 3rd party attribute>**

{% hint style="info" %}
Nous recommandons vivement de ne pas créer des préférences avec des valeurs “Oui” ou “Non”, puis de ne mapper qu'une seule valeur ("Oui", par exemple). À la place, nous suggérons d'utiliser la finalité car c'est l'objet le plus adapté pour cette option de mappage.
{% endhint %}

Limitations

* Le mappage n'est pas disponible pour le centre de préférences legacy. Veuillez contacter <support@didomi.io> si vous souhaitez configurer l'étape de mappage.
* Si vous supprimez ou déplacez une préférence dans votre arbre de configuration, cela rompra le mappage avec l'outil tiers. Assurez-vous de vérifier votre mappage après toute mise à jour de l'arbre de configuration.

Veuillez noter : pour les intégrations natives Didomi (webhook, exportations en batch, exportations analytics) l'étape de mappage n'est pas nécessaire.