# Ads 統合プラットフォームのパブリック API の使用の準備

> 組織、サービスアカウント、API キーを設定して、Ads 統合プラットフォームのパブリック API を使用して、アプリケーション、プレースメント、キャンペーンの管理をプログラミングで開始します。

Ads 統合プラットフォームのパブリック API は、Unity の収益化ダッシュボードと Unity ユーザー獲得ダッシュボード用の Manage API（古い機能）の最新バージョンです。

すでに Unity の収益化ダッシュボードまたはユーザー獲得ダッシュボードで Manage API (古い機能) を使用している場合は、代わりに Ads 統合プラットフォームのパブリック API を使用して新しい Unity Dashboard [に移行](/monetization/performance-and-analytics/api/manage-api/migrate-to-the-new-dashboard-manage-api.md)する を参照してください。

アプリケーション、プレースメント、キャンペーンは Unity のダッシュボードで直接管理できますが、Ads 統合プラットフォームのパブリック API では代わりにエンドポイントをプログラムで管理できます。以下の表に、API で管理できるエンドポイントを示します。

| **ダッシュボード** | **マネージエンドポイント**                                               | **Benefits**                                                                                                          |
| ----------- | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| 収益化         | * アプリ
* プレースメント
* テストデバイス                                     | プレースメントの作成と更新は、一度に 1 つではなく、一括で行われます。これらのエンドポイントは、定期的に新しいアプリを起動したり、プレースメントを追加したり、さまざまな広告フォーマットのテストデバイスを調整したりする場合に便利です。 |
| ユーザー獲得      | - アプリ
- アトリビューション
- キャンペーン
- キャンペーンの管理
- クリエイティブパック
- クリエイティブ | ダッシュボードボードで一度に 1 つずつ変更するのではなく、変更を自動化します。これらのエンドポイントは、多数のキャンペーンを管理したり、頻繁に更新する必要がある場合に便利です。                             |

Ads 統合プラットフォームのパブリック API の使用を開始するには、以下の設定タスクを実行します。

1. 前提条件
2. 組織の作成
3. サービスアカウントの作成
4. APIキーの生成
5. Ads 統合プラットフォームのパブリック API の実装

1) **Prerequisites**

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

   | **Dashboard** | **必須ロール** |
   | ------------- | --------- |
   | 収益化           | Owner     |
   | ユーザー獲得        | Manager   |

2) **Create an organization**

   Ads 統合プラットフォームのパブリック API でエンドポイントを管理する組織を作成します。

   組織を設定するには[組織の作成](/cloud/organizations/create-organization.md)を、組織の作成後に管理や更新を行うには他の[組織](/cloud/organizations.md)の記事を参照してください。

3) **Create a service account**

   [New Unity Dashboard](https://cloud.unity.com/)からサービス アカウントを作成し、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(組織の役割)」ダイアログから、「**Grow**」ドロップダウンに移動し、サービスアカウントに追加するリスト内のすべての広告APIロールを選択します。

   ### Publishers

   収益化ダッシュボードからサービスアカウントを作成し、パブリッシャー固有のロールを追加するには、以下の手順を実行します。

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

   * **広告パブリッシャー自動化**
   * **広告パブリッシャーテストデバイスの自動化**

4) **Generate your API key**

   Unity Dashboard からリクエストを認証するための API キーを作成するには、新しいサービスアカウントから以下の手順を実行します。

   1. サービスアカウントの「**Keys**」セクションに移動します。
   2. 「**+ キー追加**」を選択してAPIキーを作成します。

   > **Important:**
   >
   > ダッシュボードには秘密鍵が 1 回だけ表示されるため、キー ID と秘密鍵は後でのリファレンスのために一緒に安全に保管してください。キー値が失われた場合は、新しいキーを作成する必要があります。

   3. **Done** を選択します。

5) **Implement the Ads Unified Platform public API**

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

   * パブリッシャー:[Ads 統合プラットフォームパブリッシャー公開 API](/oas-unified-platform-publisher-public/1.0.0.md)
   * 広告主:[Ads 統合プラットフォーム広告主向け公開 API](/oas-unified-platform-advertiser-public/1.0.0.md)