Interrogez vos données à l’aide de l’API Insights

Interrogez programmatiquement les événements Wallet avec l’API Insights pour des tableaux de bord personnalisés, des rapports automatisés et des workflows BI.

Le Tableaux de bord Analytics affichent visuellement les données Wallet. Le API Insights donne un accès programmatique à ces mêmes données, afin que les équipes puissent créer des tableaux de bord personnalisés, alimenter des outils BI, effectuer des analyses ad hoc ou automatiser les rapports.

Aucun code n'est requis pour exporter les données. Le Rapport page permet aux équipes d'exporter les données d'événements au format CSV depuis le back-office.

Exemples concrets

• Une équipe marketing compare le volume d'installations par Medium après une campagne CRM.

• Une équipe opérationnelle suit les scans par magasin et surveille les tendances de désinstallation par programme.

• Une équipe BI intègre les événements Wallet dans Tableau, Looker ou Power BI pour les rapports hebdomadaires.

Qu'est-ce que l'API Insights ?

L'API Insights est une interface de requête pour les événements Wallet stockés dans la plateforme The Wallet Crew. Chaque événement suivi peut être interrogé, y compris les créations de cartes, les installations, les désinstallations, les scans, les notifications et les mises à jour. C'est le bon choix lorsque le tableau de bord du back-office ne suffit pas, par exemple pour des plages de dates personnalisées, des regroupements personnalisés, l'ingestion BI ou des rapports automatisés.

Ce que vous pouvez interroger

L'API Insights couvre les mêmes événements opérationnels utilisés pour le suivi et le reporting. Chaque événement répond à une question métier différente.

Événement	Ce qu'il capture	Exemple de question à laquelle vous pouvez répondre
Carte:Créée	Lorsqu'un enregistrement de carte a été créé	Combien de cartes ont été émises ce mois-ci par magasin ?
Carte:Installée	Lorsqu'une carte a été ajoutée à Apple Wallet ou Google Wallet, avec des données sources telles que Medium, Tag, URL, et Hôte	Quelle campagne e-mail a généré le plus d'installations la semaine dernière ?
Carte:Désinstallée	Lorsqu'une carte a été entièrement supprimée de tous les Wallet	Quel est le taux de désinstallation par programme ?
Carte:Mise à jour	Lorsque les données de la carte ont été modifiées	Combien de cartes ont été mises à jour après la dernière campagne ?
Carte:Envoi de mise à jour	Lorsqu'une mise à jour push a été envoyée à un appareil	Les mises à jour atteignent-elles les appareils de manière fiable ?
Carte:Scannée	Lorsqu'un code-barres de carte a été scanné	Combien de scans par jour ont eu lieu dans chaque emplacement ?
Carte:Notification envoyée	Lorsqu'une notification push a été envoyée	Combien de notifications ont été envoyées par programme ce mois-ci ?

Filtres disponibles

Toutes les requêtes prennent en charge le filtrage par plage de dates, modèle de carte, type d'événement et source d'installation. Les filtres de source incluent Medium, Tag, URL, et Hôte.

Tout champ de métadonnées de carte peut également être utilisé comme filtre. Cela inclut des champs métier tels que storeId, programmeId, la région ou toute métadonnée personnalisée stockée sur la carte.

En quoi cela se rapporte aux tableaux de bord Analytics

Le Analytics les tableaux de bord sont construits sur l'API Insights. Tout ce qui est visible dans les tableaux de bord peut également être interrogé directement via l'API, avec plus de flexibilité sur les regroupements, les filtres et les plages de dates.

Pour une vue sans code de ces mêmes données, utilisez Tableaux de bord Analytics. Pour envoyer les événements vers des outils externes en temps réel, voir Envoyer les événements Wallet vers vos outils.

Premiers pas

La voie la plus rapide consiste à s'authentifier, à examiner les points de terminaison disponibles et à exécuter une première requête agrégée.

1

1. S'authentifier

Utilisez la clé API dans l' X-API-KEY en-tête.

X-API-KEY: <API_KEY>

2

2. Explorer les points de terminaison disponibles

Utilisez le API Insights pour examiner les points de terminaison, les paramètres et les structures de réponse.

3

3. Commencez par une requête simple

Commencez par un décompte des Carte:Installée événements sur les 30 derniers jours. Regroupez le résultat par Medium pour voir quelle source d'acquisition a généré le plus d'ajouts à Wallet pendant la période.

Cette première requête permet de vérifier rapidement que l'authentification fonctionne et que les données source sont disponibles sur le programme.

Cas d'utilisation courants

La plupart des équipes commencent par un besoin de reporting récurrent, puis approfondissent l'analyse. Le même flux d'événements peut prendre en charge à la fois le suivi opérationnel et les workflows BI.

• Alimentez Tableau, Looker ou Power BI avec les décomptes d'installations et de désinstallations.

• Automatisez un rapport hebdomadaire des performances du programme par magasin ou par région.

• Construisez un tunnel d'activation personnalisé en corrélant Carte:Créée avec Carte:Installée.

• Interrogez les événements de scan pour créer une vue analytique des utilisations.

• Validez la diffusion de la campagne en comparant Carte:Notification envoyée avec les pics d'installation.

FAQ

Quand faut-il utiliser l'API Insights plutôt que les tableaux de bord Analytics ?

Utilisez Tableaux de bord Analytics pour obtenir une lecture visuelle rapide des performances du programme. Utilisez le API Insights lorsque des filtres personnalisés, des regroupements personnalisés, une ingestion BI ou des rapports automatisés sont nécessaires.

L'API Insights expose-t-elle les mêmes données que le tableau de bord ?

Oui. Les tableaux de bord Analytics sont construits sur les mêmes données d'événements. L'API offre davantage de flexibilité pour la forme des requêtes, la plage temporelle et l'utilisation en aval.

Du code est-il nécessaire pour accéder aux données d'événements Wallet ?

Non. La Rapport page prend en charge l'export CSV depuis le back-office. L'API Insights est utile lorsqu'un workflow programmable est nécessaire.