パートナー リンクの概要

パートナー リンクは、広告主アカウントをデータ パートナー アカウントに接続します。これにより、データ パートナーは、広告主のアカウントに直接アクセスするための認証情報ではなく、独自のデータ パートナー アカウントの認証情報を使用して、広告主のアカウントでオーディエンスやイベントを管理できます。

データ パートナーがパートナー リンクを使用してさまざまなアカウントへのアクセスを管理する方法については、宛先ガイドのデータ パートナーのシナリオ セクションをご覧ください。広告主の認証情報を必要とする直接アクセスについては、広告主のシナリオのセクションをご覧ください。

Google の担当者と連携して、広告主が Google 広告、ディスプレイ&ビデオ 360、Google アド マネージャーの管理画面でデータ パートナー アカウントへのパートナー リンクを管理できるようにすることをおすすめします。データ パートナーが PartnerLinkService を使用してリンクを作成または削除する必要があるのは、データ パートナー アカウントへのリンクの管理が UI で利用できない場合、またはアプリケーション内でパートナー リンク機能を提供したい場合のみです。

データ パートナーとして、パートナー リンクを使用して広告主アカウントを管理すると、直接アクセスのアプローチと比較していくつかの利点があります。

パートナー リンク ダイレクト アクセス
広告主アカウントのスコープが限定された認証情報 パートナー リンクの作成または削除のみを許可する認証情報。 広告主のアカウントの多くの側面を変更できる、広範なスコープの認証情報。
認証情報の管理

広告主アカウントでパートナー リンクを作成すると、それ以降のリクエストでは、データ パートナー アカウントにアクセスできる Google アカウントの 1 つの認証情報セットが使用されます。

広告主アカウントの認証情報は有効期間が短い。パートナー リンクの作成に使用した後は、破棄できます。

広告主アカウントごとに個別の認証情報が必要です。

広告主アカウントの認証情報は長期間有効です。すべての広告主の認証情報を安全に保存し、特定の広告主のオーディエンスやイベントを管理する際に、その広告主の認証情報を安全に取得する必要があります。

変更履歴 データ パートナーが行った変更は明確に識別されます。各変更に関連付けられているユーザーは、データ パートナー アカウントの Google アカウントです。 データ パートナーが行った変更は、認証情報に関連付けられている広告主の Google アカウントに関連付けられるため、広告主が行った変更と、データ パートナーが広告主に代わって行った変更を区別することが困難になります。

データ パートナーのワークフロー

データ パートナーがパートナー リンクを使用して広告主アカウントを管理する手順は次のとおりです。

  1. 広告主アカウントの認証情報を取得する。

  2. 広告主アカウントの認証情報を使用して、パートナー リンクを作成します。

  3. 広告主アカウントの認証情報を破棄します。パートナー リンクを作成したため、これらは不要になりました。

  4. 広告主アカウントでオーディエンスまたはイベントを管理するための後続のすべてのリクエストには、データ パートナー アカウントのユーザーである 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