Pages web mobiles intégrées

Rokt fournit plusieurs solutions d'intégration SDK permettant aux partenaires d'intégrer la technologie Rokt dans leur site web ou application mobile. Cela inclut le Rokt Web SDK pour les intégrations basées sur le navigateur et le Rokt iOS SDK et Rokt Android SDK pour les intégrations mobiles natives. Cependant, lorsque les technologies de navigateur et mobiles sont combinées, certaines considérations spéciales doivent être prises en compte.

Lorsque des pages web sont rendues à l'intérieur d'une application mobile, le Web SDK reste le principal point d'intégration. Dans ce scénario, le Web SDK rend les emplacements et offres Rokt appropriés sur la page web tout comme il le ferait dans un environnement de navigateur mobile ou de bureau. Cependant, une attention particulière dans l'intégration est nécessaire pour la manière dont les liens de trafic sont ouverts dans un environnement d'application mobile afin d'assurer une expérience utilisateur optimale.

Le Rokt WebView SDK, une petite extension des technologies WebView courantes sur iOS et Android, fonctionne avec le Web SDK pour s'assurer que tous les liens de trafic d'un emplacement Rokt sont ouverts avec succès dans le navigateur par défaut de l'appareil au lieu de perturber le flux de navigation attendu du client. Le WebView SDK ajuste uniquement le comportement de l'ouverture des liens de trafic, sans affecter le comportement d'un autre aspect de l'application hôte ou du site web. Cela se traduit par un flux client transparent dans l'application, garantissant que le client peut ouvrir un lien avec succès après avoir opté pour une offre.

Comment fonctionne le SDK Rokt WebView ?

Le SDK WebView fonctionne en modifiant l'agent utilisateur du navigateur afin que Rokt puisse identifier quand un emplacement a été rendu sur une page web à l'intérieur d'une application mobile. Rokt modifie ensuite le comportement d'ouverture des liens pour que les liens de trafic s'ouvrent dans le navigateur par défaut de l'appareil.

Notez que le SDK Rokt WebView n'est pas l'intégration principale de Rokt mais une petite mise à jour de la technologie WebView qui est déjà utilisée dans les applications mobiles. Le SDK Web de Rokt est l'intégration principale avec Rokt, tandis que le SDK Rokt WebView garantit que les liens de trafic s'ouvrent correctement depuis l'application.

Le SDK WebView peut être implémenté dans des applications mobiles utilisant les technologies suivantes :

• WKWebView pour iOS
• Android WebView pour Android

Applications Android

Les instructions supposent que vous remplacez l'Android WebView par le Rokt WebView. L'approche exacte dépend de si le WebView est initialisé de manière programmatique ou non.

Versions

Système	Version
Rokt WebViewSDK	1.0.0
Version Android/Niveau API	4.3+ (Niveau API 18)
Gestionnaire de paquets	Maven / Gradle

1. Ajoutez le dépôt Maven JitPack à la liste des dépôts dans le fichier build.gradle du projet.

 // fichier => build.gradle (Projet : ....)

allprojects {
    repositories {
        google()
        maven { url "https://jitpack.io" }
    }
}

2. Ajoutez le Rokt WebView SDK.

   Ouvrez le fichier build.gradle pour votre module d'application et ajoutez la bibliothèque roktwebviewsdk à la section des dépendances. Notez que x.x.x doit être remplacé par la version la plus récente du Rokt WebView SDK.

dependencies {
   ``` implementation 'com.github.ROKT:rokt-webview-sdk-android:x.x.x' ```
}

3. Ajoutez le Rokt WebView SDK à votre mise en page.

   Dans votre fichier de mise en page, remplacez les références à webView par roktWebView.

   Remplacez :

<?xml version="1.0" encoding="utf-8"?>
  <WebView
      android:id="@+id/webView"
      android:layout_width="match_parent"
      android:layout_height="match_parent"/>

Par :

<?xml version="1.0" encoding="utf-8"?>
  <com.rokt.roktwebviewsdk.RoktWebView
      android:id="@+id/webView"
      android:layout_width="match_parent"
      android:layout_height="match_parent"/>

Alternativement, le WebView SDK peut être ajouté par programmation dans onCreate(). Par exemple :

Java

val myWebView = RoktWebView(activityContext)
setContentView(myWebView)

Kotlin

WebView myWebView = new RoktWebView(activityContext);
setContentView(myWebView);

4. Charger une page web

Pour charger une page web dans le roktWebView, utilisez loadUrl().

Java

val myWebView: RoktWebView = findViewById(R.id.webview)
myWebView.loadUrl("https://www.rokt.com")

Kotlin

WebView myWebView = (RoktWebView) findViewById(R.id.webview);
myWebView.loadUrl("https://www.rokt.com");

Applications iOS

Les instructions ci-dessous supposent que vous remplacez le WKWebView pour iOS par le Rokt WebView. L'approche exacte dépend de si le WebView est initialisé par programmation ou non.

Versions

Système	Version
Rokt WebViewSDK	2.0.0
iOS	14.0+
Gestionnaire de paquets	CocoaPods

1. Ajoutez le pod RoktWebViewSDK au fichier pod.

use_frameworks!
pod 'RoktWebViewSDK'

2. Ajoutez le SDK Rokt WebView à votre mise en page.

   Dans votre Storyboard, remplacez WKWebView par la classe personnalisée RoktWKWebView.

Alternativement, le SDK Rokt WebView peut être ajouté par programmation dans votre code. Par exemple :

Swift

import RoktWebViewSDK
...
var roktWKWebView = RoktWKWebView(frame: self.view.frame)

Objective-C

#```import <RoktWebViewSDK/RoktWebViewSDK-Swift.h>
...
RoktWKWebView *roktWKWebView = [[RoktWKWebView alloc] initWithFrame:self.view.frame];

3. Charger une page web.

Pour charger une page web dans le RoktWKWebView, utilisez load() pour Swift ou loadRequest() pour Objective-C.

Swift

roktWKWebView.load(URLRequest(url: URL(string: "https://www.rokt.com")!))

Objective-C

NSURL *nsurl=[NSURL URLWithString:@"https://www.rokt.com"];
NSURLRequest *nsrequest=[NSURLRequest requestWithURL:nsurl];
[roktWKWebView loadRequest:nsrequest];

Annexe

Le Rokt WebViewSDK pour iOS est déployé en utilisant CocoaPods. CocoaPods est un gestionnaire de dépendances pour iOS, supporte Swift et Objective-C. Le guide étape par étape suppose que vous êtes familier avec CocoaPod et que vous savez comment installer un Pod pour le développement iOS. Sinon, veuillez vous référer à la documentation de CocoaPod. Pour configurer un espace de travail, vous pouvez suivre ce tutoriel.

Sécurité et performance

Les SDKs pour iOS et Android sont tous deux très simples et légers, ce qui signifie qu'ils ont un impact minimal sur la performance globale d'une application. De plus, puisque le seul impact du SDK WebView est de modifier l'agent utilisateur, il ne devrait y avoir aucun impact sur tout comportement en dehors du comportement d'ouverture de lien à partir des placements Rokt.

Pour répondre à toute question ou préoccupation, les SDKs WebView pour iOS et Android sont open source.

Vous pouvez inspecter les détails de chaque SDK sur GitHub :

• Rokt WebView SDK pour iOS
• Rokt WebView SDK pour Android