Android SDK連携ガイド

Adjust Android SDKを実装することで、アトリビューション、イベント、さらにその他のさまざまなデータをAndroidアプリで記録できます。Adjust SDKをアプリに実装するには、以下の手順に従ってください。

1. 環境を設定する

Adjust SDKを使い始めるには、SDKをdependencyとしてプロジェクトに追加してください。Adjust SDKはMavenで利用可能です。

プロジェクトにAdjust SDKを追加する方法。

1. Adjust SDKとAndroidリファラーの実装をbuild.gradleファイルに追加します。アプリでWeb viewを使用する場合、オプションでAdjust Web viewブリッジを追加します。

   1
   dependencies {
   2
      implementation 'com.adjust.sdk:adjust-android:5.4.6'
   3
      implementation 'com.android.installreferrer:installreferrer:2.2'
   4
      // Add the following if you are using the Adjust SDK inside web views on your app
   5
      implementation 'com.adjust.sdk:adjust-android-webbridge:5.4.6'
   6
   }

2. Google Play 開発者サービスを追加する

Google Playストアを対象とするアプリは、gps_adid（Google広告ID）を使用してデバイスを識別する必要があります。gps_adidにアクセスするには、play-services-ads-identifierAARをプロジェクトに追加する必要があります。

Mavenを使用している場合は、build.gradleファイルに以下を追加します。

1
dependencies {
2
   implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'
3
}

3. パーミッションを追加する

Adjust SDKがデバイス情報にアクセスできるようにするには、アプリが必要とするパーミッションを宣言する必要があります。これを行うには、AndroidManifest.xmlファイルにパーミッションを追加します。

オンライン機能にアクセスするには、以下のパーミッションを追加してください。

1
<uses-permission android:name="android.permission.INTERNET"/>
2
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

アプリがGoogle Play ストアを対象としていない場合、デバイスのネットワーク状態にアクセスするために以下のパーミッションを追加してください。

1
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>

Adjust SDKには、デフォルトでcom.google.android.gms.AD_IDパーミッションが含まれています。アプリがCOPPA（児童オンラインプライバシー保護法）に準拠する必要がある場合、またはアプリがGoogle Play ストアを対象としていない場合は、removeディレクティブを使用してこのパーミッションを削除する必要があります。

1
<uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>

4. インストールリファラーを設定する

インストールリファラーは、インストールをソースにアトリビュートするために使用される一意の識別子です。Adjust SDKは、アトリビューションを実行するためにこの情報を必要とします。インストールのリファラー情報を取得するには、以下のいずれかの方法を使用します。

Google Play Referrer API

Google Play Referrer APIは、Google Play ストアを対象とするアプリで使用できます。

Google Play Referrer APIをサポートするには、build.gradleファイルに以下を追加します。

1
dependencies {
2
   implementation 'com.android.installreferrer:installreferrer:2.2'
3
}

HuaweiリファラーAPI

Huawei Referrer APIは、Huaweiデバイスを対象とするアプリで使用できます。Adjust SDKは、Adjust Huawei Referrerプラグインを使用して、Huaweiデバイスでのインストールを記録します。

このプラグインをインストールするには、build.gradleファイルに以下のdependencyを追加します。

1
dependencies {
2
   implementation: "com.adjust.sdk:adjust-android-huawei-referrer:5.0.0"
3
}

Xiaomiリファラープラグイン

Xiaomiリファラープラグインを使用すると、Xiaomiデバイスを対象とするアプリのインストールリファラー値を記録できます。インストール情報については、プラグインに関するドキュメントを参照してください。

Samsungリファラープラグイン

Samsungリファラープラグインを使用すると、Samsung Galaxyストアを対象とするアプリのインストールリファラー値を記録できます。インストール情報については、プラグインに関するドキュメントを参照してください。

Metaとのリファラー連携

AdjustSDKはAdjustのMetaインストールリファラーを使用してMetaインストールリファラーをサポートしています。連携の詳細については、ドキュメントをご覧ください。

5. SDKシグネチャーを設定する

Adjust SDKとAdjustのサーバー間の通信を保護するためにSDKシグネチャーライブラリを使用する場合は、AdjustヘルプセンターのSDKシグネチャーガイドの手順に従ってください。

6. Adjust SDKを実装する

Adjust SDKを初期化するには以下の情報が必要です。

• appToken: お客様のAdjustアプリトークン。
• environment: アプリの実行環境。アプリをローカルでテストするには、これをAdjustConfig.ENVIRONMENT_SANDBOXに設定します。

Adjust SDKを初期化する推奨の方法は、グローバルAndroidアプリケーションクラス内です。まだこれをアプリに設定していない場合は、以下の手順に従ってください。

1. Applicationを継承したクラスを作成します。

2. AndroidManifest.xml ファイルを開き、 <application>エレメントを確認します。

3. android:nameアトリビュートを<application>要素に追加し、アプリケーションクラスの名前に設定します。例えば、Applicationクラスの名前がGlobalApplicationの場合、以下を設定します。

   1
   <application android:name=".GlobalApplication">
   2
      <!-- ... -->
   3
   </application>

4. ApplicationクラスでinitSdkメソッドを見つけるか、存在しない場合は追加してください。以下のパラメーターを渡してAdjust SDKを初期化します。

   • チーム編成 appToken
   • アプリを実行したいenvironment
   • 記録したいLogLevel

