Skip to main content
Le SDK demande l’autorisation, enregistre l’appareil, affiche les notifications app ouverte, remonte ouvertures et clics, et renouvelle le jeton. L’application n’embarque aucun fichier de configuration : ni google-services.json, ni GoogleService-Info.plist. Tout se règle dans le dashboard et le SDK le lit au démarrage.

Avant de commencer

  1. Un development build : Expo Go n’embarque pas le module natif du SDK.
  2. L’application configurée dans le dashboard, dans le bon environnement (compte de service Firebase pour Android, clé APNs .p8 pour iOS). Voir Notifications push.
  3. Une clé SDK (portée sdk:device), préréglage « Clé SDK », et l’identifiant de l’application.
  4. iOS : un appareil physique — le simulateur ne reçoit pas de push distant.

Installation

Le paquet est publié sur GitHub Packages. Créez un jeton GitHub classique avec la seule portée read:packages, puis dans le .npmrc de l’application :
Puis le plugin Expo :
app.config.js
Un nouveau build natif est nécessaire après l’ajout du paquet.

Initialiser

initialize demande l’autorisation (requestPermission: false pour la demander plus tard). Aucune méthode ne rejette : les échecs passent par onError.

Utilisateurs

Avant login, l’utilisateur est anonyme : il reçoit les envois à tous les abonnés et peut porter des tags. login d’un External ID inconnu le promeut en gardant ses tags ; logout confie l’appareil à un nouvel anonyme.

Notifications

Le lien profond est ouvert automatiquement (openDeepLinks: false pour s’en charger).

Événements et conversions

Consentement

Tant que le consentement exigé manque, rien ne quitte l’appareil.

Messages in-app

Montez l’hôte une fois, à la racine de l’app :
Les messages HTML demandent react-native-webview (npx expo install react-native-webview).

Live Activities (iOS)

Avec liveActivities: true dans les options du plugin, et une cible widget qui dessine l’activité. Les mises à jour se pilotent ensuite par l’API.

En cas d’échec

La clé embarquée

Une clé dans une application mobile est extractible. Émettez-la avec la seule portée sdk:device : chaque route qu’elle ouvre exige le jeton de l’appareil, et elle ne peut ni lire l’audience ni réécrire un profil.