第三者は、独自のアド マネージャー ネットワークがないという点で、アド マネージャーの直接のユーザーではありません。代わりに、アド マネージャーを使用するクライアントのために、アド マネージャーを対象としたサービスや統合を構築しています。このガイドでは、サードパーティ統合の基本について、ベスト プラクティス、ヒント、アドバイスを紹介します。
このガイドは、Ad Manager API の実務知識をお持ちであることを前提とした内容です。Ad Manager API を使い慣れていない方は、スタートガイドをご覧ください。
サードパーティとして利用を開始する
Ad Manager API を使用してアド マネージャー顧客のネットワークにアクセスするには、以下のガイドラインに従ってください。なお、Google から別途承認を得る必要はありませんが、Ad Manager API にアクセスしたり、Ad Manager API を使用したりすることにより、お客様は Ad Manager API の利用規約に同意したことになります。
第三者としてアド マネージャーの統合をテストする方法
第三者として、クライアントの本番環境ネットワークに対して実行する前に、アド マネージャーとの統合をテストするにはどうすればよいかと疑問に思われるかもしれません。テスト ネットワークを作成することをおすすめします。アド マネージャーのユーザーである必要はありません。Google アカウントがあれば誰でもテスト ネットワークを作成できます。
ただし、テスト ネットワークと本番環境ネットワークの違いに注意してください。テスト ネットワークでは広告を配信できません。また、クライアントが本番環境ネットワークで使用できるすべての機能がテスト ネットワークに含まれているとは限りません。テスト ネットワークで使用できないアド マネージャーの機能をテストする必要がある場合は、アド マネージャーの販売パートナー経由でテスト以外のネットワークへのアクセスを購入できます。
また、アプリケーションを正しく動作させるために本番環境ネットワークで使用できる必要があることを、クライアントに明確に伝える必要があります。アプリは、例外をキャッチして適切に失敗するか、クライアントとクライアントそれぞれにある機能または存在しない機能のリストを保持することで、機能が存在しないようなケースに対処する必要があります。クライアントは Google の担当者と連携して、ネットワーク上の機能を管理する必要があります。
認証: クライアントのアド マネージャー ネットワークに正しくアクセスする方法
アプリケーションからクライアントのアド マネージャー ネットワークにアクセスするには、安全な方法で認証ワークフローを設定する必要があります。
このリンク作業は次の手順で行います。
- クライアントのネットワークへのアクセスに使用する Google アカウントのメールアドレスを作成します。
- このアカウントをユーザーとしてアド マネージャー ネットワークに追加するよう、クライアントに依頼してください。
ステップ 1 では、クライアントごとに個別の Google アカウントを作成するか、すべてのクライアントに使用するメインの Google アカウントを作成します。前者の方が、いずれかのアカウントが不正使用された場合に安全性が高くなります。後者の場合は、ステップ 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 がいつリリースされているかについて、最新の情報を得ることが重要です。バージョンが廃止され、クライアントが停止するリスクを冒しているのは望ましくありません。Google は、お客様のサポートと同様に、今後のサポート終了や廃止について、必ずしもサードパーティに連絡できるとは限りません。したがって、API の更新に関する次の 3 つの主要チャンネルのいずれかに登録し、通知設定を調整する責任はお客様にあります。
デベロッパー サイトでもサポート終了スケジュールを公開していますので、定期的に確認することをおすすめします。
サポートの利用
アド マネージャーの統合で問題が発生した場合は、問題に応じて次のサポート チャネルをご利用いただけます。サービスに関してご不明な点はアド マネージャー プロダクト フォーラムでお尋ねください。API についてご不明な点がありましたら Ad Manager API フォーラムに質問を投稿してください。プロダクト レベルの質問と API 固有の質問を区別するためのヒントについては、こちらのブログ投稿をご覧ください。