React Native SDK 連携ガイド

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

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

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

1. 次のオプションのいずれか1つを使用して、React Nativeライブラリをダウンロードします。

2. ターミナルで以下のコマンドを実行し、iOSアプリのCocoaPodsのdependencyをインストールします：

$ cd ios && pod install

2. SDKを実装する

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

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

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

3. Adjust SDKを初期化する

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

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

componentWillUnmount() {
   Adjust.componentWillUnmount();
}

AdjustConfig引数をパスします：

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

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

パーミッションを追加

Adjust SDKが情報にアクセスするには、特定のパーミッションが必要です。まだ存在しない場合は、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ディレクティブを追加することでこれを削除することができます。

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

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

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

implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'

ProGuardを設定する

ProGuardを使用している場合は、以下のルールをカスタムのProGuardファイルに追加してください。

-keep class com.adjust.sdk.** { *; }
-keep class com.google.android.gms.common.ConnectionResult {
   int SUCCESS;
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient {
   com.google.android.gms.ads.identifier.AdvertisingIdClient$Info getAdvertisingIdInfo(android.content.Context);
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient$Info {
   java.lang.String getId();
   boolean isLimitAdTrackingEnabled();
}
-keep public class com.android.installreferrer.** { *; }

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

インストールリファラーは、アプリインストールをソースにアトリビュートするために使用できるアトリビューションメカニズムです。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ブロック に以下の行を追加します：

dependencies {
//...
implementation 'com.android.installreferrer:installreferrer:2.2'
//...
}

2. installreferrerライブラリは Google Maven リポジトリに含まれています。アプリをビルドするには、アプリのトップレベルのbuild.gradleファイルにGoogle Mavenリポジトリを追加する必要があります：

allprojects {
   repositories {
      maven {
         url "https://maven.google.com"
      }
   }
}

3. Proguardを使用している場合は、Proguardファイルに以下の設定が含まれていることを確認してください。

-keep public class com.android.installreferrer.** { *; }

Huawei Referrer API

バージョン4.22.0以降より、Adjust SDKはHuawei AppGalleryバージョン10.4以降のHuaweiデバイスでのインストール計測をサポートしています。Huawei Referrer APIの使用を開始するために行う設定変更はありません。

Metaとのリファラー連携

Adjust SDKはv4.37.0以降でMetaインストールリファラーをサポートしています。この機能を有効にする方法：

1. App DashboardでMetaアプリIDを検索します。詳しくはMetaのApp Dashboardのドキュメントをご覧ください。

2. AdjustConfig.setFbAppIdメソッドにstring引数としてアプリIDをパスします。

   const adjustConfig = new AdjustConfig(
      "{YourAppToken}",
      AdjustConfig.EnvironmentSandbox,
   );
   //...
   adjustConfig.setFbAppId("<fb_app_id_string>");
   //...
   Adjust.create(adjustConfig);

5. iOS frameworksを追加する

特定のiOS frameworksをアプリに実装した場合、Adjust SDKは追加の情報を取得できます。これらのframeworksによって特定のSDK機能を有効にできますが、SDKが正常に動作するために必須というわけではありません。Frameworksを実装して、 プロジェクト設定（Project Settings） > ビルドフェーズ（Build Phases） > バイナリとライブラリをリンク（Link Binary With Libraries） でそれらをオプションとしてマークすることができます。

6. Adjust SDKシグネチャーを追加する

Adjust SDKシグネチャーを使用して、Adjust SDKによって送信される全ての通信に署名できます。これによりAdjustのサーバーは、シグネチャーがない不正インストールを検出し、拒否することができます。

Adjust SDKシグネチャーの使用を開始するには、担当のテクニカルアカウントマネージャーまたはsupport@adjust.comまでお問い合わせください。

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までお問い合わせください。