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