Interrogez vos données — 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 tableau de bord des statistiques affiche visuellement les données du portefeuille. 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 de BI, lancer des analyses ad hoc ou automatiser le reporting.

Aucun code n’est requis pour exporter les données. Le Rapport la page permet aux équipes d’exporter les données d’événements en 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érations suit les scans par magasin et surveille les tendances de désinstallation par programme.
• Une équipe BI importe les événements du portefeuille dans Tableau, Looker ou Power BI pour des rapports hebdomadaires.

Qu’est-ce que l’API Insights ?

L’API Insights est une interface de requête pour les événements du portefeuille stockés sur la plateforme The Wallet Crew. Chaque événement suivi peut être interrogé, y compris les créations de Carte, 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:Created	Quand un enregistrement de Carte a été créé	Combien de cartes ont été émises ce mois-ci par magasin ?
Carte:Installed	Lorsqu’un Carte a été ajouté à Apple Wallet ou Google Wallet, avec des données sources telles que Medium, Tag, URL, et Host	Quelle campagne e-mail a généré le plus d’installations la semaine dernière ?
Carte:Uninstalled	Lorsqu’une Carte a été entièrement supprimée de tous les portefeuilles	Quel est le taux de désinstallation par programme ?
Carte:Updated	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:UpdateSent	Lorsqu’une mise à jour push a été envoyée à un appareil	Les mises à jour atteignent-elles les appareils de manière fiable ?
Carte:Scanned	Lorsqu’un code-barres de Carte a été scanné	Combien de scans par jour ont eu lieu dans chaque emplacement ?
Carte:NotificationSent	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 Host.

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.

Son lien avec le tableau de bord des statistiques

Le Statistiques le tableau de bord est construit sur l’API Insights. Tout ce qui est visible dans le tableau de bord peut aussi être interrogé directement via l’API, avec davantage de flexibilité sur les regroupements, les filtres et les plages de dates.

Pour une vue sans code des mêmes données, utilisez la tableau de bord des statistiques. Pour envoyer des événements vers des outils externes en temps réel, consultez Envoyer les événements du portefeuille vers vos outils.

Prise en main

La façon la plus rapide est de s’authentifier, d’examiner les endpoints disponibles et d’exécuter une première requête d’agrégation.

1

1. Authentifiez-vous

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

X-API-KEY: <API_KEY>

2

2. Explorez les endpoints disponibles

Utilisez la référence de l’API Insights pour examiner les endpoints, les paramètres et les structures de réponse.

3

3. Commencez par une requête simple

Commencez par un décompte des Carte:Installed é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 au portefeuille pendant la période.

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

Cas d’usage 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 comptes d’installations et de désinstallations.
• Automatisez un rapport hebdomadaire des performances du programme par magasin ou région.
• Construisez un entonnoir d’activation personnalisé en corrélant Carte:Created avec Carte:Installed.
• Interrogez les événements de scan pour construire une vue analytique des redemptions.
• Validez la diffusion de la campagne en comparant Carte:NotificationSent avec les pics d’installation.

FAQ

Quand faut-il utiliser l’API Insights plutôt que Statistiques ?

Utilisez Statistiques pour une lecture visuelle rapide des performances du programme. Utilisez la API Insights lorsque des filtres personnalisés, des regroupements personnalisés, l’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. Le tableau de bord des statistiques est construit sur les mêmes données d’événements. L’API apporte 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 du 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.