adjust-icon

アンインストールと再インストールの計測

Adjust Android SDKを使用して、アンインストールと再インストールを計測します。AdjustはPushトークンを使用することでユーザーのデバイスにサイレントPush通知を送信し、アプリが現在インストールされているかどうかを確認します。

この機能をアプリに追加するには、以下の手順に従ってください。

事前準備

はじめに、以下の設定手順をご覧ください。

要件

Google FCMをAdjustに連携する

GoogleのFirebase Cloud Messaging（FCM）APIを使用してサイレントPush通知を設定することで、アンインストールと再インストールを計測できます。 AdjustがGoogle FCMに接続するには、FCM HTTP v1 APIプライベートキーが必要です。

Google Cloudコンソール

1.Adjustのアンインストール・再インストール計測のカスタムアクセス権限を作成する

  1. Google Cloud Consoleにアクセスします。

  2. Firebaseプロジェクトに関連付けられているGoogle Cloudプロジェクトを選択します。

  3. IAM & Admin を検索します。

  4. サイドメニューで、 ロール（Role） を選択します。

  5. + 権限を作成 (Create Role) を選択します。

  6. 以下の詳細を入力します：

    1. Title : Adjust Uninstall
    2. ID : adjust_uninstall
    3. Role launch stage : General Availability

  7. + Add Permissions を選択します。

  8. Enter property name or value フィールドにcloudmessaging.messages.createと入力し、検索結果から選択します。

  9. cloudmessaging.messages.create オプションにチェックを入れ、 Add を選択します。

  10. Create を選択します。

2.サービスアカウントを作成する

  1. サイドメニューから Service Accounts を選択します。
  2. + Create Service Account を選択します。
  3. Service account name フィールドに、 Adjust Uninstall Service Accountと入力します。
  4. Create and Continue を選択します。
  5. Select a role ドロップダウンを選択します。 Adjust Uninstallを入力し、検索結果から選択します。
  6. 続ける（Continue） を選択します。
  7. Done を選択します。

3.プライベートキーを生成してダウンロードする

  1. 新しく作成したサービスアカウントを選択します。書式は以下のようになります：adjust-uninstall-service-account@test3-55065.iam.gserviceaccount.com。
  2. Keys タブを選択します。
  3. Add Key > Create new key を選択します。
  4. JSON > 作成 (Create) を選択します。 プライベートキーは、JSONファイルとしてコンピューターにダウンロードされます。

Adjustダッシュボードにて

AdjustとGoogle FCMを連携するために必要なプライベートキーの詳細を取得したら、AppViewのアプリ設定でアンインストール・再インストール計測を有効にする必要があります。

  1. プラットフォーム (Platforms) を選択します。
  2. 編集（EDIT） を選択します。
  3. Under Advanced settings , find the Record uninstall and reinstall data option. Advanced settings
  4. 接続先を追加（Add Connection） を選択します。モーダルが開き、AdjustとGoogle FCMの間に新しいパートナー接続を追加するよう求められます。 新規パートナー接続モーダル
  5. 最近生成したFCMプライベートキーなどの必要な情報を入力します。 パートナー と サービス のフィールドは自動的に入力されます。
  6. 接続（Connect） を選択します。
  7. アプリの設定を確認し、 保存（Save） を選択します。

Adjust SDKを実装する

FCMをAdjust SDKに連携するには、以下の手順に従ってください。

  1. build.gradleファイルに、 Firebase Messaging に必要なdependencyがあることを確認してください。

    dependencies {
       // ...
       implementation 'com.google.firebase:firebase-messaging:23.4.0'
       // ...
    }

  2. Set up a Firebase Cloud Messaging client app on Android following Google’s documentation, if you haven’t already done so.

  3. デバイスのプッシュトークンをAdjust SDKにパスします。

    • アプリに独自のPush通知を送信する場合は、全てのタイプのPush通知を処理するロジックを使ってFirebaseMessagingServiceクラスのonMessageReceivedメソッドをオーバーライドするようにしてください。それにはアンインストールおよび再インストール計測のためのAdjustのサイレントPush通知も含まれます。

