Comprendre la synchronisation des données Shopify avec Brevo

Tajo transfère les données Shopify vers Brevo de deux façons. L’application Shopify de Tajo traite les webhooks Shopify dès leur arrivée. Les règles de synchronisation sont approuvées par un humain, unidirectionnelles, exécutées par lots et journalisées de bout en bout. Cet article explique les deux, ce qu’elles n’incluent pas, et les quelques éléments que l’application Shopify de Tajo réécrit vers Shopify.

Vérification rapide Cet article suppose que vous avez connecté Shopify et Brevo et publié au moins une règle de synchronisation. Sinon, commencez par connecter Tajo à Shopify.

Au fil des événements : l’application Shopify de Tajo

L’application Shopify de Tajo s’abonne aux webhooks Shopify et traite chacun d’eux dès son arrivée. Les modifications de clients et de produits attendent d’abord environ quatre secondes. Les clients, commandes, checkouts, produits, collections et niveaux de stock parviennent ainsi à Brevo, de même que des événements comme order_paid et cart_abandoned. Le guide d’intégration Shopify liste chaque sujet et ce qu’il écrit dans Brevo.

L’anatomie d’une règle de synchronisation

Une règle de synchronisation est une définition examinée et approuvée de ce qui circule exactement, et comment. Un agent la construit à partir de votre description, et une personne l’approuve. Une règle comporte quatre parties que vous pouvez inspecter sur sa page, sous Connections > Syncs and mappings :

Partie	Rôle
Mappage des champs	Chaque champ source, le champ Brevo dans lequel il écrit et la transformation éventuelle entre les deux
Expression de filtre	Évaluée pour chaque enregistrement ; les enregistrements qui ne correspondent pas sont ignorés
Curseur	Suit la progression de la synchronisation, pour que chaque exécution reprenne là où la précédente s’est arrêtée
Historique des exécutions	Chaque exécution, avec les enregistrements lus, écrits et en échec, ainsi que la durée et le statut

Une règle de synchronisation déplace les données dans un seul sens : de votre source vers Brevo. Elle n’écrit jamais dans Shopify. L’application Shopify de Tajo réécrit en revanche quelques éléments vers Shopify, comme les désinscriptions et les tags de niveau de fidélité. Les autorisations Shopify expliquées listent chaque écriture et le moment où elle a lieu.

Quand une règle de synchronisation s’exécute

Les règles de synchronisation s’exécutent par lots. Les règles de synchronisation des contacts s’exécutent toutes les 15 minutes par défaut. Une règle Shopify orders → Brevo orders active et publiée s’exécute elle aussi toutes les 15 minutes, mais uniquement avec le filtre d’opt-in marketing de l’acheteur du modèle. Une règle dont le filtre a été modifié ne s’exécute que lorsque vous la lancez. La première exécution planifiée d’une règle de commandes commence quelques minutes avant ce moment et n’envoie aucune commande plus ancienne. Chaque exécution suivante envoie les commandes mises à jour depuis la précédente. Les commandes antérieures n’arrivent dans Brevo que lorsque vous exécutez la règle vous-même. La page d’une règle active comporte un bouton Test run (1 batch), et l’agent Sync Operator exécute les règles actives lorsque vous le lui demandez. Ce sont les exécutions par lots qui rendent chaque écriture vérifiable, budgétée et attribuable à une exécution précise.

Chaque exécution lit les enregistrements nouveaux et modifiés depuis le curseur, applique le filtre, mappe les champs et écrit dans Brevo. L’enregistrement de l’exécution montre exactement combien d’enregistrements ont été lus, écrits et en échec.

Les garanties de gouvernance

Le consentement bloque par défaut

Une règle qui écrit des données personnelles dans Brevo ne peut pas être publiée sans le filtre de consentement et de suppression. À l’exécution, un contact écrit dans une audience marketing sans consentement prouvable est refusé. Quand le consentement ne peut pas être établi, Tajo refuse l’écriture plutôt que de deviner. Le mode d’échec est toujours « trop prudent », jamais « trop envoyé ».

Les exécutions sont idempotentes

Chaque écriture porte une clé dérivée de l’enregistrement source. Cette clé est un hash : elle ne contient aucune donnée personnelle. Réexécuter une synchronisation sur les mêmes enregistrements, après un échec, une pause ou manuellement, ne crée pas d’écritures en double.

Tout est audité

La publication d’une règle, les approbations invalidées et les mises en pause automatiques sont consignées sous Activity. Chaque décision d’approbation comporte une justification écrite. Chaque exécution est consignée dans l’historique des exécutions de la règle. L’approbation qui a autorisé une publication est liée à une empreinte de la règle exacte qui a été prévisualisée. Modifier la règle la remet en brouillon et invalide l’approbation : ce qui s’exécute est donc toujours ce qui a été autorisé.

Les échecs mettent la règle en pause

