アンドロイドのアンインストール追跡の設定

フォローする
Avatar
Jivitha Masilamani
Updated
ドキュメント

Android のアンインストールトラッキングは、Firebase Cloud Messaging サービスを利用しています。Firebaseは2024年7月22日にレガシーHTTP APIを廃止します。レガシー HTTP API を使用している場合は、Singular アプリの設定ページからHTTP V1 API を使用するようにアップデートしてください。詳しくはこちら。

Singularでは、マーケティングキャンペーンで獲得したトラフィックの質を測定するもう一つの方法として、アプリのアンインストールを追跡するオプションを提供しています。この機能はSingular Android SDKバージョン7.x+で利用可能で、有効にするにはアプリのアップデートが必要です。

注意事項

  • SingularのアンインストールトラッキングはGoogleのサービスを利用していますが、Googleとは異なる方法を使用しています。Google は、デバイス上のオペレーティングシステムから直接アンインストールを報告します。そのため、Google が報告する数値と Singular が報告する数値が異なる場合があります。
  • アンインストールは Singular のイベントとして追跡され、その結果、元のインストールまたはリエンゲージメントソースからアトリビューションリンクが削除されません。ユーザーがアプリを生涯に複数回アンインストールする可能性があるため、この結果、アンインストール率が 100% を超える場合があります。

Google組織でドメイン制限共有が有効になっている場合は、単一組織IDを許可値に適用します：

ドメイン制限付き共有ポリシーの変更
  1. 組織ポリシーへのアクセス
  2. Google Cloud Console で、組織ポリシーページに移動します。
  3. ポリシーを設定する組織リソースを選択します。
  4. リストからドメイン制限共有制約を検索して選択します。
  5. ポリシーの管理] をクリックします。

許可された値に組織 ID を追加する

  1. ポリシーの値]で[カスタム]を選択します。
  2. 組織リソースIDを形式で入力します：
    is:principalSet://iam.googleapis.com/organizations/626787461583

設定手順

HTTP V1 API
  1. Android SDK 7.x+ を統合してください：アンインストールトラッキングは、Android SDK バージョン 7.x 以上で利用可能です。SDK のアップグレード方法については、Android SDK 統合ガイドを参照してください。
  2. AndroidManifest.xml を変更します：Android SDK アンインストール追跡ガイドの詳細を参照してください。
  3. Singular Apps] ページ>[App] > [Advanced Settings] > [Uninstall Tracking] で、プロジェクト ID を入力します。


    プロジェクト ID を作成および設定するには

    1. Firebase Cloud Messenger Consoleにアクセスします。
    2. プロジェクトを選択または新規作成します。
    3. Project Overview>Project Settings に移動し、Project ID を コピーします。 このプロジェクト IDは、この後のステップでプロジェクトに適切なロールとパーミッションが付与された後、Singular apps ページで入力する必要があります。
    4. Cloud Messagingに 移動し、Firebase Cloud Messaging API (V1)を有効にして、プロジェクトのFCMクラウドメッセージングを有効にします。
    5. Service Accounts > Manage service account permissionsに移動します。
    6. 正しいプロジェクトの役割と権限を割り当てます。
      1. 左のナビゲーションメニューからRolesを 選択します。
      2. ロールの作成] をクリックし、次の情報を入力します。
        タイトルシンギュラーアンインストールトラッキング
        ID:singular_uninstalls
        ロールの起動段階一般公開
      3. Add Permissions を クリックし、cloudmessaging.messages.create を 追加します。これは Firebase Cloud Messaging API Admin の Filtering ですぐに見つかります。
        permissions.png
      4. Createをクリックしてロールの作成を完了します。

    7. ロールに Singular を割り当てる

      1. 左のナビゲーションメニューでIAMを選択します。
      2. Permissionsタブで、Grant Access

        iam_grant.png

        をクリックします。
      3. Add principals（プリンシパルの追加 ）> New principals（新規プリンシパル）で、

        singular-uninstall-tracking@singular-uninstall-tracking.iam.gserviceaccount.com

        add_principal.png

        と入力します。
      4. ロールの割り当てで、前のステップで作成した"Singular Uninstall Tracking "を選択する。

        roles.png

        最終的な構成が一致する必要があります：


      5. Save

        をクリックします。
(レガシー）HTTP API

Androidでアンインストールトラッキングを設定するには

  1. Android SDK 7.x+をインストールしてください：アンインストールトラッキングは、Android SDK バージョン 7.x 以上で利用可能です。SDK のアップグレード方法については、Android SDK 統合ガイドを参照してください。
  2. AndroidManifest.xml を変更します：Android SDK アンインストール追跡ガイドの詳細を参照してください。
  3. 送信者IDとサーバーキーを追加します：アンインストール追跡を有効にするには、SingularにGoogleプロジェクト番号とサーバーキーが必要です。これらの値を取得するには
    • FirebaseでGo to Consoleを選択し、プロジェクトを選択します。

    • 歯車のアイコンを選択し、プロジェクト設定 > クラウドメッセージングに進みます。

      Screen_Shot_2017-12-27_at_4.48.09_PM.png

    • Singular アカウントで、[Settings] (設定) > [Apps] (アプリ) を選択し、アンインストールを追跡したいアプリを見つけて、[Edit] (編集) を選択します。

    • アンインストールトラッキングの下に、プロジェクト番号（Firebaseの送信者ID ）とサーバーキーを追加します。

      Screen_Shot_2017-12-27_at_4.56.56_PM.png

  4. 以下のようにアプリで FCM を設定します：

    1. Firebase コンソールで、Firebase プロジェクトを作成します。
    2. プロジェクトダッシュボードで、Add Firebase to your Android Appを選択します。

    3. AndroidアプリのパッケージIDを入力します。

      Screen_Shot_2017-12-27_at_4.55.41_PM.png

    4. 設定ファイル（google-services.json）をダウンロードし、Androidプロジェクトのappモジュールにコピーします。
    5. プロジェクトレベルのbuild.gradleファイル（><project>/build.gradle>）に、以下を追加する：
      buildscript {
         dependencies {
           // Add this line or latest version 
           classpath 'com.google.gms:google-services:3.1.0'
         }
       }
    6. アプリレベルのbuild.gradleファイル（><project>/<app-module>/build.gradle>）に、以下を追加する：
      // Add to the bottom of the file
      apply plugin: 'com.google.gms.google-services'
    7. プロジェクトを同期します。
    8. Androidのコードで、以下のサービスを作成します：
      public class FCMService extends FirebaseInstanceIdService {
          @Override
          public void onTokenRefresh() {
              super.onTokenRefresh();
              //now we will have the token                   
              String token = FirebaseInstanceId.getInstance().getToken();
          }
      }
      onTokenRefreshメソッドは、通知を送信するために必要なFCMトークンを取得します。
    9. このサービスをAndroidマニフェストファイルに追加します：
      <service android:name=".FCMService">
       <intent-filter>
       <action android:name="com.google.firebase.INSTANCE_ID_EVENT"/
       </intent-filter>
      </service>

これで、Singular は更新されたバージョンのアプリケーションを持っているユーザーのアンインストールを追跡します。

通知のテスト

FCMトークンを提供することで、コンソールを使って通知をテストできます：

Screen_Shot_2017-12-27_at_4.56.12_PM.png