Analytics, connexion Facebook et abonnements - configuration

1Ce que cette carte connecte#

L'étape Intégrer contient une carte appelée Connexion, analytics et abonnements. Elle connecte VOS PROPRES comptes :

• Firebase Analytics : qui utilise l'application et ce qu'ils font
• Facebook Login : un bouton Continuer avec Facebook, plus Meta App Events
• RevenueCat : abonnements et achats

Chaque option est indépendante. Activez uniquement ce que vous utilisez ; une application avec toutes les options désactivées se compile exactement comme avant.

2Firebase Analytics : créer ou choisir un projet#

Ouvrez la console Firebase et touchez Create a project (ou choisissez le projet que votre application utilise déjà pour les notifications push). Gardez Google Analytics activé quand on vous le demande, puis choisissez ou créez un compte Analytics.

Vous avez déjà un projet sans Analytics ? Project settings → Integrations → Google Analytics → Enable.

Ouvrir la console Firebase →

3Firebase Analytics : ajouter votre application Android#

Dans le projet, touchez Add app → Android.

• Android package name : saisissez le nom de package EXACT de l'étape Basic de l'assistant, par exemple com.votrenom.monapp. Une seule lettre erronée et aucune donnée n'arrive.
• Le surnom est facultatif, et le SHA-1 n'est pas nécessaire pour les analytics.

Touchez Register app, puis Download google-services.json. Vous pouvez ignorer les autres étapes de Firebase ; AppMint ajoute le SDK pour vous.

Vous avez changé le nom du package plus tard ? Ajoutez le nouveau package comme une autre application Android et téléchargez à nouveau le fichier.

4Firebase Analytics : l'activer dans l'assistant#

Étape Intégrer → Connexion, analytics et abonnements → activez Firebase Analytics. Le champ d'import de google-services.json apparaît alors dans la carte Notifications push : importez-y le fichier. C'est le même fichier que celui des notifications push ; si vous l'avez déjà importé pour les notifications push, vous avez terminé.