Si cinq exécutions consécutives échouent, un disjoncteur met automatiquement la règle en pause et affiche la dernière erreur sur la page de la règle. Corrigez la cause, puis republiez pour reprendre. Une exécution partiellement échouée indique son nombre d’échecs, pour que vous voyiez exactement ce qui n’a pas abouti.

Comment les désabonnements sont respectés

Lorsqu’un contact se désabonne via le lien en pied de page d’un e-mail Brevo, ce refus est enregistré sur le contact, et Brevo l’exclut des campagnes suivantes.
Dans la synchronisation des clients par lots, l’application Shopify de Tajo compare l’heure du consentement Shopify à celle du désabonnement Brevo et retient la plus récente.
Une modification du consentement qui arrive de Shopify par webhook est écrite dans Brevo telle que Shopify la transmet.
Si le contact était inscrit dans Shopify, l’application Shopify de Tajo le marque aussi comme désinscrit dans Shopify. Un événement Brevo ne fait passer un client que d’inscrit à désinscrit. Il n’inscrit jamais personne : une inscription dans Brevo ne change donc rien dans Shopify.

Quelles données sont disponibles

L’application Shopify de Tajo envoie les contacts, les commandes, les événements de commande et de panier, le catalogue produits et les stocks. Ce qu’une règle de synchronisation envoie dépend de son mapping des champs. Pour les clients Shopify, le modèle mappe les champs d’identité, le total dépensé, le nombre de commandes, les tags et l’opt-in vers des attributs de contact Brevo utilisables dans les segments et les campagnes. Le mappage exact de votre espace de travail n’est pas caché dans une description : ouvrez la règle de synchronisation et lisez le tableau de mappage des champs. Ce tableau est la réponse qui fait foi à la question « qu’est-ce qui se synchronise ? ».

Ce que Tajo ne fait pas aujourd’hui

Être précis sur les limites compte davantage qu’une longue liste de fonctionnalités :

Pas de règles de synchronisation bidirectionnelles. Une règle de synchronisation n’écrit que dans Brevo. Les écritures propres à l’application Shopify vers Shopify (désinscriptions, métachamps d’engagement et de fidélité Brevo, tags de niveau de fidélité) sont listées dans les autorisations Shopify expliquées.
Pas de règles de synchronisation en temps réel. Les règles de synchronisation s’exécutent par lots. Seule la synchronisation par webhooks de l’application Shopify de Tajo fonctionne au fil des événements.
Pas de bouton de retour en stock. L’application maintient le stock des produits à jour dans Brevo et envoie un événement back_in_stock aux acheteurs qui ont demandé à être prévenus. La demande doit provenir de votre vitrine : l’application n’ajoute pas de bouton « Me prévenir » à votre thème.

Si l’une de ces limites bloque un cas d’usage pour vous, dites-le à l’équipe : les priorités de l’accès anticipé sont façonnées précisément par ces retours.

Où voir vos données

Dans Tajo : ouvrez la règle de synchronisation sous Connections > Syncs and mappings pour l’historique des exécutions, la position du curseur et les compteurs par exécution. Activity consigne les publications et les mises en pause automatiques.
Dans Brevo : ouvrez Contacts et inspectez les attributs d’un contact pour confirmer que les champs mappés se remplissent. Construisez des segments sur ces attributs pour votre ciblage.

Dépannage

Les contacts n’apparaissent pas dans Brevo : vérifiez la dernière exécution de la règle (échecs) et son statut (une règle en pause ne s’exécute pas). Consultez contacts manquants dans Brevo.
Les exécutions échouent à répétition : le disjoncteur mettra la règle en pause et affichera la dernière erreur. Consultez données non synchronisées.
Contacts en double : les écritures sont idempotentes par enregistrement source, mais les doublons préexistants dans Brevo demeurent. Consultez contacts en double.

Questions fréquentes

Puis-je accélérer la synchronisation ? La page d’une règle active comporte un bouton Test run (1 batch). Pour les modifications au fil de l’eau, la synchronisation par webhooks de l’application Shopify de Tajo couvre déjà les clients, les commandes, les checkouts, les produits et les stocks.

Que se passe-t-il si une exécution échoue à mi-chemin ? L’exécution indique son nombre d’échecs, le curseur n’avance que sur ce qui a été traité, et l’exécution suivante reprend le terrain en toute sécurité ; les clés d’idempotence empêchent les doublons.

Puis-je changer ce qui se synchronise ? Oui. Demandez à l’agent de modifier le mappage des champs ou le filtre de la règle. La modification remet la règle en brouillon, et elle doit repasser par l’aperçu et l’approbation avant de s’exécuter à nouveau.

Pourquoi ma règle s’est-elle mise en pause toute seule ? Des échecs d’exécution consécutifs déclenchent le disjoncteur. La page de la règle montre le nombre d’échecs et la dernière erreur ; corrigez le problème et republiez.

Obtenir de l’aide

Contactez l’équipe.