Last updated 2023年9月12日

Android SDKの初期化

Roktのパートナーは、Android SDKを使用してオーバーレイや埋め込みプレースメントを表示することができます。一方、Roktのブランドはキャンペーンの変換を記録するために使用することができます。RoktのAndroid SDKはMavenとGradleを使用して展開されます。

注記

RoktのAndroid SDKにはProGuardのルールが含まれており、追加の設定は必要ありません。

SDKのすべての使用例は、SDKを統合して初期化するために同じ手順に従います。大まかに言えば、これらの手順は次のとおりです。

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

これらの手順に従って、SDKのexecuteメソッドを必要な使用例に合わせてさまざまな方法で使用することができます。

開始する前に

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

Android SDKのセットアップ

1. ワークスペースをセットアップし、Rokt Gradleリポジトリを有効にします。リポジトリをセットアップするには、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"
        }
    }
}

Or if you are using Gradle 7.0.0 and above, where the repository settings that were previously in the top-level build.gradle file are now in the settings.gradle file, add the following in settings.gradle file.

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. build.gradleファイルのモジュールにRokt Android SDKモジュールを追加します。

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

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

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

注意

Roktに連絡して、アカウントに関連付けられたRoktアカウントIDを取得してください。統合をテストするために、以下のRoktアカウントIDを使用することもできますが、本番環境で起動する前に一意のRoktアカウントIDに置き換える必要があります。

テストアカウントID: 222

Java

import com.rokt.roktsdk.Rokt

public class LauncherActivity: Activity {
    override fun onCreate(savedInstanceState: Bundle?) {
        ...
        // The following will reveal a demo integration. To view your integration:
        // 1) Replace the integration test tag ID (222) with your unique Rokt Tag ID
        // 2) Replace Y.Y.Y with the application version
        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)
        ...
    }
}

次のステップ

次のステップは、統合の使用目的によって異なります。詳細については、次のトピックを参照してください：

• プレースメントの追加
• コンバージョンの記録