Le SDK iOS de Poool Access permet d’intégrer des paywalls dynamiques pour contrôler l’accès aux contenus d’une application. Il offre plusieurs modes d’affichage (modale, intégré, vue personnalisée) et se personnalise facilement via des styles et textes modifiables. Les templates de paywall et le parcours utilisateur sont entièrement éditables depuis le dashboard Poool, sans nécessiter de mise à jour de l’application.
Installation du SDK Poool Access iOS
Poool Access peut être installé de différentes manières en fonction de votre gestionnaire de dépendances.
Installation via Swift Package Manager (SPM)
Ouvrez Xcode et accédez à File > Add Packages....
Ajoutez le dépôt suivant :
https://github.com/p3ol/access-package-ios.Sélectionnez la version souhaitée et ajoutez le package à votre projet.
Dans vos fichiers Swift, importez le framework :
import AccessIOS
Installation via CocoaPods
Ajoutez la dépendance suivante dans votre Podfile :
pod 'AccessIOS'
Puis exécutez pod install.
Initialisation et configuration de Poool Access
Avant d’afficher un paywall, vous devez initialiser l’instance de Poool Access avec votre APP_ID.
import AccessIOS var access = Access(key: "VOTRE_APP_ID_POOOL")
Ensuite, vous pouvez configurer plusieurs options pour adapter l’expérience utilisateur à vos besoins.
Configuration des paramètres globaux
access.config([
"subscription_url": "https://monsite.com/offres",
"login_url": "monappli://login",
"subscription_button_enabled": true,
"login_button_enabled": true,
"alternative_enabled": true,
"cookies_enabled": false,
"paywall_load_timeout": 10000 ],
readOnly: false
)
Ces paramètres permettent de personnaliser l’affichage et le comportement du paywall, notamment l’intégration de liens d’abonnement et de connexion, ou encore la gestion du consentement utilisateur.
Gestion de l’affichage des paywalls
Mode modale
Le mode par défaut du paywall est un affichage en modale.
access.createPaywall(pageType: "premium")
Mode intégré dans une vue existante
Si vous souhaitez afficher le paywall directement au sein de votre interface, vous pouvez l’intégrer dans une vue spécifique.
access.createPaywall(pageType: "premium", view: targetView, percent: 80)
Le paramètre percent indique le pourcentage de la vue targetView qui sera recouvert par le paywall.
Mode vue personnalisée
Il est également possible d’insérer le paywall sous forme d’une UIView manuelle pour un contrôle plus précis de son positionnement.
var paywallView: UIView? = access.createPaywall(pageType: "premium")
Cette approche permet une gestion plus fine du rendu et de l’affichage du paywall.
Personnalisation des textes et styles
Personnalisation des textes
Vous pouvez modifier les libellés affichés dans le paywall pour qu’ils correspondent à votre charte éditoriale.
access.texts([
"no_thanks": "Non, merci !",
"thanks": "Votre article est maintenant débloqué !"
],
readOnly: false
)
Personnalisation des styles
Pour harmoniser l’apparence du paywall avec votre marque, vous pouvez modifier les couleurs et ajouter un logo.
access.styles([
"brand_logo": "https://monsite.com/mon_logo.png",
"button_color": "#FF5733",
"button_hover_color": "#C70039",
"skin_color": "#4A90E2",
"premium_color": "#FF5733"
],
readOnly: false
)
Gestion des événements du paywall
Poool Access émet des événements qui permettent d’interagir avec le parcours utilisateur.
Détection du déblocage du contenu
access.onRelease { widgetEvent in
print("Content unlocked with widget \(widgetEvent.widget) named \(widgetEvent.actionName)")
}Cet événement est déclenché lorsque l’utilisateur a terminé le parcours du paywall et a obtenu l’accès au contenu.
Gestion des inscriptions et abonnements
access.onRegister { event in
print("User \(registerEvent.email) has registered to newsletter \(registerEvent.newsletterId)")
}
access.onSubscribeTapped { event in
print("User tapped on subscribe button \(clickEvent.button) in widget \(clickEvent.widget)")
}Ces événements permettent d’intercepter les actions d’inscription ou d’abonnement et d’y associer des traitements spécifiques.
Intégration SwiftUI
Si votre application utilise SwiftUI, vous pouvez directement intégrer le paywall à vos vues SwiftUI.
import AccessIOS
struct ArticleView: View {
var access = Access
init(){
var access = Access(key: "VOTRE_APP_ID_POOOL")
}
var body: some View {
Text("first paragraph)
Text("first paragraph)
.createPaywall(access: access, pageType: "premium", percent: 80)
}
}
Il est également possible de générer une vue indépendante du paywall en SwiftUI.
import AccessIOS
struct ArticleView: View {
var access = Access
init(){
var access = Access(key: "VOTRE_APP_ID_POOOL")
}
var body: some View {
Text("first paragraph)
Text("first paragraph)
access.createPaywall(pageType: "premium")
}
}
En espérant que ce guide vous aura été utile et vous permettra d’intégrer Poool Access de manière optimale, n’hésitez pas à contacter notre équipe via Intercom sur le dashboard Poool ou par email à notre support pour toute question ou assistance supplémentaire. Nous serons ravis de vous aider à optimiser votre intégration et à répondre à vos besoins.