Connecter RevenueCat à AdMate

Une connexion RevenueCat offre à AdMate une vue centrée sur les abonnements, à côté des rapports publicitaires et des stores. Elle peut faire apparaître les projets, transactions et métriques exposés par RevenueCat sans transformer l’API d’AdMate en entrepôt de revenus côté serveur.

Les identifiants RevenueCat sont puissants. Préparez la connexion avec soin, utilisez le mode d’autorisation proposé par votre version actuelle d’AdMate et ne collez jamais une clé secrète dans un ticket public ou une capture d’écran.

AdMate

Tous vos revenus dans un seul tableau de bord

Suivez AdMob, AdSense, RevenueCat et App Store Connect sur plusieurs comptes avec des filtres par app, plateforme et pays

Surveillez les revenus, clics, eCPM, abonnements, installations et paiements sur iPhone, iPad, Mac et Apple Watch

Choisir le bon accès RevenueCat

AdMate prend en charge la configuration de comptes RevenueCat et plusieurs projets. Selon le compte et la version actuels, l’écran des identifiants peut utiliser l’autorisation API v2 prise en charge, y compris les clés secrètes de projet, et peut proposer un flux d’autorisation au niveau du compte.

Utilisez l’identifiant le moins privilégié capable de lire les données dont vous avez besoin. Une clé SDK publique destinée à être intégrée dans une application ne remplace pas automatiquement un identifiant API secret, et l’identifiant d’un projet ne permet pas forcément de lister tous les projets d’une organisation.

Avant la configuration :

identifiez l’organisation RevenueCat et les projets dont vous avez besoin ;
déterminez si vous ajoutez la clé d’un seul projet ou une connexion au niveau du compte ;
supprimez les anciennes clés devenues inutiles ;
choisissez un alias clair pour le compte dans AdMate.

Ajouter le compte RevenueCat

Ouvrez Réglages puis la gestion des comptes dans AdMate.
Trouvez RevenueCat et choisissez d’ajouter un compte.
Sélectionnez la méthode d’autorisation affichée par l’application actuelle.
Saisissez ou autorisez l’identifiant demandé sans modifier ses caractères.
Laissez AdMate valider le compte et récupérer les projets accessibles.
Donnez à la connexion un nom reconnaissable lorsque plusieurs organisations ou clients sont concernés.
Ouvrez le résumé RevenueCat et vérifiez le projet et la période souhaités.

Si vous utilisez plusieurs clés secrètes de projet, associez chacune au bon projet. N’appelez pas toutes les entrées simplement « RevenueCat » : un alias descriptif évite de comparer par erreur les données de clients différents.

Ce qu’il faut vérifier après la connexion

Commencez par l’identité avant les totaux :

le nom du compte ou de l’organisation ;
le nom et l’identifiant du projet ;
les applications et stores inclus ;
la période et la devise sélectionnées ;
si les remboursements ou les ajustements à la baisse sont inclus dans la métrique affichée.

Comparez ensuite une période clôturée avec le tableau de bord RevenueCat. De petites différences peuvent venir du moment de l’actualisation, des règles de devise ou des définitions des métriques. Un projet totalement absent indique généralement un problème de portée de l’identifiant ou d’association de projet plutôt qu’une erreur de calcul.

L’accès au tableau de bord et les webhooks sont distincts

AdMate utilise RevenueCat de deux manières différentes :

l’application Apple interroge les projets configurés par l’utilisateur pour alimenter le tableau de bord ;
l’API d’AdMate peut recevoir les webhooks RevenueCat pour les notifications.

Configurer un identifiant pour le tableau de bord ne configure pas automatiquement un webhook, et créer un webhook n’autorise pas l’application à lister les métriques d’un projet. Traitez-les comme deux tâches distinctes, avec des identifiants et des objectifs distincts.

L’API conserve un contexte temporaire d’appareil et de projet afin qu’une notification puisse afficher des noms et une devise utiles. Ce contexte n’est pas une copie côté serveur de l’historique complet des revenus de l’utilisateur ni de son jeton d’accès.

Résoudre l’absence d’un projet

L’identifiant est validé mais un seul projet apparaît

Vérifiez si l’identifiant appartient spécifiquement à ce projet. Ajoutez ou associez les clés nécessaires, ou utilisez la méthode prise en charge au niveau du compte si elle convient.

Aucune métrique n’apparaît pour un projet valide

Sélectionnez une période terminée contenant des transactions connues, vérifiez les filtres de projet et de store, puis actualisez dans l’application principale. Un projet nouveau ou inactif peut légitimement renvoyer zéro.

L’autorisation échoue soudainement

La clé a peut-être été révoquée, renouvelée ou copiée avec des espaces. Vérifiez son état dans RevenueCat, puis remplacez-la dans AdMate. Ne conservez pas une clé révoquée en solution de secours.

Le nom du projet est correct mais le total semble faux

Vérifiez la définition de la métrique, les remboursements, la devise et les bornes de dates. Ne comparez pas directement les revenus RevenueCat avec les produits d’App Store Connect tant que leurs périmètres ne sont pas alignés.

Protéger l’identifiant

n’incluez jamais la clé dans des analyses, des journaux ou une capture de diagnostic ;
ne réutilisez pas une clé de projet en dehors de l’organisation prévue ;
renouvelez-la si elle a été exposée ;
supprimez le compte AdMate des appareils qui ne doivent plus lire le projet ;
revoyez régulièrement les accès lorsqu’une relation avec un prestataire ou un client prend fin.

Poursuivez avec pourquoi les totaux des fournisseurs diffèrent avant de publier un chiffre de revenus combiné.

Questions fréquentes

AdMate peut-il connecter plusieurs projets RevenueCat ?

Oui. Le modèle de compte prend en charge plusieurs projets et identifiants de projet. Nommez et vérifiez chaque projet avant de combiner les vues.

Une clé SDK publique RevenueCat suffit-elle ?

Utilisez le type d’identifiant demandé par la configuration RevenueCat d’AdMate. Les clés SDK publiques des applications et les identifiants API secrets ont des usages différents.

AdMate envoie-t-il tous les revenus d’abonnement à son API ?

Non. L’application interroge directement les services configurés. Le contexte RevenueCat de l’API sert aux notifications par webhook et n’est pas un entrepôt de revenus.

Que dois-je envoyer au support ?

Envoyez le nom du projet, la période, la métrique et l’erreur anonymisée. N’envoyez jamais la clé secrète.