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