Data Manager API を使用する場合は、Destination のコンセプトとリクエスト ヘッダーの両方が頻繁に登場します。このガイドでは、さまざまなシナリオで宛先とヘッダーを構成する方法について説明します。
宛先またはヘッダーを使用する場合
取り込みリクエストで
Destinationを使用します。取り込みリクエストは、IngestionServiceを使用して、オーディエンスのメンバーを追加または削除したり、イベントを送信したりします。IngestAudienceMembersRequestまたはIngestEventsRequestのdestinationsリストは、次のものを定義します。- データを受信するアカウント。たとえば、Google 広告アカウントや Google アナリティクス プロパティなどです。
- アカウント内のデータの宛先エンティティ(Google 広告のコンバージョン アクションや Google アナリティクスのストリームなど)。
- リクエストの認証情報からデータを受信するアカウントへのアクセスパス。
同じ取り込みリクエストに複数の宛先を含めることができます。
リソースの作成、更新、削除、取得を行うリソース管理リクエストでリクエスト ヘッダーを使用します。ヘッダーは、リソース管理リクエストのターゲット アカウントに対するリクエストの認証情報のアクセスパスを定義します。リクエスト ヘッダーをサポートするリソース管理メソッドを含むリソースのリストは次のとおりです。
たとえば、オーディエンスを作成し、オーディエンスにメンバーを追加して、診断を確認してから、オーディエンスを取得してサイズを確認する場合、各ステップ、使用するリクエストのタイプ、デスティネーションまたはリクエスト ヘッダーを使用するかどうかは次のようになります。
| ステップ | リクエストの種類 | 宛先ヘッダーまたはリクエスト ヘッダー |
|---|---|---|
| ユーザーリストの作成 | リソース管理 | リクエスト ヘッダー |
| ユーザーリストにメンバーを追加する | 取り込み | 目的地 |
| 診断結果を確認 | 取り込み | 目的地 |
| オーディエンスを取得する | リソース管理 | リクエスト ヘッダー |
各テーブルの周囲にある [取り込み] タブまたは [リソース管理] タブをクリックすると、このガイドの各リクエスト タイプの詳細を切り替えることができます。
広告主または代理店の場合は、広告主のシナリオに移動して、ヘッダーの設定方法と Destination の作成方法の例をご覧ください。
データ パートナーの場合は、データ パートナーのシナリオに移動して、ヘッダーの設定方法と、リソースを管理し、データ パートナー アカウントへの商品リンクを含むアカウントにデータを送信するための Destination の作成方法の例をご覧ください。
詳細な要件セクションでは、要件と検証ルールについて詳しく説明します。
広告主のシナリオ
広告主様や広告代理店様が一般的なシナリオで Destination またはリクエスト ヘッダーを設定する方法は次のとおりです。この図は、Data Manager API が認証情報と Destination フィールドを使用して広告主アカウントにアクセスする方法を示しています。
Google 広告
Google 広告アカウントとユーザーのセットの例を示す図を次に示します。
- クライアント センター(MCC)アカウント M1
M1 には 2 つの直接の子アカウントがあります。
- クライアント センター(MCC)アカウント M2
- クライアント アカウント C1
Google アカウント
cloudysanfrancisco@gmail.comは M1 のユーザーです。- クライアント センター(MCC)アカウント M2
M2 には 2 つの子アカウントがあります。
- クライアント アカウント C1
- クライアント アカウント C2
Google アカウント
baklavainthebalkans@gmail.comは M2 のユーザーです。- クライアント アカウント C1
C1 には 2 つの直属の親 MCC アカウントがあります。
- クライアント センター(MCC)アカウント M1
- クライアント センター(MCC)アカウント M2
Google アカウント
jeffersonloveshiking@gmail.comは C1 のユーザーです。- クライアント アカウント C2
MCC アカウント M2 は、C2 の唯一の直接の親アカウントです。
リストに表示されている Google アカウントは、C2 のユーザーではありません。
直接アクセス シナリオとマネージャー アクセス シナリオでは、これらのアカウントにデータを送信するように宛先を構成する方法を示します。
ダイレクト アクセスのシナリオ
Google 広告アカウントにデータを送信する場合で、認証情報が Google 広告アカウントのユーザーである Google アカウントのものである場合:
取り込み
| 目的地 | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
login_account を設定しないか、operating_account と同じ値に設定します。 |
||||
linked_account |
linked_account フィールドを設定しないでください。 |
||||
product_destination_id |
オーディエンスまたはコンバージョン アクションの ID。 | ||||
リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
図のアカウントと Google アカウント jeffersonloveshiking@gmail.com の認証情報を使用した直接アクセス シナリオの例を次に示します。
取り込み
{
"destinations": [
{
"operatingAccount": {
"accountId": "C1_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"loginAccount": {
"accountId": "C1_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"productDestinationId": "USER_LIST_ID"
}
]
}リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
管理者権限のシナリオ
Google 広告アカウントにデータを送信する場合、認証情報が Google 広告 MCC アカウントのユーザーである Google アカウントのもので、広告主アカウントが子アカウントである場合:
取り込み
| 目的地 | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
linked_account フィールドを設定しないでください。 |
||||
product_destination_id |
オーディエンスまたはコンバージョン アクションの ID。 | ||||
リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
図の Google 広告クライアント アカウント C2 の管理者アクセス シナリオと、Google アカウント baklavainthebalkans@gmail.com の認証情報の例を次に示します。
取り込み
{
"destinations": [
{
"operatingAccount": {
"accountId": "C2_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"loginAccount": {
"accountId": "M2_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"productDestinationId": "USER_LIST_ID"
}
]
}リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
Google 広告クライアント アカウント C2 と、Google 広告 MCC アカウント M1 のユーザーである Google アカウント cloudysanfrancisco@gmail.com の認証情報のマネージャー アクセスのシナリオの別の例を次に示します。
取り込み
{
"destinations": [
{
"operatingAccount": {
"accountId": "C2_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"loginAccount": {
"accountId": "M1_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"productDestinationId": "USER_LIST_ID"
}
]
}リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
ディスプレイ&ビデオ 360
ディスプレイ&ビデオ 360 にデータを送信するには、次の 2 つの方法があります。
- 直接アクセス。認証情報は、ディスプレイ&ビデオ 360 の広告主またはパートナー アカウントのユーザーである Google アカウントのものです。
- ディスプレイ&ビデオ 360 パートナー アクセス。認証情報はディスプレイ&ビデオ 360 パートナー アカウントのユーザーである Google アカウントのもので、オペレーティング アカウントはパートナー アカウントのディスプレイ&ビデオ 360 広告主アカウントです。
ダイレクト アクセスのシナリオ
ディスプレイ&ビデオ 360 の広告主アカウントにデータを送信する場合で、認証情報が広告主アカウントのユーザーである Google アカウントのものである場合:
取り込み
| 目的地 | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
login_account を設定しないか、operating_account と同じ値に設定します。 |
||||
linked_account |
linked_account フィールドを設定しないでください。 |
||||
product_destination_id |
オーディエンスの ID。 | ||||
リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
以下は、ディスプレイ&ビデオ 360 の広告主にデータを送信する直接アクセス シナリオの Destination の例です。
取り込み
{
"destinations": [
{
"operatingAccount": {
"accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
"accountType": "DISPLAY_VIDEO_ADVERTISER"
},
"loginAccount": {
"accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
"accountType": "DISPLAY_VIDEO_ADVERTISER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
同様に、ディスプレイ&ビデオ 360 のパートナー アカウントにデータを送信する場合、認証情報がパートナー アカウントのユーザーである Google アカウントのものである場合は、次のようになります。
取り込み
| 目的地 | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
login_account を設定しないか、operating_account と同じ値に設定します。 |
||||
linked_account |
linked_account フィールドを設定しないでください。 |
||||
product_destination_id |
オーディエンスの ID。 | ||||
リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
以下は、ディスプレイ&ビデオ 360 のパートナーにデータを送信する直接アクセス シナリオの Destination の例です。
取り込み
{
"destinations": [
{
"operatingAccount": {
"accountId": "DISPLAY_VIDEO_PARTNER_ID",
"accountType": "DISPLAY_VIDEO_PARTNER"
},
"loginAccount": {
"accountId": "DISPLAY_VIDEO_PARTNER_ID",
"accountType": "DISPLAY_VIDEO_PARTNER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
ディスプレイ&ビデオ 360 パートナーのアクセス シナリオ
ディスプレイ&ビデオ 360 の広告主にデータを送信する場合で、認証情報が広告主の親ディスプレイ&ビデオ 360 パートナー アカウントのユーザーである Google アカウントのものである場合:
取り込み
| 目的地 | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
linked_account フィールドを設定しないでください。 |
||||
product_destination_id |
オーディエンスの ID。 | ||||
リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
以下は、ディスプレイ&ビデオ 360 広告主にデータを送信するパートナー アクセス シナリオの Destination の例です。このシナリオでは、認証情報はディスプレイ&ビデオ 360 パートナー アカウント DISPLAY_VIDEO_PARTNER_ID のユーザーである Google アカウントのものである必要があります。また、ディスプレイ&ビデオ 360 広告主アカウント DISPLAY_VIDEO_ADVERTISER_ID はパートナー アカウント DISPLAY_VIDEO_PARTNER_ID の子である必要があります。
取り込み
{
"destinations": [
{
"operatingAccount": {
"accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
"accountType": "DISPLAY_VIDEO_ADVERTISER"
},
"loginAccount": {
"accountId": "DISPLAY_VIDEO_PARTNER_ID",
"accountType": "DISPLAY_VIDEO_PARTNER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
Google アナリティクス
注: operating_account が Google アナリティクス アカウントの場合は、login_account を設定しないか、operating_account と同じ値に設定します。それ以外の場合、リクエストはエラー OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH で失敗します。
取り込み
| 目的地 | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
login_account を設定しないか、operating_account と同じ値に設定します。 |
||||
linked_account |
linked_account フィールドを設定しないでください。 |
||||
product_destination_id |
データ ストリームの測定 ID。 | ||||
リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
Google アナリティクスにイベントを送信する Destination の例を次に示します。
取り込み
{
"destinations": [
{
"operatingAccount": {
"accountId": "PROPERTY_ID",
"accountType": "GOOGLE_ANALYTICS_PROPERTY"
},
"loginAccount": {
"accountId": "PROPERTY_ID",
"accountType": "GOOGLE_ANALYTICS_PROPERTY"
},
"productDestinationId": "MEASUREMENT_ID"
}
]
}リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
データ パートナーのシナリオ
データ パートナー アカウントへの商品リンクが確立されている広告主アカウントにデータを送信するデータ パートナーの一般的なシナリオで Destination を設定する方法は次のとおりです。
この図は、Data Manager API が認証情報と Destination フィールドを使用して、プロダクト リンクを介して広告主アカウントにアクセスする方法を示しています。
Google 広告
Google 広告アカウントとデータ パートナー アカウントのセットの例を示す図を次に示します。この図には、各 Google 広告アカウントまたはデータ パートナー アカウントのユーザーである Google アカウントと、アカウント間のサービスリンクも示されています。
- データ パートナー D1
D1 と Google 広告クライアント センター(MCC)アカウント M2 の間にサービス間のリンクが存在します。
Google アカウント
222larabrown@gmail.comは D1 のユーザーです。- データ パートナー D2
D2 と Google 広告クライアント アカウント C1 の間にサービス間のリンクが存在します。
Google アカウント
jeffersonloveshiking@gmail.comは D2 のユーザーです。- クライアント センター(MCC)アカウント M1
M1 には 2 つの直接の子アカウントがあります。
- クライアント センター(MCC)アカウント M2
- クライアント アカウント C1
- クライアント センター(MCC)アカウント M2
M2 には 2 つの子アカウントがあります。
- クライアント アカウント C1
- クライアント アカウント C2
- クライアント アカウント C1
C1 には 2 つの直属の親 MCC アカウントがあります。
- クライアント センター(MCC)アカウント M1
- クライアント センター(MCC)アカウント M2
- クライアント アカウント C2
MCC アカウント M2 は、C2 の唯一の直接の親アカウントです。
このアカウント セットでは、次のことができます。
- データ パートナー D1 として行動する
データ パートナー D1 として機能するには、Google アカウント
222larabrown@gmail.comの認証情報を使用して、宛先でlogin_accountがデータ パートナー アカウント D1 に設定され、linked_accountがマネージャー アカウント M2 に設定されている場合、マネージャー アカウント M2、クライアント アカウント C1、またはクライアント アカウント C2 にデータを送信します。データ パートナー D1 は、D1 とクライアント センター(MCC)アカウント M1 の間にサービスリンクがないため、M1 にデータを送信できません。
- データ パートナー D2 として行動する
データ パートナー D2 として機能するには、Google アカウント
jeffersonloveshiking@gmail.comの認証情報を使用して、宛先でlogin_accountがデータ パートナー アカウント D2 に設定され、linked_accountがクライアント アカウント C1 に設定されている宛先を使用して、クライアント アカウント C1 にデータを送信します。データ パートナー D2 は、M1、M2、C2 のいずれのアカウントとその親 MCC アカウントとも商品リンクが設定されていないため、これらのアカウントにデータを送信できません。
データ パートナー D1 と D2 の主な違いは、データ パートナーが Google 広告アカウントにリンクされる方法です。
- データ パートナー D1 が Google 広告 MCC アカウントにリンクされています。これは、管理者サービスのリンク シナリオの例です。
- データ パートナー D2 が Google 広告クライアント アカウントにリンクされています。これは、商品への直接リンクのシナリオの例です。
商品への直接リンクのシナリオ
Google 広告アカウントにデータを送信する場合で、Google 広告アカウントとデータ パートナー アカウントの間にサービスリンクがある場合:
取り込み
| 目的地 | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
linked_account フィールドを設定しないでください。 |
||||
product_destination_id |
オーディエンスまたはコンバージョン アクションの ID。 | ||||
リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
図のアカウントを使用した直接商品リンクのシナリオと、リソース管理リクエストに対応するリクエスト ヘッダーの例を次に示します。このシナリオでは、データ パートナー D2 は、D2 と C1 の間のプロダクト リンクと Google アカウント jeffersonloveshiking@gmail.com の認証情報を使用して、オーディエンス メンバー データを Google 広告クライアント顧客 C1 に送信します。
取り込み
{
"destinations": [
{
"operatingAccount": {
"accountId": "C1_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"loginAccount": {
"accountId": "D2_CUSTOMER_ID",
"accountType": "DATA_PARTNER"
},
"productDestinationId": "USER_LIST_ID"
}
]
}リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
マネージャー サービス間のリンク設定のシナリオ
Google 広告アカウントにデータを送信する場合で、プロダクト リンクが親 Google 広告クライアント センター(MCC)アカウントとデータ パートナー アカウントの間にある場合:
取り込み
| 目的地 | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
|
||||
product_destination_id |
オーディエンスまたはコンバージョン アクションの ID。 | ||||
リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID |
図のアカウントを使用したマネージャー サービスのリンク シナリオの例を次に示します。このシナリオでは、データ パートナー D1 は、D1 と M2 の間のプロダクト リンクと Google アカウント 222larabrown@gmail.com の認証情報を使用して、オーディエンス メンバー データを Google 広告クライアント顧客 C2 に送信します。
取り込み
{
"destinations": [
{
"operatingAccount": {
"accountId": "C2_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"loginAccount": {
"accountId": "D1_CUSTOMER_ID",
"accountType": "DATA_PARTNER"
},
"linkedAccount": {
"accountId": "M2_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"productDestinationId": "USER_LIST_ID"
}
]
}リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID |
linked-account |
accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID |
ディスプレイ&ビデオ 360
データ パートナーは、次の 2 つの方法でディスプレイ&ビデオ 360 アカウントにデータを送信できます。
- データ パートナー アカウントとディスプレイ&ビデオ 360 のパートナー アカウントまたは広告主アカウントの間に直接的なプロダクト リンクを使用します。
- データ パートナー アカウントと広告主様の親ディスプレイ&ビデオ 360 パートナー アカウント間のプロダクト リンクを使用して、ディスプレイ&ビデオ 360 広告主にデータを送信します。
商品への直接リンクのシナリオ
ディスプレイ&ビデオ 360 の広告主にデータを送信する場合で、ディスプレイ&ビデオ 360 の広告主アカウントとデータ パートナー アカウントの間にプロダクト リンクがある場合:
取り込み
| 目的地 | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
linked_account フィールドを設定しないでください。 |
||||
product_destination_id |
オーディエンスまたはコンバージョン アクションの ID。 | ||||
リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
以下は、ディスプレイ&ビデオ 360 の広告主にデータを送信する直接商品リンク シナリオの Destination の例と、リソース管理リクエストに対応するリクエスト ヘッダーです。
取り込み
{
"destinations": [
{
"operatingAccount": {
"accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
"accountType": "DISPLAY_VIDEO_ADVERTISER"
},
"loginAccount": {
"accountId": "DATA_PARTNER_ID",
"accountType": "DATA_PARTNER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
ディスプレイ&ビデオ 360 のパートナー アカウントにデータを送信するには、ディスプレイ&ビデオ 360 のパートナー アカウントとデータ パートナー アカウントの間にプロダクト リンクが必要です。
取り込み
| 目的地 | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
linked_account フィールドを設定しないでください。 |
||||
product_destination_id |
オーディエンスまたはコンバージョン アクションの ID。 | ||||
リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
以下は、ディスプレイ&ビデオ 360 パートナーにデータを送信する直接商品リンク シナリオの Destination の例と、リソース管理リクエストに対応するリクエスト ヘッダーです。
取り込み
{
"destinations": [
{
"operatingAccount": {
"accountId": "DISPLAY_VIDEO_PARTNER_ID",
"accountType": "DISPLAY_VIDEO_PARTNER"
},
"loginAccount": {
"accountId": "DATA_PARTNER_ID",
"accountType": "DATA_PARTNER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
linked-account ヘッダーを設定しないでください。 |
ディスプレイ&ビデオ 360 パートナーのプロダクト リンクのシナリオ
ディスプレイ&ビデオ 360 の広告主にデータを送信し、データ パートナー アカウントへの商品リンクが、広告主アカウントが子アカウントであるディスプレイ&ビデオ 360 パートナー アカウントの場合:
取り込み
| 目的地 | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
|
||||
product_destination_id |
オーディエンスまたはコンバージョン アクションの ID。 | ||||
リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID |
以下は、データ パートナーと広告主の親ディスプレイ&ビデオ 360 パートナー間のサービス間のリンクを使用して、ディスプレイ&ビデオ 360 広告主にデータを送信するパートナー サービス間のリンクのシナリオの Destination の例です。
取り込み
{
"destinations": [
{
"operatingAccount": {
"accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
"accountType": "DISPLAY_VIDEO_ADVERTISER"
},
"loginAccount": {
"accountId": "DATA_PARTNER_ID",
"accountType": "DATA_PARTNER"
},
"linkedAccount": {
"accountId": "DISPLAY_VIDEO_PARTNER_ID",
"accountType": "DISPLAY_VIDEO_PARTNER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}リソース管理
| リクエスト ヘッダー | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID |
Google アナリティクス
Data Manager API では、サービス間のリンク設定を使用して Google アナリティクス アカウントにデータを送信することはできません。代わりに、Google アナリティクスの広告主様のシナリオのアプローチを使用してください。
詳細な要件
このセクションでは、IngestionService リクエストの Destination のアカウント フィールドの詳細な要件、リソース管理リクエストの同等のリクエスト ヘッダー、product_destination_id を設定するためのヒント、認証情報がアクセスできる場所を特定する方法について説明します。
アカウント フィールド
1 つの Destination には、最大 3 つの異なるアカウントを設定できます。
operating_accountoperating_accountは必須です。operating_accountは、リクエストでどのアカウントがデータを受信するかを示します。operating_accountは次のいずれかになります。- Google 広告アカウント
- ディスプレイ&ビデオ 360 の広告主アカウント
- ディスプレイ&ビデオ 360 パートナー アカウント
- Google アナリティクス プロパティ
- データ パートナー アカウント(データ パートナー アカウントが所有するオーディエンスにデータを送信する場合)。
Destinationのoperating_accountフィールドに対応するリクエスト ヘッダーはありません。リソース管理リクエストを送信する場合、リクエストのターゲット アカウントはオペレーティング アカウントです。login_accountフィールドとlogin-accountリクエスト ヘッダーlogin_accountは常に必要というわけではなく、IngestionServiceリクエストではoperating_accountがデフォルトになり、リソース管理リクエストではターゲット アカウントがデフォルトになります。リソース管理リクエストでは、login-accountリクエスト ヘッダーを使用してログイン アカウントを識別します。Data Manager API は、次のことを確認します。
認証情報の Google アカウントがログイン アカウントのユーザーである。
ログイン アカウントは次のいずれかです。
operating_accountと同じです。これは、IngestionServiceリクエストでDestinationのlogin_accountを設定しない場合、またはリソース管理リクエストでlogin-accountヘッダーを設定しない場合のデフォルトです。IngestionServiceリクエストのoperating_accountの親である Google 広告クライアント センター(MCC)アカウント、またはリソース管理リクエストのターゲット アカウントの親であるディスプレイ&ビデオ 360 パートナー アカウント。IngestionServiceリクエストのlinked_accountへの商品リンク、またはリソース管理リクエストのlinked-accountヘッダーを含むデータ パートナー アカウント。
linked_accountフィールドとlinked-accountリクエスト ヘッダーlinked_accountは、IngestionServiceリクエストのlogin_accountへのプロダクト リンクがあるアカウント、またはリソース管理リクエストのターゲット アカウントを示します。
商品広告のリンク先 ID
Destination の product_destination_id は、operating_account のどのオブジェクトがデータを受け取るかを識別します。たとえば、Google 広告またはディスプレイ&ビデオ 360 のオーディエンス ID、Google 広告のコンバージョン アクション ID、Google アナリティクス ストリームの測定 ID などです。
各タイプの商品のリンク先の ID を確認する方法は次のとおりです。
Google 広告のオーディエンス
オーディエンス メンバーを取り込むためのアイテムの宛先 ID は、オーディエンス ID です。この ID は、Google 広告の管理画面またはデータマネージャー API を使用して取得します。
- Google 広告の管理画面
Google 広告の管理画面からオーディエンス ID を取得するには:
- Google 広告の管理画面で [オーディエンス マネージャー] に移動します。
- オーディエンス名をクリックすると、詳細が表示されます。
- オーディエンス ID は [リスト ID] の横に表示されます。
- Data Manager API
List メソッドを使用して
UserListを取得し、必要に応じてリクエスト ヘッダーを指定します。アイテムの販売先 ID にはUserListのidを使用します。
Google 広告イベント
イベントの取り込みに使用するプロダクトのリンク先 ID は、コンバージョン アクション ID です。
Google 広告の UI からコンバージョン アクション ID を取得するには:
- Google 広告の管理画面で [コンバージョン] に移動します。
- コンバージョン アクション名をクリックすると、詳細が表示されます。
コンバージョン アクション ID は、
ctIdという名前の URL クエリ パラメータの値です。https://ads.google.com/aw/conversions/detail?ocid=...&ctId=CONVERSION_ACTION_ID&...
Google Ads API からコンバージョン アクション ID を取得するには:
次のクエリを使用して、
GoogleAdsServiceにSearchまたはSearchStreamリクエストを送信します。SELECT conversion_action.id, conversion_action.name FROM conversion_action WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'レスポンスの
conversion_actionのidフィールドからコンバージョン アクション ID を取得します。[ { "results": [ { "conversionAction": { "resourceName": "customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID", "id": "CONVERSION_ACTION_ID", "name": "CONVERSION_ACTION_NAME" } } ] } ]
ディスプレイ&ビデオ 360 のオーディエンス
オーディエンス メンバーを取り込むためのアイテムの宛先 ID は、オーディエンス ID です。この ID は、ディスプレイ&ビデオ 360 の管理画面または Data Manager API を使用して取得します。
- ディスプレイ&ビデオ 360 の UI
ディスプレイ&ビデオ 360 の UI からオーディエンス ID を取得するには:
- ディスプレイ&ビデオ 360 の管理画面(https://displayvideo.google.com)にログインします。
operating_accountに使用しているディスプレイ&ビデオ 360 パートナーまたは広告主に移動します。- 左側のメニューで [オーディエンス] に移動し、[すべてのオーディエンス] を選択します。
- リストからオーディエンスを探します。オーディエンス ID は、[名前] 列の名前の横にある番号です。
- Data Manager API
List メソッドを使用して
UserListを取得し、必要に応じてリクエスト ヘッダーを指定します。アイテムの販売先 ID にはUserListのidを使用します。
Google アナリティクスのイベント
イベントの取り込みに使用するプロダクトの宛先 ID は、データ ストリームの測定 ID です。
認証情報がアクセスできる場所を特定する
Data Manager API リクエストの承認に使用する認証情報は、特定の Google アカウントに関連付けられています。
- ユーザー認証情報を使用する場合、認証情報の生成時にユーザーに代わって操作する権限を付与したユーザーの Google アカウントとしてリクエストが承認されます。
- サービス アカウントの認証情報を使用する場合、リクエストはサービス アカウントの Google アカウントとして承認されます。
認証情報の Google アカウントが Google 広告、ディスプレイ&ビデオ 360、または Google アナリティクスのアカウントにアクセスできることを確認する方法は次のとおりです。
Google 広告またはデータ パートナー
login_accountの Google 広告の UI で [アクセスとセキュリティ] に移動します。- [ユーザー] タブを選択します。
login_accountが Google 広告 MCC アカウントの場合は、[全階層のユーザーを表示する] 切り替えボタンをオフにして、子アカウントのユーザーを非表示にします。- 認証情報の Google アカウントが [ユーザー] タブに表示されるアカウントのリストに含まれていることを確認します。
ディスプレイ&ビデオ 360
- ディスプレイ&ビデオ 360 の UI で [ユーザー管理とメール設定] に移動します。
- [ユーザー管理] に、認証情報の Google アカウントが
login_accountのユーザーとして表示されていることを確認します。
Google アナリティクス
- Google アナリティクスの管理画面で、[プロパティのアクセス管理] に移動します。
login_accountで指定した Google アナリティクス プロパティが選択されていることを確認します。- 認証情報の Google アカウントに、プロパティに対する編集者または管理者のロールが付与されていることを確認します。