Initialiser le SDK iOS
Avant de commencer
Ce guide suppose que vous êtes familier avec CocoaPods ou Swift Package Manager et que vous savez comment installer des dépendances pour le développement iOS. Pour plus d'informations, consultez les guides utilisateurs de CocoaPods' ou Swift Package Manager's.
Guide CocoaPods
Configurez un espace de travail en utilisant ce tutoriel CocoaPods.
- Ajoutez le pod
Rokt-Widget
au fichier pod :
pod 'Rokt-Widget'
- Installez le pod :
pod install
Si vous recevez l'erreur DT_TOOLCHAIN_DIR cannot be used to evaluate LIBRARY_SEARCH_PATHS use TOOLCHAIN_DIR instead
, ajoutez le hook post-install suivant à votre Podfile :
post_install do |installer|
installer.pods_project.targets.each do |target|
target.build_configurations.each do |config|
xcconfig_path = config.base_configuration_reference.real_path
xcconfig = File.read(xcconfig_path)
xcconfig_mod = xcconfig.gsub(/DT_TOOLCHAIN_DIR/, "TOOLCHAIN_DIR")
File.open(xcconfig_path, "w") { |file| file << xcconfig_mod }
end
end
end
Guide du gestionnaire de packages Swift
Dans Xcode :
- Allez dans Fichier > Ajouter des dépendances de package
- Ajoutez
https://github.com/ROKT/rokt-sdk-ios.git
- Sélectionnez Jusqu'à la prochaine version majeure avec 4.7.0
ou ajoutez le code ci-dessous à la partie dependencies
de Package.swift
.
dependencies: [
.package(url: "https://github.com/ROKT/rokt-sdk-ios.git", .upToNextMajor(from: "4.7.0"))
]
Remarque sur l'intégration Objective-C : Le SDK Rokt pour iOS est implémenté en utilisant Swift. Si vous utilisez Objective-C, vous devez importer le fichier d'en-tête de liaison du framework dans le fichier
.h/.m
.
#import <Rokt_Widget/Rokt_Widget-Swift.h>
Si vous rencontrez des difficultés pour installer et recevez une erreur indiquant que la SWIFT_VERSION n'est pas définie, ajoutez une variable définie par l'utilisateur SWIFT_VERSION
. Cette variable doit être définie sur "5" pour les versions 2.0 et supérieures du SDK iOS. Cette variable doit être définie sur "4.2" pour la version 1.2.1 du SDK iOS.
Initialiser le SDK Rokt pour iOS
Initialisez le SDK Rokt pour iOS avant de l'utiliser dans tout ViewController
. Nous recommandons d'appeler la méthode init
depuis le gestionnaire applicationDidFinishLaunching
.
Contactez Rokt pour obtenir l'ID de compte Rokt associé à votre compte. Afin de tester votre intégration, vous pouvez utiliser l'ID de compte Rokt ci-dessous, mais celui-ci doit être remplacé par votre ID de compte Rokt unique avant de lancer en production.
Initialiser le SDK
Le SDK Rokt pour les applications iOS peut être utilisé par les partenaires Rokt pour afficher des placements en superposition ou intégrés, ou par les annonceurs Rokt pour enregistrer des conversions de campagnes. Le SDK Rokt pour iOS est déployé à l'aide de CocoaPods.
Tous les cas d'utilisation du SDK suivront les mêmes étapes initiales pour intégrer et initialiser le SDK dans votre application. En termes généraux, ces étapes sont :
- Configurer un espace de travail en utilisant CocoaPod/Swift Package Manager
- Ajouter le
Rokt-Widget
- Installer le pod/package
- Initialiser le SDK Rokt
Après avoir suivi ces étapes, la méthode execute
du SDK peut ensuite être utilisée de différentes manières pour correspondre au cas d'utilisation requis.
ID de compte Rokt de test : 222
- Swift
- Objective-C
//file => AppDelegate.swift
import Rokt_Widget
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
// Ce qui suit révélera une intégration démo. Pour voir votre intégration, remplacez l'ID d'étiquette de test d'intégration (222) par votre ID de tag Rokt unique
Rokt.initWith(roktTagId: "222")
return true
}
//file => AppDelegate.m
#import <Rokt_Widget/Rokt_Widget-Swift.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Point de personnalisation après le lancement de l'application.
[Rokt initWithRoktTagId:@"222"];
return YES;
}
Recevoir le statut de l'initialisation
À partir de la version 4.6.0
, le SDK Rokt fournit 2 moyens de recevoir le statut de l'initialisation :
Callback (optionnel) lors de l'initialisation
Il y a un callback dans la méthode Rokt.initWith
pour notifier lorsque l'initialisation est terminée et retourner le statut.
Rokt.initWith(roktTagId: "222") { status in
print("Rokt init completed with status: \(status)")
}
API des événements globaux
Le SDK fournit également le statut via l'API Rokt.globalEvents
.
Rokt.globalEvents() { roktEvent in
if let initEvent = roktEvent as? RoktEvent.InitComplete {
print("Rokt init completed with status: \(initEvent.success)")
}
}
Débogage
Utilisez l'API Rokt.setLoggingEnabled(enable: true)
pour activer les journaux de débogage du SDK Rokt.
Prochaines étapes
Vos prochaines étapes dépendent du cas d'utilisation de votre intégration. Consultez ces ressources pour plus d'informations :