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és tels que le routage multi-listes et les recommandations 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 à 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 selon le magasin, la langue ou le programme.

Mappage personnalisé

/**
 * Mappe les données du compte Wallet de l’équipe au format Klaviyo.
 *
 * @param {Object} account - Données provenant de l’équipe Wallet
 * @param {Object} data - Données envoyées à Klaviyo. Le mappage standard a déjà été 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 configuration unique listId configuration.

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 préproduction.

  • Validez sur un petit ensemble de profils de test.

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

  • Effectuez un retour arrière en supprimant le point d’entrée du script, puis retestez.

FAQ

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

Oui. Une fois déployés, les scripts peuvent modifier la manière 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