Last updated 24 oct. 2023

Pages web intégrées dans les applications mobiles

importation de Tabs from '@theme/Tabs';

importation de TabItem from '@theme/TabItem';

Rokt propose plusieurs solutions d'intégration SDK qui permettent aux partenaires d'intégrer la technologie Rokt dans leur site web ou leur application mobile. Cela inclut le SDK Web Rokt pour les intégrations basées sur le navigateur, ainsi que le SDK Rokt iOS et le SDK Rokt Android pour les intégrations mobiles natives. Cependant, lorsque les technologies du navigateur et du mobile sont combinées, il faut tenir compte de certaines considérations spéciales.

Lorsque les pages web sont rendues à l'intérieur d'une application mobile, le SDK Web reste le point d'intégration principal. Dans ce scénario, le SDK Web rend les emplacements et les offres Rokt appropriés sur la page web, tout comme il le ferait dans un environnement de navigateur mobile ou de bureau. Cependant, une considération spéciale doit être prise en compte dans l'intégration pour savoir comment les liens de trafic sont ouverts dans un environnement d'application mobile afin de garantir une expérience utilisateur optimale.

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

Comment fonctionne le Rokt WebView SDK?

Le WebView SDK 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 afin que les liens de trafic s'ouvrent dans le navigateur par défaut de l'appareil.

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

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

• WKWebView pour iOS
• Android WebView pour Android

Applications Android

Les instructions supposent que vous remplacez le WebView Android par le WebView Rokt. L'approche exacte dépend de la façon dont le WebView est initialisé de manière programmative.

Versions

Système	Version
Rokt WebViewSDK	1.0.0
Version Android/API Level	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 SDK WebView Rokt.

   Ouvrez le fichier build.gradle du module de votre 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 SDK WebView Rokt.

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

3. Ajoutez le SDK WebView Rokt à 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 SDK WebView peut être ajouté de manière programmative dans onCreate(). Par exemple :

val myWebView = RoktWebView(activityContext)
setContentView(myWebView)

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

4. Charger une page web

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

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

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 la manière dont le WebView est initialisé de manière programmative.

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é de manière programmative dans votre code. Par exemple :

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

#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.

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

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é à l'aide de CocoaPods. CocoaPods est un gestionnaire de dépendances pour iOS, qui prend en charge Swift et Objective-C. Le guide étape par étape suppose que vous êtes familiarisé avec CocoaPods et savez comment installer un Pod pour le développement iOS. Si ce n'est pas le cas, veuillez vous référer à la documentation de CocoaPods. Pour configurer un espace de travail, vous pouvez suivre ce tutoriel.

Sécurité et performances

Les SDK pour iOS et Android sont tous deux très simples et légers, ce qui signifie qu'ils ont un impact minimal sur les performances globales d'une application. De plus, étant donné que le seul impact du WebView SDK est de modifier l'agent utilisateur, il ne devrait y avoir aucun impact sur le comportement en dehors du comportement d'ouverture des liens à partir des emplacements Rokt.

Pour répondre à toutes les questions et préoccupations, les WebView SDK pour iOS et Android sont open source.

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

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