ドキュメント

Unity Monetization

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 の使用を開始するには、以下の設定タスクを実行します。
  1. 前提条件
  2. 組織の作成
  3. サービスアカウントの作成
  4. APIキーの生成
  5. Ads 統合プラットフォームのパブリック API の実装
1

Prerequisites

Ads 統合プラットフォームのパブリック API の使用を開始する前に、チームの誰かが Unity ダッシュボードで以下の Organization ロールを持っていることを確認します。

Dashboard

必須ロール

収益化Owner
ユーザー獲得Manager
2

Create an organization

Ads 統合プラットフォームの public API でエンドポイントを管理する組織を作成します。
組織を設定するには組織の作成を、組織の作成後に管理や更新を行うには他の組織の記事を参照してください。
3

Create a service account

New Unity Dashboardからサービス アカウントを作成し、API呼び出しを認証します。

Advertisers

ユーザー Acquisition (ユーザー獲得) ダッシュボードからサービスアカウントを作成し、広告主固有のロールを追加するには、以下の手順を実行します。
  1. ユーザー Acquisition (ユーザー獲得) ダッシュボード > Settings > Organization > Manage organization > Service accounts > + New の順に移動します。
  2. + manage organization roles を選択します。
  3. サービスアカウント名とサービスアカウントの説明を入力します。
  4. 作成した新しいサービス アカウント ページで、Organization rolesセクション>+ Manage organization rolesに移動します。 5.Organization roles (組織ロール) ダイアログから、ユーザー Acquisition (ユーザー獲得) ドロップドロップダウンに移動し、サービスアカウントに追加するAdvertise API ロールをリストですべて選択します。

Publishers

Monetization (収益化) ダッシュボードからサービスアカウントを作成し、パブリッシャー固有のロールを追加するには、以下の手順を実行します。
  1. Monetization ダッシュボード > Settings > Organization > Manage organization > Service accounts > + New の順に移動します。
  2. + manage organization roles を選択します。
  3. サービスアカウント名とサービスアカウントの説明を入力します。
  4. 作成した新しいサービスアカウントページから、Organization roles セクション > + Manage organization roles に移動します。 5.組織の役割ダイアログから、「Monetization」ドロップダウンに移動し、以下のパブリッシャーAPI役割を選択してサービスアカウントに追加します。
  • 広告パブリッシャー自動化
  • 広告パブリッシャーテストデバイスの自動化
4

Generate your API key

Unity Dashboard からリクエストを認証するための API キーを作成するには、新しいサービスアカウントから以下の手順を実行します。
  1. サービスアカウントの「Keys」セクションに移動します。
  2. 「+ キー追加」を選択してAPIキーを作成します。
重要
ダッシュボードには秘密鍵が 1 回だけ表示されるため、キー ID と秘密鍵は後でのリファレンスのために一緒に安全に保管してください。キー値が失われた場合は、新しいキーを作成する必要があります。
  1. Done を選択します。
5

Implement the Ads Unified Platform public API

以下の API リファレンスを参照してインテグレーションをビルドします。