Suivi côté serveur pour les boutiques Ecwid
ROASaurus lit les commandes Ecwid payées via un jeton d’application personnalisée et les envoie à vos plateformes publicitaires depuis le serveur. Demandez les webhooks au support Ecwid et les commandes arrivent instantanément.
| Ecwid en un coup d’œil | |
|---|---|
| Les commandes arrivent par | Interrogation de l’API toutes les 5 minutes ; webhooks une fois activés par le support Ecwid |
| Accès | ID de la boutique, jeton secret de l’application personnalisée et son client secret pour les webhooks |
| Vérification du webhook | Signature HMAC avec le client secret |
| Commandes payées | Statut de paiement PAID |
| Extrait de la page de remerciement | Ecwid.OnOrderPlaced, après le script de suivi |
Comment Ecwid se connecte
- Ajoutez le script ROASaurus au site qui intègre votre boutique Ecwid, ou au code personnalisé de votre Instant Site.
- Ajoutez l’extrait de la page de remerciement après celui-ci. Il écoute l’événement
OnOrderPlacedd’Ecwid et déclenche l’achat ROASaurus avec le numéro de commande, le total et l’e-mail. - Sur my.ecwid.com/#develop-apps, créez une application personnalisée avec accès en lecture aux commandes. Saisissez l’ID de votre boutique (affiché dans l’URL de votre administration et sous Account › Summary) et le jeton
secret_…de l’application dans ROASaurus.
ROASaurus récupère ensuite les commandes mises à jour depuis sa dernière exécution, toutes les 5 minutes, et envoie celles dont le statut de paiement est PAID.
Commandes instantanées avec les webhooks
Ecwid définit les URL de webhook des applications personnalisées via son équipe de support API. Demandez-leur de définir l’URL de webhook de votre application sur celle de votre onglet Connection ROASaurus, avec les événements order.created et order.updated. Collez le client secret de l’application dans ROASaurus : chaque webhook est vérifié avec sa signature HMAC, puis la commande est récupérée depuis l’API.
Ce que ROASaurus lit dans chaque commande
Le total, la devise, l’e-mail, le nom, le téléphone et l’adresse de facturation, l’identifiant client et les articles avec leur combinaison, leur quantité, leur prix et leur SKU. Les commandes Ecwid incluent l’adresse IP et le user agent de l’acheteur : ROASaurus peut donc aussi faire correspondre sur la même IP et le même navigateur, uniquement quand un seul visiteur correspond.
Limites
- Les webhooks nécessitent une demande auprès du support Ecwid. D’ici là, les commandes mettent jusqu’à 5 minutes à arriver.
- Ecwid fournit un seul champ de nom, que ROASaurus sépare en prénom et nom de famille.
- 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 dois-je contacter Ecwid pour les webhooks ?
Ecwid configure l’URL de webhook d’une application personnalisée via son support API. L’interrogation toutes les 5 minutes fonctionne sans eux.
À quoi sert le client secret ?
Il vérifie qu’un webhook provient bien d’Ecwid. ROASaurus contrôle avec lui la signature HMAC de chaque webhook avant de récupérer la commande.
Est-ce que cela fonctionne avec Ecwid intégré à un autre site ?
Oui. Ajoutez le script ROASaurus et l’extrait de la page de remerciement au site qui intègre votre boutique Ecwid.
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 →