EcommAndroid

Android SDKを使用した統合

Roktのパートナーは、Android SDKを使用してオーバーレイまたは埋め込みプレースメントを表示でき、Roktのブランドはキャンペーンのコンバージョンを記録するために使用できます。Rokt Android SDKは、MavenおよびGradleを使用してデプロイされます。

注記

Rokt Android SDKにはProGuardルールが含まれており、追加の設定は不要です。

SDKのすべてのユースケースは、統合および初期化のために同じ初期ステップに従います。概要として、これらのステップは以下の通りです：

1. ワークスペースを設定し、Rokt Gradleリポジトリを有効にする
2. Rokt Placementプラグインを追加する
3. Rokt Android SDKモジュールを追加する
4. Rokt Android SDKを初期化する

これらのステップに続いて、SDKのexecuteメソッドをさまざまな方法で使用して、必要なユースケースに適合させることができます。

注記

このガイドは、Gradleに精通しており、Android開発のためのプラグインのインストール方法を知っていることを前提としています。

Android SDK のセットアップ

1. ワークスペースをセットアップし、Rokt Gradle リポジトリを有効にします。
2. プロジェクトの build.gradle ファイルに Rokt Widget プラグインのリポジトリ URL を追加します。

 // file => build.gradle (Project: ....)

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

または、Gradle 7.0.0 以上を使用している場合、リポジトリ設定が以前はトップレベルの build.gradle ファイルにありましたが、現在は settings.gradle ファイルにあるため、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"
        }
    }
}

3. Rokt Android SDK モジュールをモジュールの build.gradle に追加します。

 // file => build.gradle (Module: ...)

dependencies {
    ...
    // 注: 3.11.0 は Rokt Android SDK の最新バージョンを反映しています。
    implementation 'com.rokt:roktsdk:3.11.0'
    ...
}

4. どのアクティビティでも使用する前に Rokt SDK を初期化します。LauncherActivity クラスから init メソッドを呼び出すことをお勧めします。

注意

Rokt アカウントに関連付けられた Rokt アカウント ID を取得するには、Rokt に連絡してください。統合をテストするために、以下の Rokt アカウント ID を使用できますが、本番環境で起動する前に、必ずあなたのユニークな Rokt アカウント ID に置き換えてください。

テストアカウント ID: 222

Java

import com.rokt.roktsdk.Rokt

public class LauncherActivity: Activity {
    override fun onCreate(savedInstanceState: Bundle"?") {
        ...
        // 以下はデモ統合を表示します。統合を表示するには:
        // 1) 統合テストタグ ID (222) をあなたのユニークな Rokt タグ ID に置き換える
        // 2) Y.Y.Y をアプリケーションのバージョンに置き換える
        Rokt.init("222", "Y.Y.Y", this@LauncherActivity)
        ...
    }
}

Kotlin

import com.rokt.roktsdk.Rokt;

public class LauncherActivity extends Activity {
    override fun onCreate(savedInstanceState: Bundle"?") {
        ...
        // 以下はデモ統合を表示します。統合を表示するには:
        // 1) 統合テストタグID (222) をあなたのユニークなRoktタグIDに置き換える
        // 2) Y.Y.Y をアプリケーションのバージョンに置き換える
        Rokt.INSTANCE.init("222", "Y.Y.Y", LauncherActivity.this)
        ...
    }
}