Prérequis
Avoir accès aux clés d'API Sarbacane.
Limites des connecteurs natifs et risque de réabonnement.
Les connecteurs natifs standards de Sarbacane (Magento, PrestaShop, WordPress, Salesforce, MySQL) synchronisent un jeu de champs prédéfini qui n'inclut pas le consentement au pixel de suivi par défaut.
Transmettre ce champ via un connecteur externe présente un risque de non-conformité lié au fonctionnement à sens unique de la synchronisation (de la source externe vers Sarbacane) :
Un contact donne son consentement au pixel sur la source externe et est importé dans Sarbacane.
Le contact retire son consentement au suivi directement depuis une campagne Sarbacane.
Cette information de désabonnement ne remonte pas vers la source externe.
Lors du cycle de synchronisation suivant, la source externe renvoie la valeur « opt-in » initiale et écrase le désabonnement enregistré dans Sarbacane.
Important : la synchronisation du consentement au pixel via un connecteur externe à sens unique risque de réabonner silencieusement au suivi des contacts qui s'étaient désinscrits dans Sarbacane.
Solution 1 : gérer le consentement via l'API Sarbacane
Le consentement au pixel (pixelOptin) est un champ système rattaché directement au contact (et non à une liste).
L'API permet d'enregistrer le consentement dans les situations suivantes :
Mise à jour de contacts existants : transmission du paramètre "pixelOptin" : "1" lors de la mise à jour de la fiche contact.
Nouvelles inscriptions : collecte du consentement lors d'une inscription à une newsletter, pour laquelle ni les formulaires externes ni les formulaires système Sarbacane ne permettent d'écrire directement dans ce champ système.
Les valeurs acceptées sont identiques à celles pour l’import manuel :
- “True / Vrai / 1 / oui” pour les contacts qui acceptent le tracking
- “False / faux / 0 / non” pour les contacts refusant le tracking
Note : Le nom exact du champ est pixelOptin. Tout champ nommé différemment (par exemple optinPixel) sera ignoré par l'API : la requête aboutira sans erreur, mais l'information ne sera pas enregistrée sur le contact.
Le champ pixelOptinAt n'a pas à être renseigné : la date de consentement est alimentée automatiquement dès que pixelOptin est positionné.
Retrouvez l'ensemble des champs disponibles sur les contacts dans la documentation développeurs.
Solution 2 : gérer le consentement via une liste standard
Une liste standard (non synchronisée) peut d'ailleurs venir compléter cette approche. Contrairement à une liste synchronisée, une liste standard n'a pas de source externe qui repousse périodiquement des valeurs : elle n'évolue que par les actions faites directement dans Sarbacane (import ponctuel, formulaire, ou API). En y intégrant les contacts concernés par le pixel de tracking et en pilotant leur champ pixelOptin uniquement via l'API, on élimine par construction le risque d'écrasement, puisque rien ne vient jamais réécrire cette valeur depuis l'extérieur.