Purchasely
Créer une clé Management API en lecture seule, la brancher dans Persyst avec sa date d’expiration et choisir les applications.
La connexion utilise une clé Management API d’équipe Purchasely. Purchasely ne propose pas d’OAuth : la clé se branche au niveau de l’organisation, sans connexion personnelle. Persyst interroge Purchasely à chaque question, sans stocker ses données hors un cache de quelques minutes ; il ne crée, ne modifie, ne publie ni ne supprime rien chez Purchasely.
Créer la clé dans la console Purchasely
- Ouvrez le menu du compte (votre avatar, en bas à gauche), puis Management API keys, et créez une clé nommée par exemple
Persyst. Il faut la permission API keys · Manage ; la clé n’est affichée qu’une fois. - Cochez uniquement des scopes de consultation, qui se terminent par
:view.setup.apps:viewest obligatoire : Persyst vérifie la clé avec. Ajoutez le scope:viewde chaque famille d’outils à ouvrir : référentiel (écrans, flows, placements, audiences, campagnes, A/B tests, produits, plans, sondages, événements personnalisés), tableaux de bord, campagnes, A/B tests, sondages, et utilisateurs, abonnements et achats uniques pour les outils de données personnelles. - Notez la date d’expiration choisie (90 jours par défaut), puis transmettez la clé par un canal sûr.
Vérifiez le nom exact de chaque scope dans la console ou dans la référence de la Management API. Quand un droit manque, le message de l’outil nomme celui à ajouter.
Brancher la clé et choisir les applications
- Dans Sources de données → Ajouter une source, choisissez le périmètre, puis Purchasely.
- Renseignez un nom, collez la clé, indiquez sa date d’expiration (préremplie à 90 jours), puis cliquez sur Connecter. Persyst vérifie la clé auprès de Purchasely avant de l’enregistrer.
- Dans Applications, cochez celles qui sont ouvertes dans Persyst. Une application non choisie reste invisible pour les assistants.
- Dans Gestion des accès, ouvrez chaque application aux équipes, clients ou membres concernés, avec les outils utiles.
Les outils find_purchasely_user et list_purchasely_purchases exposent des données personnelles : ils sont désactivés par défaut et s’activent explicitement, après confirmation, dans les outils de la connexion.
Vérifier une lecture
Un membre autorisé peut demander : « Quelle est la conversion de nos paywalls par placement sur le mois dernier ? »
Les chiffres « toutes applications » ne portent que sur les applications ouvertes au membre, lues une par une, jamais additionnées. Purchasely limite le nombre d’appels par clé : un outil indique alors combien de temps attendre, ou demande de réduire une période trop lourde.
Remplacer ou retirer la clé
14 jours avant l’expiration, la source affiche « Clé bientôt expirée » ; dès que Purchasely refuse la clé, elle passe en « Clé expirée ou révoquée ». Créez une nouvelle clé, puis cliquez sur Remplacer la clé dans l’onglet de la connexion : applications et accès sont conservés. Chez Purchasely, la rotation coupe l’ancienne clé immédiatement : collez la nouvelle sans délai.
Supprimer la connexion efface sa clé dans Persyst. Révoquez-la aussi dans la console Purchasely.