Shopify

OneSignal s’est associé à Vendo pour créer une intégration Shopify transparente. Vendo déploie le SDK OneSignal sur votre boutique Shopify en un clic — aucune modification manuelle du code du thème n’est requise. Il synchronise les tags clients, les événements de navigation côté client et les événements commerciaux côté serveur vers OneSignal pour vous permettre de créer des segments et de déclencher des campagnes push à partir de comportements réels et de l’historique d’achat. Pour la documentation de Vendo, consultez Vendo OneSignal Destination.

​

Prérequis

Avant de commencer, assurez-vous d’avoir :

• Une boutique Shopify avec l’application Vendo installée
• Un compte et une application OneSignal (plateforme Web)
• Votre App ID OneSignal (obligatoire)
• Votre REST API Key OneSignal (obligatoire pour les événements côté serveur comme la synchronisation des commandes et le balisage des utilisateurs)

​

Configuration OneSignal

​

Configuration Vendo

​

Suivi

​

Identification des utilisateurs

Vendo utilise une approche réservée aux utilisateurs identifiés — les visiteurs anonymes ne sont pas suivis dans OneSignal. Les utilisateurs doivent être identifiés via l’une des quatre méthodes avant que les événements soient envoyés. Cela évite les doublons d’utilisateurs et garantit des données propres et exploitables.

​

Fusion d’identités

Si un abonné push (identifié par l’ID OneSignal) se connecte ensuite ou finalise un achat, Vendo appelle OneSignal.login() avec son Shopify Customer ID ou son e-mail. OneSignal associe l’abonnement push à l’utilisateur identifié — aucun doublon d’utilisateur n’est créé. Tous les abonnements push passés sont conservés, et les événements côté serveur (commandes, exécutions) atteignent le bon profil utilisateur.

​

Tags clients

Vendo synchronise les propriétés des clients sous forme de tags dans OneSignal pour la segmentation. Toutes les valeurs sont stockées sous forme de chaînes (format natif d’OneSignal).

​

Événements côté client

Vendo suit les événements personnalisés côté client sur votre boutique via le Shopify Web Pixel et les envoie à OneSignal. Ces événements ne sont envoyés qu’après identification de l’utilisateur.

​

Événements côté serveur

Les événements commerciaux Shopify sont exportés et transmis à OneSignal via le pipeline Vendo. Ils utilisent toujours le Shopify Customer ID comme external_id.

​

Propriétés communes des événements

Tous les événements incluent ces propriétés (sous forme de chaînes) :

​

Fréquence de synchronisation des données

​

Détails de la plateforme

​

Cas d’utilisation

​

Récupération de panier abandonné

Créez un Journey déclenché par l’événement abandoned_checkouts. Attendez 1 heure après l’abandon, puis envoyez une notification push avec le lien de récupération en utilisant la propriété checkout_url.

​

Mises à jour du statut de commande

Créez des Journeys pour fulfilled_orders et delivered_orders pour envoyer des notifications push immédiates avec les informations de suivi lorsque les commandes sont expédiées et livrées.

​

Engagement des clients VIP

Créez un segment où total_spent est supérieur à un seuil, puis envoyez des offres exclusives personnalisées avec le tag first_name.

​

Campagnes de réengagement

Ciblez les clients inactifs en créant un segment où last_order_date est antérieur de plus de 90 jours et envoyez des campagnes de reconquête.

​

Sources compatibles

OneSignal fonctionne avec les sources de données Vendo suivantes : Les événements et tags utilisateurs nécessitent Shopify ou Stripe comme source de données. Les segments d’audience peuvent être construits à partir de n’importe quelle donnée source dans votre jeu de données BigQuery.

---

​

Tests

---

​

Dépannage

​

Le service worker renvoie 404

Le service worker doit se trouver à /apps/vendo/OneSignalSDKWorker.js. Si vous voyez une erreur 404 au chemin racine (/OneSignalSDKWorker.js), le chemin du service worker n’est pas configuré dans OneSignal — suivez l’étape de configuration du service worker. Si le 404 est au chemin /apps/vendo/, vérifiez que l’application Vendo est installée et que le bloc de thème est activé.

​

L’invite push n’apparaît pas

Vérifiez que le bloc de thème Vendo est activé dans App embeds. Vérifiez que votre navigateur autorise les notifications (cliquez sur l’icône de cadenas dans la barre d’adresse). Essayez une fenêtre de navigation privée au cas où l’invite aurait été précédemment refusée.

​

Les tags n’apparaissent pas dans OneSignal

Les tags ne se synchronisent que pour les utilisateurs identifiés — les visiteurs anonymes ne sont pas suivis. Assurez-vous que l’utilisateur a été identifié via un abonnement push, une connexion, une inscription à la newsletter ou un paiement. Les premières synchronisations de tags peuvent prendre plusieurs heures.

​

Les événements ne se déclenchent pas

Vérifiez que les événements sont activés dans l’application Vendo sous OneSignal > Events. Les événements côté client nécessitent que le Shopify Web Pixel soit actif et que l’utilisateur soit identifié. Les événements côté serveur nécessitent que la REST API Key soit configurée.

​

Les notifications affichent “Livré” mais n’apparaissent pas

L’intégration fonctionne — le problème vient de vos paramètres de notification du navigateur ou du système d’exploitation. Vérifiez les paramètres de notification de votre système d’exploitation pour votre navigateur, assurez-vous que le mode Ne pas déranger / Concentration est désactivé, et vérifiez les permissions de notification au niveau du navigateur.

---

​

FAQ

​

Puis-je changer l’identifiant client après la configuration ?

Oui. Mettez à jour le paramètre dans l’application Vendo sous Settings > Customer Identifier. Changer l’identifiant peut créer des profils utilisateur séparés si les utilisateurs existants ont déjà été identifiés avec la méthode précédente.

​

L’intégration Vendo prend-elle en charge les applications mobiles ?

L’intégration Vendo se concentre sur les boutiques Shopify et le push web. Si vous avez également une application mobile, assurez-vous que l’identifiant que vous sélectionnez dans Vendo correspond à celui que vous utilisez dans votre application mobile pour que les profils utilisateurs restent cohérents.

​

Que se passe-t-il si un visiteur n’est jamais identifié ?

Les événements des visiteurs non identifiés ne sont pas envoyés à OneSignal. Une fois que le visiteur s’identifie (en s’abonnant au push, en se connectant, en s’inscrivant à une newsletter ou en finalisant un achat), Vendo commence à envoyer des événements. Cette approche réservée aux utilisateurs identifiés évite les doublons et garantit des données propres.

​

Pourquoi Vendo utilise-t-il une approche réservée aux utilisateurs identifiés ?

Les versions précédentes suivaient les visiteurs anonymes en utilisant le cookie de session Shopify comme identifiant. Cela créait des utilisateurs OneSignal en double qui ne pouvaient jamais être correctement fusionnés, entraînant des comptages d’utilisateurs gonflés et des données fragmentées. L’approche réservée aux utilisateurs identifiés garantit que chaque utilisateur OneSignal est réel et exploitable.

---

​

Pages associées