Last updated 2023年9月12日

React Native SDKの初期化

Roktのパートナーは、Rokt SDKをReact Nativeアプリケーションに統合してオーバーレイや埋め込みプレースメントを表示することができます。Roktの広告主は、キャンペーンの変換を記録するために使用することができます。SDKのすべてのユースケースは、アプリケーションにSDKを統合して初期化するための同じ手順に従います。大まかに言うと、以下の手順があります。

1. React NativeアプリケーションにSDKを統合する
2. Androidアプリケーションの設定
3. iOSアプリケーションの設定
4. SDKの初期化

これらの手順に従って、SDKのexecuteメソッドを必要なユースケースに合わせて使用することができます。

React NativeアプリケーションにSDKを統合する

React NativeアプリケーションにSDKを統合するには、次の手順を実行する必要があります。

1. コマンドを実行してRokt SDKをインストールします。

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

2. コマンドを実行してすべてのパッケージと依存関係をインストールします:

   $ npm install

Androidの設定

AndroidアプリケーションでRokt React Native SDKを設定するには、次の手順を実行する必要があります:

1. build.gradleのrepositoriesブロックにRokt SDKを追加します:

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

2. ReactApplicationクラスにRoktEmbeddedViewPackageをgetPackagesに追加します:

// クラスをインポートする
import com.reactlibrary.RoktEmbeddedViewPackage;

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

    // RoktEmbeddedViewPackageを追加します
    packages.add(new RoktEmbeddedViewPackage());
    return packages;
}  

3. multiDexEnabledがtrueに設定されていることを確認し、Mind SDKのバージョンが18以上をターゲットにしていることを確認します:

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

注記

Kotlinのバージョンの競合によりビルドが失敗する場合は、以下のリンクを参照して可能な解決策を確認してください: https://github.com/facebook/react-native/issues/35979

iOSの設定

iOSアプリケーションでRokt React Native SDKを設定するには、iOSフォルダに移動して次のコマンドを実行します:

cd ios && pod install

注記

Mac M1アーキテクチャはCocoapodsと直接互換性がありません。ポッドのインストール時に問題が発生した場合は、次のコマンドを実行して解決できます：

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

これらのコマンドは、動的リンクライブラリをロードするためのffiパッケージをインストールし、正しいアーキテクチャでpod installを実行します。

SDKの初期化

Roktモジュールには2つのメソッドがあります：

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

initializeメソッドは、executeメソッドで必要なAPIの結果を取得します。そのため、両方の呼び出しをすぐに隣り合わせにしない方が良いです。アプリの最初の数ビュー内でinitializeメソッドを呼び出すことを推奨します。

SDKを初期化するには、次の手順を実行します：

1. JavaScriptファイルにRokt SDKをインポートします：

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

2. Rokt SDKを初期化します：

// 以下はデモ統合を表示します。統合を表示するには：
// 1) 統合テストタグID（222）を一意のRoktアカウントIDで置き換えます
// 2) Y.Y.Yをアプリケーションのバージョンに置き換えます

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

次のステップ

次のステップは、統合のユースケースによって異なります。詳細な情報については、以下のリソースを参照してください：

• プレースメントの追加
• コンバージョンの報告