Intégration · plateforme e-commerce
Shopware 6
App Shopware avec script storefront et webhooks de commande signés.
Comment les événements atteignent Shopware
Les webhooks de la boutique sont la source de référence pour les achats et les remboursements. Track vérifie la signature, apparie la commande avec l’achat navigateur par identifiant de commande, et ne la route qu’ensuite — le consentement est hérité, jamais présumé.
- Navigateur — le script de la boutique envoie les événements standard avec l’état du consentement et les identifiants de clic du visiteur ; l’achat porte l’identifiant de commande pour l’appariement.
- Serveur — les webhooks signés de la boutique livrent les commandes payées et les remboursements avec totaux et lignes de commande ; Track vérifie chaque signature avant d’accepter un enregistrement.
Ce que Track reçoit
Deux chemins complémentaires, appariés par identifiant de commande à l’étape d’ingestion.
- Commandes payées et remboursements issus des webhooks signés de la boutique : identifiant de commande, totaux, devise, lignes de commande et données de correspondance du client — hachées à l’ingestion.
- Événements navigateur standard de la boutique (consultation, ajout au panier, paiement, achat) avec l’enregistrement de consentement du visiteur et les identifiants de clic capturés.
- L’identifiant de commande sur les deux chemins, de sorte que l’enregistrement vérifié de la boutique remplace l’achat navigateur sans double comptage.
Jamais présumé
- Le consentement marketing : un webhook de boutique ne porte aucun consentement propre. Sans achat navigateur apparié, l’enregistrement reste un enregistrement opérationnel et n’atteint que les destinations qui ne nécessitent aucun consentement.
- Des données client en clair dans les plateformes publicitaires — les données de correspondance sont hachées avant d’être stockées.
- Des webhooks non signés ou invérifiables — un échec de vérification de signature est consigné, et le webhook écarté.
Données techniques
- Clé d’appariement
order_id— order id- Finalité du consentement
- Nécessaire
- État de l’implémentation
- Implémentée · testée avec des payloads de webhook signés et enregistrés
- Documentation du fournisseur
- Documentation Track
Ce dont vous avez besoin
Les identifiants publics peuvent être saisis dans le chat ou dans l’assistant guidé ; les secrets passent par la carte d’identifiants d’accès sécurisée ou par OAuth, et sont stockés chiffrés.
Identifiants publics
- shop_domain
- Domaine de la boutique
- default_currency
- Devise de repli
- purchase_on
- Moment de l’achat (payé ou passé) (facultatif)
Identifiants d’accès
- Secret de webhook
webhook_secret— stockées dans le coffre-fort chiffré
Consentement
Les webhooks de boutique ne portent aucun consentement propre. Une commande vérifiée hérite de l’enregistrement de consentement de l’achat navigateur apparié ; sans lui, elle est stockée comme enregistrement opérationnel et n’atteint jamais une plateforme publicitaire.
Configuration en quelques étapes
L’assistant exécute les vérifications détaillées. Vous voyez les étapes clés qui nécessitent une décision de votre part.
Connecter la boutique
Saisissez le domaine de la boutique et la devise de repli. Track génère l’URL du webhook et le secret, une seule fois.
Installer côté boutique
Installez l’extension pixel, le plugin ou l’application, puis enregistrez les webhooks avec le secret généré.
Vérifier avec une commande de test
Le premier webhook signé fait passer la connexion à l’état connecté ; les topics observés et le dernier webhook sont affichés en direct.
Extrait de Tracking Knowledge
Des guides rédigés par l’équipe qui construit ce connecteur.
Shopware 6 : un tracking bien fait — une app avec webhooks signés, la transaction payée comme achat et le snippet Storefront
Comment l'app Shopware de Track s'enregistre, quels événements de commande correspondent à purchase et refund, comment la shopware-shop-signature est vérifiée, pourquoi l'état de transaction payée vaut mieux que la commande passée, et où placer le snippet dans le thème.
Tutoriel · 3 min de lecture
Questions
Ai-je encore besoin de l’achat navigateur ?
Il est facultatif mais précieux : il porte l’enregistrement de consentement et les identifiants de clic du visiteur, que le serveur ne peut pas connaître. L’enregistrement vérifié de la boutique le remplace pour la valeur et les articles.
La même commande est-elle comptée deux fois ?
Non. L’achat navigateur, l’API serveur et le webhook de la boutique partagent l’identifiant d’événement dérivé de la commande, et l’enregistrement de conversion conserve une seule ligne par commande.
Que se passe-t-il si la plateforme renvoie un webhook ?
Les renvois produisent des identifiants d’événement déterministes et sont interceptés par la protection de déduplication au niveau de l’événement ; rien n’est compté à nouveau.
Connecter Shopware
Configurez-la avec l’assistant guidé ou laissez l’assistant IA s’en charger dans le chat.