Les événements personnalisés déclenchent des workflows d'automatisation via l'API et transmettent des données supplémentaires pour la personnalisation. Chaque événement peut inclure des champs personnalisés, tels que des numéros de suivi, des détails sur le produit ou des liens d'examen, à utiliser dans le contenu du Workflow.

Alors que les déclencheurs standard (comme Commande passée ou Panier abandonné) couvrent des événements courants, les Événements personnalisés vous permettent d'automatiser des actions uniques telles que l'examen soumis ou le bon cadeau créé qui vont au-delà des déclencheurs intégrés d'Omnisend.

Pour que le Custom event commence à fonctionner, vous devrez l'ajouter à votre compte Omnisend et le configurer du côté tiers.

Naviguez vers Paramètres de la boutique → API → Custom events → Cliquez sur Créer un Custom event pour commencer.

Vous serez redirigé vers la documentation de l'API, où votre développeur pourra finaliser la configuration et créer l'Custom event.Ici, vous devez :

Allez dans Paramètres de la boutique API Créer une clé API et copiez votre clé API.

Dans la documentation de l'API, sélectionnez En-tête et collez votre clé API dans le champ En-tête.

Suivez l'assistant pour entrer les détails de l'événement requis :

Une fois terminé, cliquez sur Essayez-le pour créer l'événement.

Propriétés(également étiqueté comme champs personnalisés dans Omnisend)passer des données supplémentaires avec chaque événement (par exemple, nom du produit, URL de suivi, note de révision). Ces données peuvent être utilisées dans les filtres de workflow, les conditions de séparation et la personnalisation des messages.

Pour ajouter des propriétés d'événement, allez à Propriétés → Objet de propriétés. Entrez le nom de la propriété et sa valeur. Pour inclure des propriétés supplémentaires, cliquez sur Ajouter un champ, puis saisissez le nom de la prochaine propriété et sa valeur.

Une fois que votre Custom event est transmis à Omnisend, vous pouvez revoir les propriétés de l'événement synchronisé en allant dans Paramètres de la boutique → API → Custom Events.

Étape 1 : Créez un Workflow.

Une fois que vous ajoutez le déclencheur d'événement personnalisé, tous les paramètres de workflow se remplissent avec les données de l'événement :

Vous pouvez utiliser les données des champs personnalisés pour personnaliser le contenu de vos messages, y compris l'Email, le SMS et les notifications push.

Si vous passez un lien en tant que propriété d'événement, vous pouvez également l'utiliser avec un bouton dans votre email.

Lorsque vous utilisez un événement personnalisé pour déclencher un workflow d'automatisation, le bloc de contenu du pied de page inclut par défaut un lien de désinscription.

Nous recommandons d'inclure ce lien dans tous les messages. Cependant, il n'est pas requis si le message est transactionnel (par exemple, lié à une commande passée par le client).

C'est attendu puisque les événements apparaissent dans la liste des déclencheurs d'automatisation uniquement après avoir été déclenchés au moins une fois.

Une erreur 400 indique un problème lié à la charge utile, ce qui signifie que la requête envoyée à Omnisend est invalide. Ces erreurs proviennent du côté de l'expéditeur, pas d'Omnisend.

Shopify Flow utilise un point de terminaison et une structure JSON différents de l'API standard d'Omnisend, donc les champs personnalisés peuvent ne pas apparaître comme prévu.

Pour résoudre cela :

Pour des instructions complètes d'installation, référez-vous à l'article Intégrer Shopify Flow avec Omnisend.

Pourquoi la documentation API les appelle-t-elle "propriétés d'événement" mais Omnisend les appelle-t-il "champs personnalisés" ?

C'est une différence de terminologie entre la documentation de l'API et l'interface Omnisend. Lorsque vous créez des propriétés d'événement dans la documentation de l'API, elles se synchronisent avec Omnisend et sont affichées comme champs personnalisés dans les workflows d'automatisation, les déclencheurs, les répartitions et la personnalisation des messages. Les deux termes font référence aux mêmes données : les informations supplémentaires transmises avec chaque événement personnalisé.

Non. Les noms des propriétés ne peuvent pas être changés une fois l'événement créé. Si vous devez renommer une propriété, vous devrez supprimer l'événement existant et en créer un nouveau avec le nom de propriété mis à jour.

Puis-je passer des URL dans les propriétés d'événement ?

Oui. Les URL peuvent être passées en tant que valeurs de chaîne dans les propriétés de l'événement. Ils peuvent être utilisés dans des filtres d'automatisation, des conditions de séparation, des règles de segmentation, ou directement dans le contenu du message en utilisant des variables de personnalisation comme [[event.referralLink]].