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