Aller au contenu principal

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 de l'utilisateur de CocoaPods' ou de Swift Package Manager.

Guide CocoaPods​

Configurez un espace de travail en utilisant ce tutoriel CocoaPods.

  1. Ajoutez le pod Rokt-Widget au fichier pod :
pod 'Rokt-Widget'
  1. Installez le pod :
pod install
remarque

Si vous recevez l'erreur DT_TOOLCHAIN_DIR cannot be used to evaluate LIBRARY_SEARCH_PATHS use TOOLCHAIN_DIR instead, ajoutez le hook de post-installation 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 Swift Package Manager​

Dans Xcode :

  • Allez à 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.6.1

ou ajoutez le code ci-dessous à la partie dépendances de Package.swift.

dépendances: [
    .package(url: "https://github.com/ROKT/rokt-sdk-ios.git", .upToNextMajor(from: "4.6.1"))
]

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 pont depuis le framework dans le fichier .h/.m.

#import <Rokt_Widget/Rokt_Widget-Swift.h>

Si vous rencontrez des difficultés lors de l'installation et que vous recevez une erreur disant que le SWIFT_VERSION n'est pas défini, veuillez ajouter une variable définie par l'utilisateur SWIFT_VERSION. Cette variable doit être définie sur "5" pour les versions du SDK iOS 2.0 et supérieures. Cette variable doit être définie sur "4.2" pour la version du SDK iOS 1.2.1.

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.

attention

Contactez Rokt pour obtenir l'identifiant de compte Rokt associé à votre compte. Afin de tester votre intégration, vous pouvez utiliser l'identifiant de compte Rokt ci-dessous, mais cela doit être remplacé par votre identifiant de compte Rokt unique avant votre lancement en production.

Initialiser le SDK​

Le SDK Rokt pour les applications iOS peut être utilisé par les partenaires Rokt pour afficher des emplacements superposés ou intégrés, ou par les annonceurs Rokt pour enregistrer des conversions pour des 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. À un niveau élevé, ces étapes sont :

  1. Configurer un espace de travail à l'aide de CocoaPod/Swift Package Manager
  2. Ajouter le Rokt-Widget
  3. Installer le pod/package
  4. Initialiser le SDK Rokt

Après avoir suivi ces étapes, la méthode execute du SDK peut ensuite être utilisée de diverses manières pour s'adapter au cas d'utilisation requis.

Identifiant de compte Rokt de test : 222

//file => AppDelegate.swift

import Rokt_Widget

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
// Ce qui suit révélera une intégration de démonstration. Pour visualiser votre intégration, remplacez l'identifiant de balise de test d'intégration (222) par votre identifiant de balise Rokt unique
    Rokt.initWith(roktTagId: "222")
    return true
}

Réception du statut d'initialisation​

Depuis la version 4.6.0, le SDK Rokt fournit 2 façons de recevoir le statut de l'initialisation :

Rappel optionnel lors de l'initialisation​

Il y a un rappel 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.

Étapes suivantes​

Vos prochaines étapes dépendent du cas d'utilisation de votre intégration. Consultez ces ressources pour plus d'informations :

Cet article vous a-t-il été utile ?