例

The following code snippet shows how you can extend the FirebaseMessagingService class to pass the push token to the Adjust SDK, and to update your push notification handling logic. If you aren’t sending your own push notifications, you can skip the override of the onMessageReceived method.

  1. Adjust SDKを初期化する前に、アプリのFirebaseインスタンスを初期化します。

例

Androidプロジェクトのアプリケーションクラスの例を次に示します。アプリを起動すると同時に、Firebaseインスタンスが初期化されていることが確認できます。

実装テスト

Adjustは、Adjustの本番環境で最後のアクティビティがあったデバイスからのAndroidアプリのアンインストールを確認します。

アンインストールと再インストールの計測をテストするには、デバッグビルドまたはリリースビルドのいずれかを使用してください。主な要件として、テストインストールを実行する際は、Adjust SDK環境を 本番用 に設定する必要があります。

アンインストール計測をテストする方法：

  1. Adjust SDKで、Adjust SDKを初期化する前に環境をAdjustConfig.ENVIRONMENT_PRODUCTIONに設定します。

  2. 実機テスト用のデバイスまたはエミュレーターにアプリをインストールします。

  3. アプリを開きます。

  4. Adjustのテストコンソール（Testing Console）を開きます。

  5. デバイスID を入力し、 デバイスデータを表示（View device data） を選択します。

  6. アプリ情報（App information） セクションで以下を実行します。

    • インストールの状態（Install state） が インストール済み（Installed） と表示されていることを確認します。
    • Pushトークン の値が確認できます。

  7. アプリをアンインストールします。

  8. Adjustは1日1回アンインストールを確認するため、24時間後に再度テストコンソールを確認してください。 アプリ情報 (App information) セクションの インストールの状態（Install state） に アンインストール済み（Uninstalled） と表示されます。

状態が インストール済み (Installed） から アンインストール済み（Uninstalled） に変更されることで、アンインストールと再インストール計測機能が正しく機能するようになります。 再インストール計測もテストする場合は、次の手順に従ってください。

  1. 実際のテストデバイスまたはエミュレーターにデバッグビルドまたはリリースビルドを再インストールします。
  2. アプリを開きます。
  3. Adjustは1日に1回再インストールを確認するため、24時間後に再度テストコンソールを確認してください。 アプリ情報 (App information) セクションの インストールの状態（Install state） に 再インストール済み（Reinstalled） と表示されます。

トラブルシューティング

アンインストール・再インストール計測をテストする際によくある問題は、以下のとおりです。

  • テストインストールが行われると、Adjust SDK環境はAdjustConfig.ENVIRONMENT_SANDBOXに設定されます。アンインストール・再インストール計測はこの設定では機能しません。Adjust SDKでの設定は、必ずAdjustConfig.ENVIRONMENT_PRODUCTIONに変更してください。
  • The push token is missing. If the push token doesn’t appear in the Testing Console, there might be something wrong with your Firebase implementation or with the code that integrates the Firebase SDK and the Adjust SDK. Review these elements of your implementation.
  • FCM HTTP v1 APIプライベートキーに問題があります。例えば、生成したプライベートキーが誤ったプロジェクトに属しているか、 Adjust suiteに詳細が誤って入力された可能性があります。担当のテクニカルアカウントマネージャーまたはsupport@adjust.comにご連絡いただき、デバイスのPushトークンをお知らせください。担当者がログを取得して、AppleのAPIからのレスポンスを確認します。

問題が解決したら、次の手順に従って実装を再度テストしてください。

  1. アプリをアンインストールします。
  2. テストコンソールで デバイスID を入力し、 デバイスデータの表示（View device data） > デバイス削除（Forget Device） を選択します。
  3. 連携をテストするのセクションの手順を繰り返します。