EcommiOS

Intégration en utilisant le SDK iOS

remarque

Ce guide suppose que vous êtes familier avec CocoaPod 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 CocoaPod 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'

2. Installez le pod :

pod install

Guide Swift Package Manager

Dans Xcode :

• Allez dans File > Swift Packages > Add Package Dependency
• Ajoutez https://github.com/ROKT/rokt-sdk-ios.git
• Sélectionnez Up to Next Major avec 3.11.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: "3.11.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 lors de l'installation et recevez une erreur indiquant que la SWIFT_VERSION n'est pas définie, veuillez ajouter une variable définie par l'utilisateur SWIFT_VERSION. Cette variable doit être définie sur "5" pour les versions de l'iOS SDK 2.0 et supérieures. Cette variable doit être définie sur "4.2" pour la version 1.2.1 de l'iOS SDK.

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'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 pour les campagnes. Le SDK Rokt pour iOS est déployé en utilisant CocoaPod.

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 en utilisant CocoaPod/Swift Package Manager
2. Ajouter le Rokt-Widget
3. Installer le pod/paquet
4. 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 s'adapter au cas d'utilisation requis.

ID de compte Rokt de test : 222

Swift

//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 voir votre intégration, remplacez l'ID de tag de test d'intégration (222) par votre ID de tag Rokt unique
	Rokt.initWith(roktTagId: "222")
	return true
}

Objective-C

//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;
}