第三者はアド マネージャーの直接のユーザーではありません。つまり、独自の Ad Manager ネットワークを持っていない可能性があります。代わりに、アド マネージャーの顧客であるクライアント向けに、アド マネージャーとのサービスや統合を作成します。このガイドでは、ベスト プラクティス、ヒント、コツを紹介しながら、サードパーティ統合の基本について説明します。
このガイドは、Ad Manager API に関する実践的な知識があることを前提としています。Ad Manager API を初めてご利用になる場合は、スタートガイドをご覧ください。
サードパーティとしてのスタートガイド
アド マネージャー API を使用してアド マネージャーの顧客のネットワークにアクセスするには、以下のガイドラインに沿って操作してください。Google からの追加の承認は必要ありません。ただし、アド マネージャー API にアクセスまたは使用することで、アド マネージャー API の利用規約に同意したことになります。
サードパーティとしてアド マネージャーの統合をテストする方法
第三者として、クライアントの本番環境ネットワークで実行する前に、アド マネージャーの統合をテストする方法について疑問に思われるかもしれません。推奨される方法は、テスト ネットワークを作成することです。この操作を行うためにアド マネージャーのユーザーである必要はありません。Google アカウントをお持ちであれば、どなたでもテスト ネットワークを作成できます。
ただし、テスト ネットワークと本番環境ネットワークの違いに注意してください。テスト ネットワークでは広告を配信できません。テスト ネットワークには、クライアントが本番環境ネットワークで利用できるすべての機能が含まれているとは限りません。テスト ネットワークで利用できないアド マネージャーの機能に対してテストを行う必要がある場合は、アド マネージャーの再販業者を通じてテスト以外のネットワークへのアクセスを購入する方法があります。
また、アプリケーションが適切に動作するために、本番環境ネットワークで利用可能にする必要がある機能について、クライアントに明確に伝える必要があります。アプリケーションでは、例外をキャッチして正常に失敗するか、クライアントのリストと各クライアントが持つ機能と持たない機能のリストを保持することで、機能が存在しない可能性のあるケースを処理する必要があります。ネットワークの機能を管理する責任は、Google の担当者と連携するクライアントにあります。
認証: クライアントのアド マネージャー ネットワークに適切にアクセスする方法
アプリケーションがクライアントのアド マネージャー ネットワークにアクセスするには、認証ワークフローを安全に設定する必要があります。
このリンク作業は次の手順で行います。
- クライアントのネットワークへのアクセスに使用する Google アカウントのメールアドレスを作成します。
- クライアントに、このアカウントをアド マネージャー ネットワークのユーザーとして追加してもらいます。
ステップ 1 では、クライアントごとに個別の Google アカウントを作成するか、すべてのクライアントで使用するメインの Google アカウントを作成します。アカウントの 1 つが不正使用された場合、後者のオプションの方が安全です。後者の場合は、ステップ 1 を 1 回だけ行えばよいことになります。
ステップ 1 でどのような方法をとる場合でも、ステップ 2 では、新しいクライアントに、クライアント用に作成した適切な Google アカウントをユーザーとしてアド マネージャー ネットワークに追加するよう依頼する必要があります。
1. Google アカウントを作成する
アド マネージャー ネットワークに追加できる Google アカウントを作成する方法はいくつかあります。
オプション 1: OAuth2 サービス アカウントを作成します。これにより、Google アカウントとして機能するサービス アカウントのメールアドレスが生成されます。新しいサービス アカウントを作成する手順。
オプション 2: 新規ユーザーとして登録することで、通常の Google アカウント（「Gmail」アカウント）を作成できます。Google アカウントをすでにお持ちの場合は、シークレット ウィンドウまたは新しいブラウザ セッションで登録を完了します。また、会社で Google Workspace を使用している場合は、会社のドメインで Google アカウントを作成して、そのアカウントを使用することもできます。このガイドでは、これら両方を「通常の」Google アカウントと呼びます。
2. クライアントに Google アカウントをネットワークに追加するよう依頼する
クライアントのネットワークにアクセスするための Google アカウントを取得したら、クライアントにアド マネージャー ネットワークに新しいユーザーとしてアカウントを追加するよう依頼します。
OAuth2 サービス アカウントのメールアドレスを提供している場合は、ネットワークに追加してもらいます。
通常の Google アカウントを提供している場合は、ネットワークのユーザーとしてアカウントを追加するよう依頼してください。
どの方法を選択する場合でも、クライアントのネットワークで必要なデータにアプリケーションがアクセスできるように、アカウントに付与するロールと権限についてクライアントと話し合ってください。
これで、クライアントのアド マネージャー ネットワークに対して API 呼び出しを開始できます。networkCode SOAP ヘッダーは、API 呼び出しの対象となるクライアントのネットワーク コードに設定してください。すべてのクライアント ライブラリで、この設定をプログラムで行うことができます。たとえば、広告の Java クライアント ライブラリでは、DfpSession インスタンスのビルド時にネットワーク コードをプログラムで設定できます。
API の最新情報を入手する
非推奨または廃止された API バージョンと、新しいバージョンがリリースされる時期を常に把握しておくことが重要です。バージョンのサポート終了時にクライアントが破損するリスクを回避するためです。お客様の場合と同様に、廃止やサポート終了が迫っていることを第三者に通知できるとは限りません。そのため、API の更新情報を受け取るには、3 つのメインチャネルのいずれかに登録し、通知設定を調整する必要があります。
また、デベロッパー サイトで非推奨のスケジュールも提供しています。こちらも定期的にご確認ください。