Ads 統合プラットフォームのパブリック API の使用の準備
組織、サービスアカウント、API キーを設定して、Ads 統合プラットフォームの public API を使用してアプリケーション、プレースメント、キャンペーンの管理をプログラミングで開始します。
読み終わるまでの所要時間 9 分最終更新 3日前
Ads 統合プラットフォームのパブリック API は、Unity Monetization および Unity ユーザー獲得ダッシュボード用の Manage API (古い機能) の最新バージョンです。
すでに Unity Monetization または ユーザー獲得ダッシュボード で Manage API (古い機能) を使用している場合は、代わりに Ads 統合プラットフォーム public API を使用して新しい Unity Dashboard に移行する を参照してください。
Unity Dashboard でアプリケーション、プレースメント、キャンペーンを直接管理できますが、Ads 統合プラットフォームの public API を使用すると、エンドポイントをプログラムで管理できるようになります。以下の表に、API で管理できるエンドポイントを示します。
ダッシュボード | マネージエンドポイント | Benefits |
|---|---|---|
| 収益化 |
| プレースメントの作成と更新は、一度に 1 つではなく、一括で行われます。 これらのエンドポイントは、定期的に新しいアプリを起動したり、プレースメントを追加したり、さまざまな広告フォーマットのテストデバイスを調整したりする場合に便利です。 |
| ユーザー獲得 |
| ダッシュボードボードで一度に 1 つずつ変更するのではなく、変更を自動化します。 これらのエンドポイントは、多数のキャンペーンを管理したり、頻繁に更新する必要がある場合に便利です。 |
Ads 統合プラットフォームのパブリック API の使用を開始するには、以下の設定タスクを実行します。
- 前提条件
- 組織の作成
- サービスアカウントの作成
- APIキーの生成
- Ads 統合プラットフォームのパブリック API の実装
Prerequisites
Ads 統合プラットフォームのパブリック API の使用を開始する前に、チームの誰かが Unity ダッシュボードで以下の Organization ロールを持っていることを確認します。
Dashboard | 必須ロール |
|---|---|
| 収益化 | Owner |
| ユーザー獲得 | Manager |
Create an organization
Create a service account
New Unity Dashboardからサービス アカウントを作成し、API呼び出しを認証します。
Advertisers
ユーザー Acquisition (ユーザー獲得) ダッシュボードからサービスアカウントを作成し、広告主固有のロールを追加するには、以下の手順を実行します。
- ユーザー Acquisition (ユーザー獲得) ダッシュボード > Settings > Organization > Manage organization > Service accounts > + New の順に移動します。
- + manage organization roles を選択します。
- サービスアカウント名とサービスアカウントの説明を入力します。
- 作成した新しいサービス アカウント ページで、Organization rolesセクション>+ Manage organization rolesに移動します。 5.Organization roles (組織ロール) ダイアログから、ユーザー Acquisition (ユーザー獲得) ドロップドロップダウンに移動し、サービスアカウントに追加するAdvertise API ロールをリストですべて選択します。
Publishers
Monetization (収益化) ダッシュボードからサービスアカウントを作成し、パブリッシャー固有のロールを追加するには、以下の手順を実行します。
- Monetization ダッシュボード > Settings > Organization > Manage organization > Service accounts > + New の順に移動します。
- + manage organization roles を選択します。
- サービスアカウント名とサービスアカウントの説明を入力します。
- 作成した新しいサービスアカウントページから、Organization roles セクション > + Manage organization roles に移動します。 5.組織の役割ダイアログから、「Monetization」ドロップダウンに移動し、以下のパブリッシャーAPI役割を選択してサービスアカウントに追加します。
- 広告パブリッシャー自動化
- 広告パブリッシャーテストデバイスの自動化
Generate your API key
Unity Dashboard からリクエストを認証するための API キーを作成するには、新しいサービスアカウントから以下の手順を実行します。
- サービスアカウントの「Keys」セクションに移動します。
- 「+ キー追加」を選択してAPIキーを作成します。
- Done を選択します。
Implement the Ads Unified Platform public API
以下の API リファレンスを参照してインテグレーションをビルドします。