Enregistrer une vue d'écran à chaque changement de page : lorsque cette option est activée, l'application enregistre un screen_view à chaque changement de route de votre page (liens, changements d'historique, retour et avance, changements de #), avec le chemin et le titre de la page. Vous voyez quels écrans les gens utilisent sans écrire de code. Laissez-la désactivée si votre page envoie ses propres appels screenView, sinon les écrans sont comptés en double.

5Envoyer vos propres événements#

AppMint.analytics.log(name, params) enregistre un événement. Les noms utilisent des lettres, des chiffres et _ (jusqu'à 40 caractères, en commençant par une lettre). La réponse indique ce qui a été envoyé, ou pourquoi non : no_consent, not_configured, invalid_name, reserved_name.

setUserId associe les événements à votre propre identifiant utilisateur (jamais une adresse e-mail), setUserProperty définit une propriété comme plan, et screenView enregistre vous-même un écran. Avec Meta App Events activé, log envoie aussi le même événement à Meta.

if (window.AppMint && AppMint.analytics) {
  AppMint.analytics.setUserId('u_42');
  AppMint.analytics.setUserProperty('plan', 'pro');
  const r = await AppMint.analytics.log('add_to_cart', { item_id: 'sku-42', value: 19.99, currency: 'USD' });
  if (!r.ok) console.warn('not logged', r.providers);
  AppMint.analytics.screenView('Checkout', 'CheckoutPage');
}

6Où les données apparaissent#

Console Firebase → Analytics. Realtime affiche les utilisateurs et les événements quelques minutes après l'ouverture de l'application. Les rapports Dashboard et Events se remplissent en environ 24 heures ; un rapport vide le premier jour est donc normal.

Pour voir chaque événement en direct pendant les tests, connectez le téléphone à un ordinateur et exécutez la commande ci-dessous, puis ouvrez l'application et allez dans Analytics → DebugView. Utilisez votre propre nom de package.

adb shell setprop debug.firebase.analytics.app com.yourname.myapp
# turn it off again:
adb shell setprop debug.firebase.analytics.app .none.

7Consentement et refus#

Dans une application qui affiche des publicités, c'est le formulaire de consentement de Google qui décide aussi pour les analytics : rien n'est collecté tant que l'utilisateur n'a pas répondu, et là où le RGPD s'applique, l'utilisateur doit accepter. D'ici là, les appels répondent no_consent et rien n'est mis en file d'attente.

Votre page peut toujours désactiver la collecte : AppMint.analytics.setEnabled(false) l'arrête et le choix est mémorisé, setEnabled(true) la réactive. Mentionnez les analytics dans votre politique de confidentialité et dans le formulaire Data safety de Play.

document.getElementById('optOut').onchange = (e) =>
  AppMint.analytics.setEnabled(!e.target.checked);

8Facebook Login : créer l'application Facebook#

Ouvrez Meta for Developers → My Apps → Create app. Choisissez le cas d'usage de connexion avec Facebook Login (ou ajoutez le produit Facebook Login à une application existante). Donnez-lui un nom et votre e-mail de contact.

Ouvrir Meta for Developers →

9Facebook Login : ajouter l'URL de redirection#

Facebook Login → Settings → Valid OAuth Redirect URIs : ajoutez
https://freewebtoapk.com/fb-return/
exactement, avec la barre oblique finale. L'assistant dispose d'un bouton Copy redirect URL pour ne pas avoir à la saisir. Gardez Client OAuth login et Web OAuth login activés, puis Save changes.

Aucun hash de clé ni configuration de plateforme Android n'est nécessaire : la connexion s'ouvre dans un onglet de navigateur puis revient à votre application.

10Facebook Login : App ID et Client Token#

App settings → Basic affiche l'App ID. App settings → Advanced → Security affiche le Client token. Collez les deux dans les champs Facebook Login de l'assistant.

Tant que l'application Facebook est en mode Development, seules les personnes ayant un rôle dessus (vous et vos testeurs) peuvent se connecter. Avant de publier, ajoutez l'URL d'une politique de confidentialité et une icône dans App settings → Basic, puis passez l'application en mode Live.

11Facebook Login : connecter les utilisateurs#

AppMint.facebook.login(permissions) ouvre Facebook et renvoie le jeton, ou ok: false et cancelled si l'utilisateur annule. Envoyez le jeton à votre serveur et vérifiez-le là-bas. getAccessToken() renvoie le jeton enregistré au démarrage de la page ; logout() déconnecte.

Activez Meta App Events pour envoyer les installations, les ouvertures de l'application et vos propres événements à Meta Events Manager. AppMint.facebook.logEvent(name, valueToSum, params) envoie uniquement à Meta ; il suit la même règle de consentement que les analytics.

const r = await AppMint.facebook.login(['public_profile', 'email']);
if (r.ok) {
  await fetch('/api/login/facebook', { method: 'POST', body: JSON.stringify({ token: r.accessToken }) });
} else if (!r.cancelled) {
  alert('Facebook sign-in failed: ' + (r.message || r.error));
}
AppMint.facebook.logEvent('fb_mobile_purchase', 9.99, { fb_currency: 'USD' });

12RevenueCat : créer le projet et connecter Google Play#

Dans RevenueCat, créez un projet et ajoutez une application pour le Google Play Store. Saisissez le nom de package EXACT de l'étape Basic.

RevenueCat vérifie les achats auprès de Google via un compte de service : suivez le guide de RevenueCat pour le créer dans Google Cloud, invitez-le dans la Play Console avec les autorisations financières indiquées, et importez ses identifiants JSON dans l'application RevenueCat. Google peut mettre un jour ou plus avant que les nouveaux identifiants fonctionnent.

Ouvrir RevenueCat →

13RevenueCat : produits, droit d'accès et offre#

1. Dans la Play Console, créez vos abonnements ou produits intégrés (l'application doit d'abord être importée sur une piste de test).
2. Dans RevenueCat → Product catalog, ajoutez les mêmes identifiants de produit.
3. Créez un Entitlement, par exemple pro, et rattachez-y les produits qui le débloquent.
4. Créez une Offering (celle par défaut est affichée comme courante) avec des packages tels que Monthly et Annual qui pointent vers ces produits.

Votre page lit l'offre courante pour afficher le paywall, et vérifie le droit d'accès pour débloquer des fonctions.

14RevenueCat : la clé Google publique#

RevenueCat → Project settings → API keys : copiez la clé PUBLIQUE de votre application Google Play. Elle commence par goog_. Collez-la dans le champ RevenueCat de l'assistant.

N'utilisez jamais une clé secrète (sk_...). Tout ce qui se trouve dans une application peut être lu par quiconque la télécharge, et une clé secrète donne le contrôle total de votre compte RevenueCat.

15RevenueCat : offres, achats et droits d'accès#

configure() démarre RevenueCat (passez votre propre identifiant utilisateur, ou rien pour un utilisateur anonyme). getOfferings() renvoie le paywall, purchase(package) lance l'achat Google Play et getCustomerInfo() indique ce que possède l'utilisateur. restore() restaure les achats précédents. Testez avec un compte de testeur de licences et une installation depuis une piste de test Play.

if (window.AppMint && AppMint.revenuecat) {
  await AppMint.revenuecat.configure({ appUserId: 'u_42' });
  const off = await AppMint.revenuecat.getOfferings();
  if (off.ok && off.current) {
    const pkg = off.current.availablePackages[0];
    const r = await AppMint.revenuecat.purchase(pkg);
    if (r.ok) unlock();
  }
  const info = await AppMint.revenuecat.getCustomerInfo();
  const isPro = info.ok && !!info.customerInfo.entitlements.active.pro;
}