adjust-icon

React Native SDK 連携ガイド

Adjust React Native SDKを実装することで、アトリビューションやイベントなどのさまざまなデータをReact Nativeアプリで計測できます。Adjust SDKをアプリに実装するには、以下の手順に従ってください。また、GitHubのサンプルアプリもご覧ください。

1. プロジェクトにSDKを追加する

React NativeアプリでAdjust SDKを使うには、プロジェクトに追加する必要があります。

  1. 次のオプションのいずれか1つを使用して、React Nativeライブラリをダウンロードします。
Terminal window
$ npm install react-native-adjust@5.0.2 --save
  1. ターミナルで以下のコマンドを実行し、iOSアプリのCocoaPodsのdependencyをインストールします:
Terminal window
$ cd ios && pod install

2. SDKを実装する

SDKをプロジェクトに実装するには、AdjustのSDK設定をメインアプリのJavascriptファイルにインポートする必要があります。

アプリの.jsファイルの冒頭に、次の行を追加します:

import { Adjust, AdjustConfig } from "react-native-adjust";

3. Adjust SDKを初期化する

React Nativeアプリ内で、出来るだけ早くAdjust SDKを初期化するようにしてください。これを行うには、アプリトークンを使ってConfigオブジェクトとアプリを実行したい環境を初期化します。 また、アプリの.jsに次のコードを追加してください:

constructor(props) {
super(props);
const adjustConfig = new AdjustConfig("{YourAppToken}", AdjustConfig.EnvironmentSandbox);
Adjust.initSdk(adjustConfig);
}
componentWillUnmount() {
Adjust.componentWillUnmount();
}

AdjustConfig引数をパスします:

  • {YourAppToken}をあなたのトークンに置き換えてください。アプリトークンの確認方法については、アプリ設定をご覧ください。
  • 環境を選択します。
    • アプリをテスト中で、テストデータを送信する必要がある場合は、AdjustConfig.EnvironmentSandboxを使用してください。テストデータを表示するには、ダッシュボードでサンドボックスモードを有効にする必要があります。
    • テストが完了し、アプリを公開する準備が整ったら、AdjustConfig.EnvironmentProductionを使用してください。

4. Androidデバイスを設定する

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

Adjust SDKが情報にアクセスするには、特定のパーミッションが必要です。

  • INTERNET: Adjust Android SDKに自動的に追加されます。手動で追加する必要はありません。

また、追加情報へのアクセスを許可するオプションの権限を追加することもできます。

  • ACCESS_NETWORK_STATE (オプション):これを AndroidManifest.xmlファイルに追加して、便利なパラメーターを読み込むことができます。
AndroidManifest.xml
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

Adjust SDKには、バージョン4.32.0以降、デフォルトでcom.google.android.gms.AD_IDパーミッションが含まれています。アプリをCOPPAに準拠させる必要がある場合や、Google Playストアをターゲットにしていない場合は、removeディレクティブを追加することでこれを削除することができます。

AndroidManifest.xml
<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

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

Google Playストアを対象とするアプリは、Google広告IDgps_adid)を使用してデバイスを識別する必要があります。これを行うには、以下のdependencyをbuild.gradleファイルの dependenciesセクションに追加してください。

build.gradle
implementation 'com.google.android.gms:play-services-ads-identifier:18.1.0'

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

インストールリファラーは、アプリインストールをソースにアトリビュートするために使用できるアトリビューションメカニズムです。2つの部分で構成されます。

  • アプリ内でリファラルコンテンツを取得するために開発者が使用する、これらのアプリストアの一連のAPI。
  • Google PlayやHuawei App Galleryなどのアプリストアで、ストアWebサイト上のアプリページURLに使用できるreferrerパラメーター。リファラーパラメーターの設定方法は次のとおりです。
    • ユーザーがAdjustリンクをクリックすると、AdjustサーバーはreftagというユニークIDをパスします。このIDはクリックとリファラーパラメーターに割り当てられます。リファレンスタグの詳細については、リファレンスタグを参照してください。
    • Google 広告キャンペーンを実行すると、gclidというユニークIDがGoogleからリファラーパラメーターに渡されます。Google広告アカウントで 自動タグ が有効になっている必要があります。

Google Play Referrer API

Google Play Referrer APIをサポートする:

  1. アプリレベルのbuild.gradleファイルの dependenciesブロック に以下の行を追加します:
build.gradle
dependencies {
//...
implementation 'com.android.installreferrer:installreferrer:2.2'
//...
}
  1. installreferrerライブラリは Google Maven リポジトリに含まれています。アプリをビルドするには、アプリのトップレベルのbuild.gradleファイルにGoogle Mavenリポジトリを追加する必要があります:
build.gradle
allprojects {
repositories {
maven {
url "https://maven.google.com"
}
}
}

Metaとのリファラー連携

Adjust SDKは、Adjust Metaインストールリファラープラグインを使用してMetaインストールリファラーをサポートしています。連携の詳細については、React Native Meta インストール リファラープラグインをご覧ください

5. iOS frameworksを追加する

特定のiOS frameworksをアプリに実装すると、Adjust SDKは追加の情報を取得できます。これらのframeworksによって特定のSDK機能を有効にできますが、SDKが正常に動作するために必須というわけではありません。 フレームワークを追加し、その後、 Project Settings —> Build Phases —> Link Binary With LibrariesOptional としてマークすることができます。

Framework説明注意
AdSupport.frameworkSDKがIDFA値と(iOS 14以前の)LAT情報にアクセスするには、このframeworkが必要です。アプリが「子供向け」カテゴリーをターゲットにしている場合は、このframeworkは実装しないでください。
AdServices.frameworkこのフレームワークは、Apple Search Ads アトリビューションを処理するのに必要です。
StoreKit.frameworkiOS 14以降において、このframeworkはSKAdNetwork frameworkにアクセスし、SKAdNetworkとの通信をAdjust SDKで自動的に処理できるようにします。
AppTrackingTransparency.frameworkiOS 14またはそれ以降において、このframeworkはSDKがATTに対する同意を確認するダイアログをラップし、ユーザーの許諾状況を示す値にアクセスします。アプリが「子供向け」カテゴリーをターゲットにしている場合は、このframeworkは実装しないでください。

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

SDK v5には、 SDKシグネチャーライブラリが含まれています。連携が正常に機能することを確認するためには、iOSAndroidのためのガイドを参照してください。

シグネチャーの保護機能は、デフォルトで非アクティブになっています。これを有効化するには、以下の手順に従ってください

  1. シグネチャーの検証を有効化します
  2. テスト前にアプリのSHA-1フィンガープリントを提供してください

7. 連携をテストする

Adjust SDKは、実装をテストとトラブルシューティングのためのツールを提供します。以下の手順に従って、実装をテストしてください。

  • 環境をAdjustConfig.EnvironmentSandboxに設定します。
  • Adjustダッシュボードにサンドボックスフィルターを追加します。
  • ログレベルをAdjustConfig.LogLevelVerboseに設定します。

Google Play 開発者サービスの連携をテストする

Adjust SDKがデバイスのGoogle広告IDを受信できるかどうかテストするには、ログレベルをAdjustConfig.LogLevelVerboseに、環境をAdjustConfig.EnvironmentSandboxに設定します。アプリを起動してセッションまたはイベントを記録します。SDKは、広告IDを読み取った場合、 gps_adid パラメーターをログに記録します。

Google広告IDを取得する際に問題が発生した場合は、SDK Githubリポジトリで質問を投稿するか、support@adjust.comまでお問い合わせください。