1
import com.adjust.sdk.Adjust;
2
import com.adjust.sdk.AdjustConfig;
3

4
class GlobalApplication : Application () {
5
   override fun onCreate() {
6
      super.onCreate()
7

8
      val appToken = "{YourAppToken}"
9
      val environment = AdjustConfig.ENVIRONMENT_SANDBOX;
10
      val config = AdjustConfig(this, appToken, environment)
11
      config.setLogLevel(LogLevel.VERBOSE)
12
      Adjust.initSdk(config)
13
   }
14
}

1
import com.adjust.sdk.Adjust;
2
import com.adjust.sdk.AdjustConfig;
3

4
public class GlobalApplication extends Application {
5
   @Override
6
   public void onCreate() {
7
      super.onCreate();
8

9
      String appToken = "{YourAppToken}";
10
      String environment = AdjustConfig.ENVIRONMENT_SANDBOX;
11
      AdjustConfig config = new AdjustConfig(this, appToken, environment);
12
      config.setLogLevel(LogLevel.VERBOSE)
13
      Adjust.initSdk(config);
14
   }
15
}

Adjust Web View SDKを実装する

アプリがWeb viewを使用している場合、Adjust Web View SDKを使って情報を記録する必要があります。WebViewオブジェクトへのリファレンスを取得する必要があります。これが完了したら、以下の手順に従ってください。

1. webView.getSettings().setJavaScriptEnabled(true)を呼び出して、WebビューでJavascriptを有効にします。

2. AdjustBridge.registerAndGetInstance(getApplication(), webview)を呼び出して、デフォルトのAdjustBridgeInstanceを起動します。これにより、AdjustブリッジがJavascriptインターフェイスとしてWeb viewに登録されます。

3. AdjustBridge.setWebView()を呼び出し、新しいWebViewを設定します。

4. AdjustBridge.unregister()を呼び出し、AdjustBridgeInstanceとWebViewの登録を解除します。

5. 以下は完全な設定の例です。

1
class MainActivity : Activity() {
2
   override fun onCreate(savedInstanceState: Bundle?) {
3
         super.onCreate(savedInstanceState)
4
         setContentView(R.layout.activity_main)
5

6
         val webView = findViewById<webview>(R.id.webView)
7
         webView.settings.javaScriptEnabled = true
8
         webView.webChromeClient = WebChromeClient()
9
         webView.webViewClient = WebViewClient()
10

11
         AdjustBridge.registerAndGetInstance(application, webView)
12
         try {
13
            webView.loadUrl("file:///android_asset/AdjustExample-WebView.html")
14
         } catch (e: Exception) {
15
            e.printStackTrace()
16
         }
17
   }
18

19
   override fun onDestroy() {
20
      AdjustBridge.unregister()
21

22
      super.onDestroy()
23
   }
24
}

1
public class MainActivity extends Activity {
2
   @Override
3
   protected void onCreate(Bundle savedInstanceState) {
4
      super.onCreate(savedInstanceState);
5
      setContentView(R.layout.activity_main);
6

7
      WebView webView = (WebView) findViewById(R.id.webView);
8
      webView.getSettings().setJavaScriptEnabled(true);
9
      webView.setWebChromeClient(new WebChromeClient());
10
      webView.setWebViewClient(new WebViewClient());
11

12
      AdjustBridge.registerAndGetInstance(getApplication(), webview);
13
      try {
14
            webView.loadUrl("file:///android_asset/AdjustExample-WebView.html");
15
      } catch (Exception e) {
16
            e.printStackTrace();
17
      }
18
   }
19

20
   @Override
21
   protected void onDestroy() {
22
      AdjustBridge.unregister();
23

24
      super.onDestroy();
25
   }
26
}

1. HTMLにAdjust Javascriptファイルをインポートします。

   1
   <script type="text/javascript" src="adjust.js"></script>
   2
   <script type="text/javascript" src="adjust_event.js"></script>
   3
   <script type="text/javascript" src="adjust_third_party_sharing.js"></script>
   4
   <script type="text/javascript" src="adjust_config.js"></script>

2. appTokenとenvironmentをAdjustConfigクラスに渡すことで、Web viewでAdjust SDKを初期化することができます。

   1
   let yourAppToken = "{YourAppToken}";
   2
   let environment = AdjustConfig.EnvironmentSandbox;
   3
   let adjustConfig = new AdjustConfig(yourAppToken, environment);
   4
   adjustConfig.setLogLevel(AdjustConfig.LogLevelVerbose);
   5
   Adjust.initSdk(adjustConfig);

7. 本番用にアプリをビルドする

テストが終わったら、本番用にアプリをビルドできます。そのためには、configオブジェクトを更新する必要があります。

1. 必要なものだけを返すようにログレベルを調整します。
2. environmentをAdjustConfig.ENVIRONMENT_PRODUCTIONに設定します。

1
val appToken = "{YourAppToken}"
2
val environment = AdjustConfig.ENVIRONMENT_PRODUCTION;
3
val config = AdjustConfig(this, appToken, environment)
4
config.setLogLevel(LogLevel.WARN)
5
Adjust.initSdk(config)

1
String appToken = "{YourAppToken}";
2
String environment = AdjustConfig.ENVIRONMENT_PRODUCTION;
3
AdjustConfig config = new AdjustConfig(this, appToken, environment);
4
config.setLogLevel(LogLevel.WARN)
5
Adjust.initSdk(config);