Acceder a las claves de API Sarbacane para la gestión de contactos.
Los conectores nativos estándar de Sarbacane (Magento, PrestaShop, WordPress, Salesforce, MySQL) sincronizan un conjunto de campos predefinidos que no incluye el consentimiento al píxel de seguimiento por defecto.
Transmitir este campo a través de un conector externo presenta un riesgo de incumplimiento relacionado con el funcionamiento unidireccional de la sincronización (desde la fuente externa hacia Sarbacane) :
Un contacto da su consentimiento al píxel en la fuente externa y se importa en Sarbacane.
El contacto retira su consentimiento al seguimiento directamente desde una campaña de Sarbacane.
Esta información de baja no se devuelve a la fuente externa.
Durante el siguiente ciclo de sincronización, la fuente externa devuelve el valor « opt-in » inicial y sobrescribe la baja registrada en Sarbacane.
Importante : la sincronización del consentimiento al píxel a través de un conector externo unidireccional corre el riesgo de reactivar silenciosamente el seguimiento de los contactos que se habían dado de baja en Sarbacane.
El consentimiento al píxel (pixelOptin) es un campo de sistema vinculado directamente al contacto (y no a una lista).
La API permite registrar el consentimiento en las siguientes situaciones:
Actualización de contactos existentes: transmisión del parámetro "pixelOptin" : "1" durante la actualización de la ficha de contacto.
Nuevas inscripciones: recopilación del consentimiento durante una inscripción a un boletín informativo, para el cual ni los formularios externos ni los formularios del sistema Sarbacane permiten escribir directamente en este campo de sistema.
Los valores aceptados son idénticos a los de la importación manual:
- "True / Verdadero / 1 / sí" para los contactos que aceptan el seguimiento
- "False / Falso / 0 / no" para los contactos que rechazan el seguimiento
Nota: El nombre exacto del campo es pixelOptin. Cualquier campo con un nombre diferente (por ejemplo optinPixel) será ignorado por la API: la solicitud se completará sin error, pero la información no se registrará en el contacto.
El campo pixelOptinAt no necesita ser completado: la fecha de consentimiento se alimenta automáticamente tan pronto como se establece pixelOptin.
Encuentre todos los campos disponibles en los contactos en la documentación para desarrolladores.
Una lista estándar (no sincronizada) puede complementar este enfoque. A diferencia de una lista sincronizada, una lista estándar no tiene una fuente externa que periódicamente envíe valores: solo evoluciona a través de acciones realizadas directamente en Sarbacane (importación puntual, formulario o API). Al integrar en ella los contactos afectados por el píxel de seguimiento y controlando su campo pixelOptin únicamente a través de la API, se elimina por construcción el riesgo de sobrescritura, ya que nada viene a reescribir este valor desde el exterior.
