Androidアプリのサブスクリプション設定
AdjustがGoogleと通信するには、一連のサービス認証情報を提供する必要があります。この記事では、Google CloudプロジェクトをPlay Consoleにリンクし、サービスアカウントを使用してプロジェクトを承認する方法を説明します。
- Google Playアカウントで、Androidの開発者向けリアルタイム通知を設定。サーバー通知を設定すると、Google Play ストアはアプリのサブスクリプションの更新をAdjustに通知します。これにより、Adjustはサブスクリプションイベントを指定したタイミングでトリガーできます。
- GoogleサービスアカウントのJSON公開鍵を作成。GoogleサービスアカウントをAdjustに連携するためには、JSONキーが必要です。
- サービスアカウントにファイナンス情報へのアクセス権限を付与。
- GoogleサービスアカウントをAdjustに連携。
事前準備
はじめに、以下の設定手順をご覧ください。
サブスクリプションは、Adjustグロースソリューションに含まれています。この機能をパッケージへ追加する方法については、Adjustの担当者またはsales@adjust.comまでお問い合わせください。
要件
- Google Play Consoleでの
Account owner
権限 - Google Cloud Consoleでトピック、サブスクリプションを作成し、役割を割り当てるための権限
- Googleサービスアカウントの認証情報をAdjustに連携するための、Adjustの管理者、編集者またはカスタム編集者権限
開発者向けリアルタイム通知の設定
Pushサブスクリプションを作成する
プロジェクトを選択します。
トピックを作成(Create topic) を選択します。
トピックID(Topic ID) を入力し、 作成(Create) を選択します。
次に、左側のナビゲーションで、Pub/Subの下にある サブスクリプション(Subscriptions) を選択します。
サブスクリプションを作成(Create subscription) を選択します。
サブスクリプション ID(Subscription ID) を入力します。
Cloud Pub/Subトピックを選択(Select a Cloud Pub/Sub topic) リストで、ステップ4で作成したトピックを選択します。
配信タイプ(Delivery type) で、 Push を選択します。
エンドポイント(Endpoint)のURL フィールドに
https://subscription.adjust.com/v3/playstore
と入力します。Retry policy で、 Retry after exponential backoff delay を選択し、次を入力します:
- 最小バックオフ時間 - 10
- 最大バックオフ時間 - 600
作成(Create) を選択します。
サブスクリプションにプリンシパルを追加する
- 作成したサブスクリプションを選択し、 プリンシパルの追加(Add Principal) を選択します。
- 新しいプリンシパル(New principals) フィールドに
google-play-developer-notifications@system.gserviceaccount.com
と入力します。 - ロールを選択(Assign roles) リストで、 Pub/Sub Publisher を選択します。
- 保存(Save) を選択します。
トピック名の値をコピーする
- Google Cloudコンソールでトピック(Topics)を開きます。
- Push通知のサブスクリプションの作成時に追加したトピックを選択し、トピック名の値をコピーします。
- トピック名がフルで表示されていない場合は、 (下矢印アイコン)をクリックします。次に、 (コピーアイコン)をクリックしてトピック名の値をコピーします。
この値は次のステップで必要になります。
アプリに対して開発者向けリアルタイム通知を有効化する
- Google Play Consoleを開きます。
- アプリを選択します。
- Monetize で、 Monetization setup を選択します。
- Google Play Billing のセクションに下スクロールします。
- Manage notifications で、 Enable real-time notifications を選択します。
- トピック名(Topic name) フィールドに、前のステップでコピーしたトピック名を貼り付けます。
- 変更を保存(Save changes) を選択します。
サブスクリプションを設定したい全てのアプリに対して、ステップ2〜7を繰り返します。
JSON公開鍵の作成
Google Play Android Developer APIを有効化する
- Google Play Consoleを開きます。
- 既存のプロジェクトを選択するか、新しいプロジェクトを作成します。
- APIとサービス(APIs & Services) > APIとサービスの有効化(Enabled APIs and services) を開きます。
- + APIとサービスを有効にする (Enable APIs and Services) を 選択します。
- Google Play Android Developer API を検索して選択し、 有効にする(Enable) を選択します。
- 認証情報の作成 (Create credentials) を選択します。
- Which API are you using? で、 Google Play Android Developer API を選択します。
- What data will you be accessing? で、 Application data > Next の順に選択します。
認証情報がGoogle Play Developer APIで正常に機能するようになるまでに、最長36時間かかる場合があります。
サービスアカウントを作成する
サービスアカウントを作成するには、以下の手順に従ってください。
Google Cloud Consoleを開きます。
前のステップで選択したものと同じプロジェクトを選択します。
IAM & Admin > サービスアカウント(Service Accounts) を開きます。
サービスアカウントの作成(Create Service Account) を選択します。
サービスアカウントの詳細(Service account details) で、サービスアカウントの名前を入力します。
- これにより、 サービスアカウントID(Service account ID) フィールドが自動的に入力されます。これはサービスアカウントのメールアドレスです。
Create and Continue を選択します。
Grant this service account access to project (optional) で、次の権限を選択し、 Continue を選択します。
- Service Account Key Admin - サービスアカウントキーの作成と管理が可能になります。
- Pub/Sub Admin - プラットフォームサーバーの通知の有効化が可能になります。
- Monitoring Viewer - 通知キューのモニタリングが可能になります。
Done を選択して、 Service accountsのページに戻ります。
公開鍵の認証情報を生成する
公開鍵の認証情報を生成するには、以下の手順に従ってください。
- Google Cloud Consoleを開きます。
- 前のステップで選択したものと同じプロジェクトを選択します。
- IAM & Admin > サービスアカウント(Service Accounts) を開きます。
- 作成したサービスアカウントで、 Actions の下にある Manage keys を選択します。
- 鍵を追加(Add Key) > 新しい鍵を作成(Create new key) を選択します。
- Key type に JSON を選択し、 Create を選択します。
- JSONファイルのダウンロードが始まります。これには、AdjustとGoogle間の通信に必要な認証情報が含まれています。GoogleサービスアカウントをAdjustに連携するには、このJSONファイルが必要です。
ファイナンス情報へのアクセスを許可する
サービスアカウントにファイナンス情報へのアクセス権限を付与するには、以下の手順に従ってください。
Google Cloud Consoleにて
- Google Cloud Consoleで、前のステップで選択したものと同じプロジェクトを選択します。
- IAM & Admin > サービスアカウント(Service Accounts) を開きます。
- 作成したサービスアカウントで、 Email の値をコピーします。
- 次のステップでこのメールアドレスが必要になります。
Google Play Consoleにて
Google Play Consoleを開きます。
Users and permissions > Invite new users を選択します。
前のステップで取得したサービスアカウントのメールアドレスを入力します。
App permissions で、アプリを追加します。
Account permissions で、以下の権限を選択します:
- アプリ情報の閲覧(読み取り専用)
- 財務情報の閲覧
- オーダーとサブスクリプションの管理
Invite user を選択し、 Send invite を選択します。
これらのオプションが利用できない場合、必要なアカウント権限がない可能性があります。アカウントオーナーまたは管理者にお問い合わせください。
GoogleサービスアカウントをAdjustに連携する
AdjustでGoogleサービスアカウントの認証情報を追加するには、以下の手順に従ってください。
- DataWorks で パートナー接続(Connections) を選択します。
- + 新規パートナー接続(+ New Connection) を選択します。
- パートナー(Partner) で、 Google Service Account を選択します。
- サービス(Service) で、 サブスクリプション(Subscription) を選択します。
- 認証情報ファイル(Credentials file) フィールドに、公開鍵の認証情報の生成ステップでダウンロードしたJSONファイルをアップロードします。
- 接続(Connect) を選択します。
➡️ 次のステップ:Adjustでアプリのサブスクリプションを有効化。