アプリの購入認証の設定

購入認証を使用するには、アプリでAdjust SDKを正しく設定し、関連するストアからの購入を承認するために必要な情報をAdjustに提供する必要があります。

事前準備

グロースソリューション:

購入認証はグロースソリューションにご契約のお客様にご利用いただけます。パッケージを追加する方法については、Adjustの担当者またはsales@adjust.comまでお問い合わせください。

要件​

  • Adjustアカウントの管理者、編集者およびカスタムの編集者ユーザー権限
  • アプリストアの認証情報の作成および管理
    • Google Cloud：プロジェクトまたはサービスアカウントのService Account Key Adminアクセス権限
    • App Store Connect: Admin の権限

このモデルについて​

  • 購入認証は、Google PlayストアまたはApple App Storeを通じてアプリ内購入を行う場合にのみ使用できます。物理的な商品の購入には使用できません。
  • iOS、Android、Unityアプリで利用可能。

1. Adjust SDKの設定

Adjust購入認証をアプリケーションに実装するには、必要最小限のSDKバージョンがインストールされていることを確認し、購入収益イベントを送信するための実装手順を完了してください。

2. アプリストアの認証情報を確認

ストアでの購入を検証するには、お客様のアカウントを一致させるための認証情報をAdjustに提供していただく必要があります。

Android:​

認証パラメーター定義例
JSONキーGoogle Cloud ConsoleのサービスアカウントページからダウンロードしたJSONキーexample_key_file

iOS：​

認証パラメーター定義例
発行者ID（Issuer ID）App Store ConnectのIntegrationsタブに表示される発行者ID。57246542-96fe-1a63-e053-0824d011072a
キーID（Key ID）App Store ConnectのIntegrationsタブに表示されるプライベートキーID2X9R4HXF34
アプリ内購入API KeyApp Store ConnectからダウンロードしたP8 APIキー 。App StoreサーバーAPIからアプリデータへのアクセスを承認します。 -----BEGIN PRIVATE KEY-----
MIGTAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBHkwdwIBAQQgNxUqm0R2vt4IrLAQr9gfDPixwSxH9wJZ6NV3X0ax4eWgCgYIKoZIzj0DAQehasda2ANCAAQx53AlofI4Of54lbR04A6D2QMbe0mt8+JtRHkJJCEUesUfySoZsm2jeh3qodLE0pZ2Rayv26qFMKuKEwemB2Op
-----END PRIVATE KEY-----

ストアプラットフォームの手順に従って、必要な認証情報を見つけます。

Androidの場合

プロジェクトまたはサービスアカウントのサービスアカウントキーを作成するには、ユーザーアカウントに サービスアカウントキー管理者​ の権限が必要です。

