メインコンテンツまでスキップ

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. プロジェクトの settings.gradle ファイルに Rokt Widget プラグインリポジトリの URL を追加します。
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven("https://apps.rokt.com/msdk")
    }
}

または、リポジトリ設定がトップレベルの build.gradle ファイルにある Gradle 7.0.0 未満のバージョンを使用している場合は、build.gradle ファイルに次の内容を追加します。

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

allprojects {
    repositories {
        google()
        mavenCentral()
        maven("https://apps.rokt.com/msdk")
    }
}
  1. (オプション) バージョンカタログを使用している場合は、libs.versions.toml (または他の名前のカタログ) に Rokt Android SDK モジュールを追加します。
[versions]
roktsdk = "4.5.0"

[libraries]
roktsdk = { group = "com.rokt", name = "roktsdk", version.ref = "roktsdk" }
  1. モジュールの build.gradle に Rokt Android SDK モジュールを追加します。

バージョンカタログを使用する場合​

 // ファイル => build.gradle.kts (モジュール: ...)

dependencies {
    ...
    implementation(libs.roktsdk)
    ...
}

バージョンカタログを使用しない場合​

 // ファイル => build.gradle.kts (モジュール: ...)

dependencies {
    ...
    implementation('com.rokt:roktsdk:4.5.0')
    ...
}
  1. Rokt SDKを使用する前に初期化します。LauncherActivityクラスからinitメソッドを呼び出すことをお勧めします。
注意

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

テストアカウントID: 222

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)
        ...
    }
}

フォントを使用した初期化​

注記

この機能はRokt Android SDKのバージョン4.2.0からサポートされています。

One Platformで希望するフォントを提供する代わりに、またはそれに加えて、アプリケーションに既にバンドルされているフォントを利用することができます。これにより、初期化時にフォントをダウンロードする可能性がなくなり、ネットワークの利用を減らし、ダウンロードエラーの可能性を減らすという利点があります。アプリケーションの assets ディレクトリにあるフォントリソースを使用するか、自分の Typeface オブジェクトを渡すことができます。

フォントアセットの使用​

アプリケーションの assets ディレクトリに保存されているフォントを利用することができます。このためには、フォントのポストスクリプト名をアセットディレクトリ内のファイルパスにマッピングするマップを init メソッドに渡すことができます（アセットディレクトリはルートディレクトリです）。ポストスクリプト名はレイアウトで使用されているものと一致する必要があります。不明な場合はアカウントマネージャーに確認してください。

import com.rokt.roktsdk.Rokt;

public class LauncherActivity extends Activity {
    override fun onCreate(savedInstanceState: Bundle?) {
        ...
        Map<String,String> fontFilePathMap = new HashMap<String, String>();
        fontFilePathMap.put("Arial-Bold", "fonts/arialbold.otf");
        Rokt.INSTANCE.init(
            "222",
            "Y.Y.Y",
            LauncherActivity.this,
            new HashSet<>(), // fontPostScriptNames can be empty 
            fontFilePathMap
        );
        ...
    }
}

フォント書体の使用​

アプリケーションで作成したTypefaceオブジェクトを使用することもできます。そのためには、フォントのポストスクリプト名のセットをinit関数に渡し、後でexecute関数にTypefacesを渡す必要があります（詳細は配置の追加を参照）。

import com.rokt.roktsdk.Rokt;

public class LauncherActivity extends Activity {
    override fun onCreate(savedInstanceState: Bundle?) {
        ...
        Set<String> fontPostScriptNames = new HashSet<String>();
        fontFilePathMap.add("Arial-Bold");
        Rokt.INSTANCE.init(
            "222",
            "Y.Y.Y",
            LauncherActivity.this,
            fontPostScriptNames
        );
        ...
    }
}

デバッグ​

Rokt.setLoggingEnabled(enable = true) API を使用して、Rokt SDK からのデバッグログを有効にします。

次のステップ​

統合の使用例に応じて、次のステップが異なります。以下のトピックを確認してください:

この記事は役に立ちましたか？