This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Extensibilité

Modèles de configuration avancée tels que le routage multi-listes et les conseils de déploiement sécurisé.

L’extensibilité est utilisée lorsque le comportement par défaut du connecteur Klaviyo ne correspond pas au modèle de données de la marque.

L’extension la plus courante est le routage des abonnements vers plusieurs listes.

Exemples concrets
  • Une marque achemine consents_email vers une liste « Newsletter » et consents_sms vers une liste « VIP SMS ».

  • Un partenaire a besoin d’un routage personnalisé des listes basé sur le magasin, la langue ou le programme.

Mappage personnalisé

/**
 * Mappe les données du compte de l'équipe Wallet au format Klaviyo.
 *
 * @param {Object} account - Données provenant de l'équipe Wallet
 * @param {Object} data - Données envoyées à Klaviyo. Le mappage standard est déjà appliqué à cet objet.
 */
function mapToKlaviyo(account, data){
  const phoneNumber = account["phoneNumber"]
  if(phoneNumber){
    data.phone_number = phoneNumber; 
  }
}

export default function(context) {
  context.register('extensions.klaviyo.mapper', {
    MapToKlaviyo: mapToKlaviyo
  });
}

Abonnements à plusieurs listes via /server/script/klaviyo.js

Ce modèle remplace la listId configuration unique.

Détails d’implémentation et exemple de code : Plusieurs listes (avancé).

Consignes de déploiement et de sécurité

Un déploiement prudent réduit les surprises dans la segmentation et le consentement.

  • Commencez en environnement de préproduction.

  • Validez sur un petit ensemble de profils de test.

  • Surveillez les événements et les propriétés des profils dans Klaviyo.

  • Restaurez en supprimant le point d’entrée du script, puis testez à nouveau.

FAQ

Une modification du script affecte-t-elle les profils existants ?

Oui. Une fois déployés, les scripts peuvent modifier la façon dont les mises à jour d’abonnement sont calculées pour tout profil passant par un parcours d’inscription.

La validation en préproduction est recommandée.

Mis à jour