Last updated 24 oct. 2023

Initialiser le SDK React Native

Les partenaires Rokt peuvent utiliser le SDK Rokt pour les applications React Native afin d'afficher des superpositions ou des emplacements intégrés, tandis que les annonceurs Rokt peuvent l'utiliser pour enregistrer des conversions pour leurs campagnes. Tous les cas d'utilisation du SDK suivent les mêmes étapes initiales pour intégrer et initialiser le SDK dans votre application. En gros, ces étapes sont les suivantes :

1. Intégrer le SDK dans votre application React Native
2. Configuration pour les applications Android
3. Configuration pour les applications iOS
4. Initialiser le SDK

En suivant ces étapes, la méthode execute du SDK peut ensuite être utilisée de différentes manières pour répondre au cas d'utilisation requis.

Intégrer le SDK dans votre application React Native

Pour intégrer le SDK dans votre application React Native, vous devez :

1. Installer le SDK Rokt en exécutant la commande suivante :

   $ npm install @rokt/react-native-sdk --save

2. Installer tous les packages et dépendances en exécutant la commande suivante :

   $ npm install

Configuration pour Android

Pour configurer le SDK Rokt React Native pour les applications Android, vous devez :

1. Ajouter le SDK Rokt dans le bloc des dépôts de build.gradle :

allprojects {
    repositories {
        ...
        maven {
            url  "https://rokt-eng-us-west-2-mobile-sdk-artefacts.s3.amazonaws.com"
        }
    }
}

2. Dans votre classe ReactApplication, ajoutez le RoktEmbeddedViewPackage à getPackages :

// importez la classe
import com.reactlibrary.RoktEmbeddedViewPackage;

@Override
protected List<ReactPackage> getPackages() {
@SuppressWarnings("UnnecessaryLocalVariable")
    List<ReactPackage> packages = new PackageList(this).getPackages();

    // Ajoutez le RoktEmbeddedViewPackage
    packages.add(new RoktEmbeddedViewPackage());
    return packages;
}  

3. Vérifiez que multiDexEnabled est défini sur true et que vous ciblez la version Mind SDK 18 ou supérieure :

android {
    ...
    defaultConfig {
        ...
        multiDexEnabled true,
        minSdkVersion 18
    }
}

remarque

Si la construction échoue en raison d'un conflit de version de Kotlin, consultez le lien pour des solutions possibles : https://github.com/facebook/react-native/issues/35979

Configuration pour iOS

Pour configurer le SDK Rokt React Native pour les applications iOS, accédez au dossier iOS et exécutez la commande suivante :

cd ios && pod install

remarque

L'architecture Mac M1 n'est pas directement compatible avec Cocoapods. Si vous rencontrez des problèmes lors de l'installation des pods, vous pouvez les résoudre en exécutant :

sudo arch -x86_64 gem install ffi
arch -x86_64 pod install

Ces commandes installent le package ffi pour charger les bibliothèques liées dynamiquement et vous permettent d'exécuter correctement la commande pod install, et exécutent pod install avec l'architecture appropriée.

Initialiser le SDK

Le module Rokt fournit deux méthodes :

• Initialize(string ROKT_TAG_ID, string AppVersion)
• Execute(string TemplateVersion, object UserAttributes, object placements, function onLoad)

La méthode initialize récupère les résultats de l'API nécessaires à la méthode execute. Il est donc préférable de ne pas mettre les deux appels immédiatement l'un à côté de l'autre. Il est recommandé d'appeler la méthode initialize dans les premières vues de l'application.

Pour initialiser le SDK, vous devez :

1. Importer le SDK Rokt dans le fichier JavaScript :

import { Rokt, RoktEmbeddedView } from "@rokt/react-native-sdk";

2. Initialiser le SDK Rokt :

// Ce qui suit révélera une intégration de démonstration. Pour afficher votre intégration :
// 1) Remplacez l'ID de tag de test d'intégration (222) par votre identifiant de compte Rokt unique
// 2) Remplacez Y.Y.Y par la version de l'application

Rokt.initialize("222", "Y.Y.Y");

Étapes suivantes

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

• Ajouter un emplacement
• Rapporter des conversions