Suivi côté serveur pour Magento 2 et Adobe Commerce
Créez une intégration Magento avec accès aux commandes et ROASaurus récupère les commandes payées via la REST API toutes les 5 minutes, puis les envoie à vos plateformes publicitaires depuis le serveur.
| Magento en un coup d’œil | |
|---|---|
| Les commandes arrivent par | Interrogation de la REST API toutes les 5 minutes |
| Accès | Jeton d’accès de l’intégration ; consumer key, consumer secret et access token secret quand l’utilisation en bearer est désactivée |
| Accès aux ressources | Sales › Operations › Orders |
| Commandes payées | État processing ou complete |
| Identifiant de commande | L’increment id que voient les clients |
Comment Magento se connecte
- Content › Design › Configuration › votre store view › HTML Head › Scripts and Style Sheets : ajoutez la balise script ROASaurus.
- System › Extensions › Integrations › Add New Integration, avec l’accès aux ressources Sales › Operations › Orders. Activez-la et copiez le jeton d’accès.
- Saisissez le jeton dans ROASaurus. N’ajoutez l’URL de la boutique que si l’API fonctionne à une autre adresse que le domaine de votre boutique.
Bearer token ou OAuth 1.0a
Depuis Magento 2.4.4, l’option « Allow OAuth Access Tokens to be used as standalone Bearer tokens » est désactivée par défaut. Si elle l’est dans votre boutique, saisissez aussi la consumer key, le consumer secret et l’access token secret de la même intégration. ROASaurus signe alors chaque requête avec OAuth 1.0a au lieu d’envoyer un bearer token.
Comment les commandes sont lues
Magento Open Source n’a pas de webhooks de commande : ROASaurus interroge donc la REST API pour les commandes mises à jour depuis sa dernière exécution, toutes les 5 minutes, avec un chevauchement de 30 minutes. Les commandes à l’état processing ou complete comptent comme payées. L’identifiant de commande est l’increment id. Les produits configurables apparaissent deux fois dans les données de commande de Magento, comme parent et enfant ; ROASaurus conserve les lignes parent pour que les quantités ne soient pas doublées.
Dans chaque commande, il lit le total général, la devise, l’e-mail et le nom du client, le téléphone et l’adresse de facturation avec le code de région, l’identifiant client et l’adresse IP du client.
Relier les commandes aux clics publicitaires
Pour une correspondance exacte, demandez à votre développeur de déclencher l’extrait d’achat ROASaurus sur checkout/onepage/success avec l’increment id de la commande et le total général. Sans lui, ROASaurus utilise un e-mail que le visiteur a donné plus tôt sur votre site, par exemple dans une popup, puis l’adresse IP quand un seul visiteur correspond.
Limites
- Pas de webhooks : les commandes parviennent à vos plateformes publicitaires jusqu’à 5 minutes après le paiement. « Fetch orders now » lance une synchronisation à la demande.
- L’extrait de la page de succès nécessite un petit module personnalisé, que votre développeur ajoute.
- 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
Pourquoi les commandes Magento sont-elles récupérées toutes les 5 minutes ?
Magento Open Source n’a pas de webhooks de commande. ROASaurus interroge à la place la REST API toutes les 5 minutes, avec un chevauchement pour qu’aucune commande ne soit manquée, et ignore les commandes qu’il a déjà.
Mon jeton est rejeté. Que vérifier ?
Depuis la 2.4.4, les bearer tokens autonomes sont désactivés par défaut. Saisissez aussi la consumer key, le consumer secret et l’access token secret, et ROASaurus signe les requêtes avec OAuth 1.0a.
Est-ce que cela fonctionne avec Adobe Commerce ?
Le connecteur utilise la REST API et les intégrations de Magento 2, que Magento Open Source et Adobe Commerce partagent.
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 →