パートナー リンクは、データ パートナーのアカウントにアクセスできる Google アカウントの認証情報を使用して、広告主のアカウントのオーディエンスやイベントをデータ パートナーが管理できるようにする仕組みです。パートナー リンクを使用すると、広告主のアカウントに直接アクセスできる Google アカウントの認証情報を要求する必要がなくなります。
Google 担当者と協力して、広告主が Google 広告、ディスプレイ＆ビデオ 360、Google アド マネージャーの UI からデータ
パートナー アカウントへのパートナー リンクを管理できるようにすることをおすすめします。データ パートナーは、データ パートナーアカウントへのリンクの管理が UI で利用できない場合や、アプリケーション内でパートナー リンク機能を提供したい場合にのみ、
PartnerLinkServiceを使用して
リンクを作成または削除する必要があります。
パートナー リンクのメリット
データ パートナーとして、パートナー リンクを使用して広告主アカウントを管理すると、直接アクセスする方法に比べていくつかのメリットがあります。
| パートナー リンク | 直接アクセス | |
|---|---|---|
| 認証情報の管理 |
広告主アカウントでパートナー リンクを作成すると、以降のリクエストでは、データ パートナー アカウントにアクセスできる Google アカウントの認証情報の単一のセットが使用されます。 広告主アカウントの認証情報は有効期間が短く、 パートナー リンクの作成に使用したら破棄できます。
|
広告主アカウントごとに個別の認証情報が必要です。 広告主アカウントの認証情報は有効期間が長く、 すべての広告主の認証情報を安全に保存し、広告主のオーディエンスやイベントを管理する際に、各広告主の特定の認証情報を安全に取得する必要があります。
|
| OAuth アプリケーションの検証 |
サービス アカウント の認証情報を使用してデータ パートナー アカウントにアクセスする場合、OAuth アプリケーションの検証は必要ありません。 ユーザー認証情報を使用してデータ パートナー アカウントにアクセスする場合は、データ パートナー アカウントにアクセスできるユーザーに未確認のアプリ画面が表示されないように、検証プロセスを完了することをおすすめします。詳しくは、検証を行うタイミングに関するガイドラインをご覧ください。 |
OAuth アプリケーションの検証が必要です。検証プロセスが完了するまで、アプリにはユーザーの割り当てが適用され、ユーザーには未確認のアプリ画面が表示されます。 |
| 変更履歴 | データ パートナーによる変更は明確に識別されます。各変更に関連付けられているユーザーは、データ パートナー アカウントの Google アカウントです。 | データ パートナーによる変更は、認証情報に関連付けられている 広告主の Google アカウントに関連付けられるため、 広告主による変更と、広告主の代理としてデータ パートナーが行った変更を 区別することが困難になります。 |
データ パートナーのワークフロー
データ パートナーがパートナー リンクを使用して広告主アカウントを管理する手順は次のとおりです。
広告主アカウントの認証情報を使用して、 パートナー リンクを作成します。
広告主アカウントの認証情報を破棄します。パートナー リンクを作成したので、認証情報は不要になりました。
広告主アカウントのオーディエンスやイベントを管理するための以降のリクエスト はすべて、データ パートナー アカウントのユーザーである Google アカウントの認証情報を使用します。 宛先とヘッダーを構成 して、パートナー リンクを使用して広告主アカウントにアクセスします。
広告主アカウントの認証情報を取得する
パートナー リンクを作成または削除するには、広告主アカウントのユーザーである Google アカウントの認証情報が必要です。認証情報には、データ マネージャー API スコープが必要です。
https://www.googleapis.com/auth/datamanager
広告主アカウントの認証情報を取得するには、独自の OAuth フローを構築してユーザーを認証します。Google Identity のドキュメントでは、複数のアプリタイプと、各アプリタイプをサポートするために必要な構成について説明しています。これらのアプリタイプはすべて Data Manager API で サポートされていますが、パートナー リンクを作成するための広告主の認証情報を取得するには、 ウェブサーバー アプリケーションでの OAuth 2.0 の使用 または クライアントサイド ウェブ アプリケーションでの OAuth 2.0 の使用 のいずれかをおすすめします。
プロセスを完了したら、Data Manager API スコープの認証を行うようにアプリケーションを構成します。
https://www.googleapis.com/auth/datamanager