パートナー リンクは、データ パートナーがデータ パートナーのアカウントにアクセスできる Google アカウントの認証情報を使用して、広告主のアカウントのオーディエンスまたはイベントを管理できるようにする仕組みです。パートナー リンクを使用すると、広告主様のアカウントに直接アクセスできる Google アカウントの認証情報を要求する必要がなくなります。
Google の担当者と協力して、広告主が Google 広告、ディスプレイ＆ビデオ 360、Google アド マネージャーの UI でデータ パートナー アカウントへのパートナー リンクを管理できるようにすることをおすすめします。データ パートナーが PartnerLinkService を使用してリンクを作成または削除する必要があるのは、データ パートナー アカウントへのリンクの管理が UI で利用できない場合、またはアプリケーション内でパートナー リンク機能を提供したい場合のみです。
パートナー リンクのメリット
データ パートナーとして、パートナー リンクを使用して広告主アカウントを管理すると、直接アクセスする方法に比べていくつかのメリットがあります。
| パートナー リンク | ダイレクト アクセス | |
|---|---|---|
| 認証情報の管理 |
広告主アカウントでパートナー リンクを作成すると、以降のリクエストでは、データ パートナー アカウントにアクセスできる Google アカウントの単一の認証情報セットが使用されます。 広告主アカウントの認証情報は有効期間が短いです。パートナー リンクの作成に使用したら、破棄できます。
|
すべての広告主アカウントに個別の認証情報が必要です。 広告主アカウントの認証情報は有効期間が長い。すべての広告主の認証情報を安全に保存し、その広告主のオーディエンスやイベントを管理する際に、各広告主の特定の認証情報を安全に取得する必要があります。
|
| 変更履歴 | データ パートナーによる変更が明確に特定されている。各変更に関連付けられているユーザーは、データパートナー アカウントの Google アカウントです。 | データ パートナーによる変更は、認証情報に関連付けられている広告主の Google アカウントに関連付けられるため、広告主による変更と、データ パートナーが広告主の代理で行った変更を区別することが困難になります。 |
データ パートナーのワークフロー
データ パートナーがパートナー リンクを使用して広告主アカウントを管理する手順は次のとおりです。
広告主様のアカウントの認証情報を使用して、パートナー リンクを作成します。
広告主アカウントの認証情報を破棄します。パートナー リンクを作成したので、これらの権限は不要になりました。
広告主アカウントのオーディエンスまたはイベントを管理する以降のすべてのリクエストでは、データ パートナー アカウントのユーザーである Google アカウントの認証情報を使用します。リンク先とヘッダーを構成して、パートナー リンクを使用して広告主アカウントにアクセスします。
広告主アカウントの認証情報を取得する
パートナー リンクを作成または削除するには、広告主アカウントのユーザーである Google アカウントの認証情報が必要です。認証情報には、Data Manager 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