Google Play Android Developer APIの有効化

  1. Google Play Consoleで、 APIとサービスAPI (APIs & Services）​ に移動します。
  2. + APIとサービスを有効にする (Enable APIs and Services) を​ 選択します。
  3. Mobileで、 Google Play Android Developer API​ を選択します。
  4. 有効化（Enable）​ を選択します。
  5. 必要なAPI認証情報を設定します。
    1. 有効化されたAPIとサービス（Enabled APIs & Services）​ 領域から、 Google Play Android Developer API Google Play Android Developer API​ を選択します。
    2. 認証情報の作成 (Create Credentials)​ を選択します。
    3. Select an APIで、 Google Play Android Developer API​ を選択します。
    4. What data will you be accessing?で、 アプリケーションデータ（Application data）​ を選択します。
    5. 「次」（Next）を選択します。

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

  1. Google Cloudで、サービスアカウントを作成（Create service account）に移動します。

  2. Google Cloudプロジェクトを選択します。

  3. サービスアカウント名を入力します。

    • サービスアカウントIDは自動的に生成されます。

  4. （オプション）サービスアカウントの説明を入力します。

  5. Create and Continue​ を選択します。

  6. サービスアカウントにプロジェクトへのアクセス権限を付与します。

    1. サービスアカウントに Pub/Sub管理者​ のロールを割り当てます。
    2. + 別のロールを追加（Add another role）​ を選択します。
    3. サービスアカウントに Monitoring Viewer​ の役割が割り当てられていること。
    4. Continue（続ける）​ を選択します。
    5. オプション：このサービスアカウントへのアクセス権をユーザーに付与します。
    6. 完了（DONE）​ を選択します。

新しいAPIキーを作成する

  1. Google Cloudで、 IAMと管理（IAM & Admin）​ に移動します。
  2. サービスアカウント（Service Accounts）​ を選択して、プロジェクトのサービスアカウントを表示します。
  3. 作成したサービスアカウントで、 アクション（Actions）​ （3つのドットアイコン）を選択します。
  4. Manage keys​ を選択します。
  5. 鍵を追加（Add Key） > 新しい鍵を作成（Create new key）​ を選択します。
  6. 鍵のタイプで、 JSON​ を選択します。
  7. プライベートキーが自動的にダウンロードされます。

iOSの場合

APIキーを作成および管理するには、App Store Connectの 管理者​ 権限が必要です。

発行者ID（Issuer ID）を入力する

  1. App Store Connectにて、 ユーザとアクセス（Users and Access）​ アイコンを選択します。
  2. 連携（Integrations）​ タブを選択します。
  3. 左側のKey Typeメニューで、 In-App Purchase​ を選択します。
  4. ページ上部の発行者ID（Issuer ID）の横にあるコピーを選択します。

新しいAPIキーを生成する

Adjustのアプリ内収益認証専用のAPIキーを生成することをお勧めします。

APIキーを生成（+ Generate API Key）を選択

1/4

  1. APIキーを生成（Generate API Key）​ または +​ アイコンを選択して、新しいキーを作成します。

    • App Store ConnectアカウントでAPIアクセスをまだリクエストしていない場合は、リクエストを完了してください。

  2. 名前（Name）​ フィールドに、キーの名前を入力します。

  3. 生成 (Generate)​ を選択します。

  4. 有効なキーのリストに新しいAPIキーがそのキーIDとともに表示されます。

  5. 生成したキーで、キーID 列の値にカーソルを合わせます。 表示される キーIDをコピー（Copy Key ID）​ を選択します。

  6. In-App Purchase Keyをダウンロード（Download In-App Purchase Key）​ を選択します。

  7. ダウンロード（Download）​ を選択して次に進みます。

  8. ダウンロードしたファイルからAPIキー全体をコピーします。

3. iOSの場合：AdjustをApp Store Connectに接続

AdjustダッシュボードでApp Store Connectの認証情報を追加するには、以下の手順に従ってください。

  1. Adjustで、 DataWorks > パートナー接続（Connections）​ に移動します。
  2. + 新規パートナー接続（+ New Connection）​ を選択します。
  3. リストから App Store Connect (In-App Purchase)​ を選択します。
  4. サービス (Services) で、 購入認証（Purchase Verification）​ を選択します。
  5. 発行者ID（Issuer ID）​ を入力します。
  6. キーID​ を入力します。
  7. .p8ファイルを開き、 テキストエディターでファイルを開き、プライベートキーの全体をコピーします。 これをプライベートキーのフィールドにペーストします。

4. アプリに購入認証を追加

次に、アプリに購入認証を適用します。

  1. Adjustで AppView​ に移動し、アプリを選択します。

  2. プロテクション（Protection）​ タブに移動します。

  3. 購入認証（Purchase Verfication）​ で、 編集（Edit）​ （）を選択します。

  4. 購入認証を ON​ に切り替えます。

  5. プラットフォーム固有の情報を入力します：

    • iOSアプリの場合：使用するApp Store Connectアカウントを選択する必要があります。
    • Androidアプリの場合：ダウンロードしたJSONキーファイルをアップロードします。

  6. 保存（Save）​ を選択します。

これで設定が完了しました。

認証された収益データをパートナーと共有する

Adjustの購入認証ソリューションにより、認証された収益データのみがパートナーと共有されます。これにより、安心してデータを共有し、キャンペーン最適化に活用できようになります。

Adjustダッシュボードでパートナーとのアプリ内収益共有をすでに設定している場合、変更を行う必要はありません。Adjustは、verified passedステータスの収益データのみを自動的に転送します。

新規パートナーを設定し、認証済みのアプリ内収益の共有を有効にするには、Campaign Labでアドネットワークを設定する手順に従ってください。データ共有オプションを選択するステップでは、 アプリ内収益​ を選択するようにしてください。

注意:

入力した認証情報が誤っていたり、二重エンコードやその他の設定に問題があると、イベントの認証が行われない場合があります。よって、設定が正しく行われていることをご確認ください。