Suivi côté serveur pour Shopware 6
Ajoutez une intégration Shopware avec accès en lecture aux commandes et ROASaurus synchronise les commandes payées depuis l’Admin API. Un webhook Flow Builder les fait arriver dès qu’elles sont payées.
| Shopware en un coup d’œil | |
|---|---|
| Les commandes arrivent par | Interrogation de l’Admin API toutes les 5 minutes ; instantané avec un webhook Flow Builder |
| Accès | ID de clé d’accès de l’intégration et clé d’accès secrète |
| Commandes payées | Une transaction à l’état paid |
| Identifiant de commande | Le numéro de commande Shopware |
| Extrait de la page de remerciement | Template checkout/finish, avec page.order.orderNumber |
Comment Shopware se connecte
- Ajoutez le script ROASaurus à votre thème (
base.html.twig, blocbase_script_tracking) ou avec un plugin de gestionnaire de balises. - Settings › System › Integrations › Add integration, avec accès en lecture aux commandes. Saisissez l’ID de clé d’accès et la clé d’accès secrète dans ROASaurus.
- Pour une correspondance exacte, ajoutez l’extrait de la page de remerciement à
storefront/page/checkout/finish/index.html.twig.
ROASaurus échange les clés d’intégration contre un jeton Admin API de courte durée et recherche les commandes mises à jour depuis sa dernière exécution, toutes les 5 minutes. Une commande compte comme payée quand l’une de ses transactions est à l’état paid. Le numéro de commande sert d’identifiant, ce qui correspond aussi à ce qu’envoie l’extrait de la page de remerciement.
Commandes instantanées avec Flow Builder
À partir de Shopware Evolve, créez un flow avec le déclencheur State Enter / Order Transaction / State / Paid et l’action Call URL (Webhook), en POST vers l’URL de webhook ROASaurus. L’appel n’est qu’un signal : ROASaurus ne fait pas confiance à son contenu et récupère à la place les commandes des deux dernières heures via l’API authentifiée. Les commandes qu’il a déjà sont ignorées.
Ce que ROASaurus lit dans chaque commande
Le total, la devise, la date de commande, l’e-mail et le nom du client, le téléphone, la ville, le code postal et le pays de facturation, l’identifiant client et les lignes de produits avec leur quantité, leur prix unitaire et leur numéro de produit.
Relier les commandes aux clics publicitaires
L’extrait de la page de remerciement déclenche l’achat ROASaurus avec le numéro de commande et le total, ce qui relie la commande au visiteur. Sans lui, ROASaurus utilise un e-mail que le visiteur a donné plus tôt sur votre site, par exemple dans une popup.
Limites
- Shopware anonymise par défaut l’adresse IP du client, le repli par IP est donc rarement utile. Ajoutez l’extrait de la page de remerciement.
- Les webhooks Flow Builder nécessitent Shopware Evolve ou supérieur. Sans eux, les commandes mettent jusqu’à 5 minutes à arriver.
- Le connecteur est construit d’après la documentation officielle de l’API de la plateforme. Cliquez sur Test connection après avoir enregistré vos identifiants, puis passez une commande de test et vérifiez l’Event log.
À lire aussi
Vos questions, nos réponses
Ai-je besoin de Flow Builder ?
Non. Sans lui, ROASaurus récupère les commandes payées toutes les 5 minutes. Le webhook Flow Builder, disponible à partir de Shopware Evolve, ne fait que les faire arriver immédiatement.
Le webhook Flow Builder est-il sécurisé ?
ROASaurus ne le traite que comme un signal. Il ne prend jamais de données de commande dans l’appel ; il récupère les commandes récentes via l’Admin API avec vos clés d’intégration.
De quel accès l’intégration a-t-elle besoin ?
Un accès en lecture aux commandes. ROASaurus utilise l’ID de clé d’accès et le secret de l’intégration pour obtenir un jeton Admin API de courte durée.
Chaque vente, rattachée à la publicité qui l’a générée
Suivi côté serveur, bénéfice et valeur vie client dans une seule application. Essai gratuit de 14 jours, sans carte bancaire.
Démarrez votre essai gratuit →