curl -X POST "https://a.klaviyo.com/api/events/" \
-H "Authorization: Klaviyo-API-Key VOTRE_CLE" \
-H "Content-Type: application/json" \
-d '{"data":{"type":"event","attributes":{"metric":{"name":"Achat categorie premium"}}}}'Cette requête, exécutée depuis un hook WooCommerce à chaque commande contenant un produit de la catégorie « premium » du catalogue, a permis de construire un segment Klaviyo impossible à obtenir avec la seule intégration officielle Klaviyo-WooCommerce, qui expose des événements standards mais pas de granularité par catégorie de produit personnalisée.
Le besoin venait d’une marque de cosmétiques vendant à la fois des gammes d’entrée de gamme et une ligne premium : l’équipe marketing voulait cibler par e-mail les clients ayant déjà acheté dans la ligne premium avec des offres différentes de celles adressées au reste de la base, sans recréer manuellement ce segment chaque semaine.
Ce que l’intégration native pousse déjà
L’intégration officielle Klaviyo-WooCommerce synchronise nativement les événements standards : « Placed Order », « Ordered Product », « Started Checkout », « Viewed Product », avec les propriétés associées habituelles (montant, produits, catégories principales). Ce socle alimente déjà les segments les plus courants — clients ayant commandé récemment, paniers abandonnés — sans configuration supplémentaire.
Les événements personnalisés à construire soi-même
Pour aller au-delà de ce socle, quatre événements personnalisés ont été ajoutés, chacun avec des propriétés pensées explicitement pour construire des segments, pas seulement pour informer :
Achat categorie premium: déclenché à chaque commande contenant un produit de la ligne premium, avec le montant premium isolé du reste de la commande.Retour produit signale: déclenché à chaque demande de retour, avec le motif renseigné par le client, pour exclure temporairement ces clients de campagnes promotionnelles agressives.Programme fidelite palier atteint: déclenché quand un client franchit un seuil de points cumulés, pour déclencher une communication dédiée au palier suivant.Frequence achat elevee: déclenché de façon calculée (pas à chaque commande) quand un client dépasse un rythme d’achat défini sur une fenêtre glissante de 90 jours.
Étape 1 : envoyer l’événement avec des propriétés exploitables
Un événement Klaviyo mal construit — sans propriété structurée, avec juste un nom générique — ne permet aucun filtrage fin côté segment. Chaque événement personnalisé de ce projet porte systématiquement l’identifiant client, la valeur monétaire concernée, et au moins une propriété catégorielle exploitable en filtre de segment :
add_action( 'woocommerce_order_status_completed', function( $order_id ) {
$order = wc_get_order( $order_id );
$montant_premium = 0;
foreach ( $order->get_items() as $item ) {
if ( has_term( 'premium', 'product_cat', $item->get_product_id() ) ) {
$montant_premium += $item->get_total();
}
}
if ( $montant_premium > 0 ) {
klaviyo_push_event( $order->get_billing_email(), 'Achat categorie premium', array(
'montant' => $montant_premium,
'commande_id' => $order_id,
) );
}
} );Étape 2 : construire le segment dans Klaviyo
Une fois l’événement disponible côté Klaviyo, le segment se construit directement dans l’interface, en combinant plusieurs conditions : « a déclenché Achat categorie premium au moins une fois » ET « n’a pas déclenché Retour produit signale dans les 30 derniers jours », par exemple, pour éviter d’envoyer une offre promotionnelle premium à un client en litige actif sur une commande récente.
Étape 3 : vérifier la fraîcheur des données côté segment
Un segment Klaviyo basé sur un événement personnalisé n’est fiable que si l’événement est poussé de manière fiable à chaque occurrence, sans trou. La vérification mise en place consiste à comparer, chaque semaine, le nombre de commandes premium comptées côté WooCommerce et le nombre d’événements reçus côté Klaviyo sur la même période, avec une alerte si l’écart dépasse un seuil de tolérance de deux pour cent.
Conseil maison : ne poussez jamais un événement Klaviyo sans propriété structurée exploitable en segment. Un événement qui se contente de dire « quelque chose s’est passé » sans dire quoi précisément ne sert à rien pour la segmentation marketing, seulement pour de la notification brute.
En résumé
Segmenter finement une base client WooCommerce dans Klaviyo suppose de dépasser les événements standards de l’intégration native, en poussant des événements personnalisés porteurs de propriétés pensées pour le filtrage. La création des templates d’e-mail exploitant ensuite ces segments, entièrement pilotée côté Klaviyo, reste hors du périmètre de cette intégration technique.
