EcommRN

Intégrer en utilisant le SDK React Native

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 :

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

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

   $ npm install

Configurer pour Android

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

1. Ajouter le SDK Rokt dans votre dépôt Maven :

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

Ou si vous utilisez Gradle 7.0.0 et supérieur, où les paramètres du dépôt qui étaient précédemment dans le fichier build.gradle de niveau supérieur sont maintenant dans le fichier settings.gradle, ajoutez ce qui suit dans le fichier settings.gradle.

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven {
            url "https://rokt-eng-us-west-2-mobile-sdk-artefacts.s3.amazonaws.com"
        }
    }
}

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

       @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
    }
}

Configurer pour iOS

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

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 le pod install, et exécutent pod install avec la bonne architecture.

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 placer 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 voir votre intégration :
// 1) Remplacez l'ID de balise de test d'intégration (222) par votre ID de compte Rokt unique
// 2) Remplacez Y.Y.Y par la version de l'application

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