Développeurs : vue d'ensemble et clés
Comment FirstMRR reçoit tes données : le script et les apps avec une clé publique, ton serveur avec une clé secrète.
Deux clés
| Clé | Rôle | Description |
|---|---|---|
pk_… | Clé publique | Identifie ton site ou ton app dans le script et les apps. Elle est visible dans ton code : ce n'est pas un secret, elle ne permet que d'envoyer des événements de mesure, filtrés par domaine pour un site. |
sk_live_… | Clé secrète | Pour ton serveur seulement (API des événements serveur). Montrée une seule fois à sa création, gardée chez nous sous forme d'empreinte. 5 clés actives au plus, chacune liée à ton site ou à ton app. |
Les deux se trouvent dans Distribution → Tracking, section « Pour les développeurs ». Crée une clé par environnement ou par service, donne-lui un nom, et révoque-la dès qu'elle ne sert plus ou a pu fuiter : elle est refusée dès la requête suivante.
Trois façons d'envoyer des données
- Le script sur ton site : visites, provenance, conversions déclarées dans le navigateur. Voir Référence du script JavaScript.
- Ton app mobile : un petit module qui envoie les ouvertures et les conversions. Voir Apps mobiles.
- Ton serveur : les conversions que seul ton backend connaît (paiement confirmé par un webhook, résiliation). Voir API des événements serveur.
Et, pour relier un client payant à sa vidéo, la provenance que ton produit écrit sur le paiement : voir Provenance des paiements.
Adresses
| URL | Méthode | Description |
|---|---|---|
https://firstmrr.app/api/v1/events | POST | Événements serveur, authentifiés par une clé secrète. |
https://firstmrr.app/app/api/collect | POST | Événements du script et des apps, identifiés par la clé publique. |
https://firstmrr.app/app/t.js | GET | Le script de mesure. |
https://firstmrr.app/go/<slug> | GET | La redirection des liens suivis. |