宛先とヘッダーを構成する

Destination のコンセプトとリクエスト ヘッダーは、Data Manager API を使用する際によく使用されます。このガイドでは、さまざまなシナリオで宛先とヘッダーを構成する方法について説明します。

宛先またはヘッダーを使用するタイミング

• 取り込みリクエストで Destination を使用します。取り込みリクエストでは、IngestionService を使用して、オーディエンスのメンバーを追加または削除したり、イベントを送信したりします。IngestAudienceMembersRequest または IngestEventsRequest の destinations リストは、次のものを定義します。

  1. データを受信するアカウント。たとえば Google 広告アカウントや Google アナリティクスのプロパティです
  2. アカウント内のデータのリンク先エンティティ（Google 広告のコンバージョン アクション、Google アナリティクスのストリームなど）。
  3. データを受信するアカウントへのリクエストの認証情報のアクセスパス。

  同じ取り込みリクエストに複数の宛先を含めることができます。

  ヒント: IngestionService リクエストでリクエスト ヘッダーを設定しないでください。Data Manager API は、取り込みリクエストのヘッダーを無視します。

• リソースの作成、更新、削除、取得を行うリソース管理リクエストでリクエスト ヘッダーを使用します。ヘッダーは、リソース管理リクエストのターゲット アカウントに対するリクエストの認証情報のアクセスパスを定義します。リクエスト ヘッダーをサポートするリソース管理メソッドを含むリソースのリストは次のとおりです。

  • Insights
  • PartnerLink
  • UserList
  • UserListDirectLicense
  • UserListGlobalLicense
  • UserListGlobalLicenseCustomerInfo

たとえば、オーディエンスを作成し、オーディエンスにメンバーを追加して、診断を確認し、オーディエンスを取得してサイズを確認する場合、各ステップ、使用するリクエストのタイプ、宛先またはリクエスト ヘッダーを使用するかどうかは次のとおりです。

ステップ	リクエストの種類	宛先ヘッダーまたはリクエスト ヘッダー
ユーザーリストの作成	リソース管理	リクエスト ヘッダー
オーディエンスにメンバーを追加する	取り込み	目的地
診断結果を確認	取り込み	目的地
オーディエンスを取得する	リソース管理	リクエスト ヘッダー

注: RetrieveRequestStatus リクエストは、宛先またはリクエスト ヘッダーを直接受け入れません。代わりに、Data Manager API は、元の取り込みリクエストの宛先とアクセスパスを使用して認可を検証します。詳細については、診断ガイドの認可をご覧ください。

各テーブルの周囲にある [取り込み] タブまたは [リソース管理] タブをクリックして、各リクエスト タイプの詳細を切り替えます。

広告主または代理店の場合は、広告主のシナリオに移動して、ヘッダーを設定して Destination を作成する方法の例をご覧ください。

• Google 広告
• ディスプレイ＆ビデオ 360
• Google アナリティクス
• Floodlight

データ パートナーの場合は、データ パートナーのシナリオに移動して、ヘッダーを設定し、Destination を作成してリソースを管理し、データ パートナー アカウントへのパートナー リンクを使用してアカウントにデータを送信する方法の例をご覧ください。

• Google 広告
• ディスプレイ＆ビデオ 360
• Google アド マネージャー
• Google アナリティクス
• Floodlight

詳細な要件のセクションでは、要件と検証ルールについて詳しく説明します。

広告主のシナリオ

広告主様と代理店様の一般的なシナリオで Destination またはリクエスト ヘッダーを構成する方法は次のとおりです。この図は、Data Manager API が認証情報と Destination フィールドを使用して広告主アカウントにアクセスする方法を示しています。

Google 広告

次の図は、Google 広告アカウントとユーザーのセットの例を示しています。

マネージャー アカウント M1

M1 には、次の 2 つの直接の子アカウントがあります。

1. マネージャー アカウント M2
2. クライアント アカウント C1

Google アカウント [e-mail] は M1 のユーザーです。

マネージャー アカウント M2

M2 には、次の 2 つの直接の子アカウントがあります。

1. クライアント アカウント C1
2. クライアント アカウント C2

Google アカウント [e-mail] は M2 のユーザーです。

クライアント アカウント C1

C1 には、2 つの直接の親 MCC アカウントがあります。

1. マネージャー アカウント M1
2. マネージャー アカウント M2

Google アカウント [e-mail] は C1 のユーザーです。

クライアント アカウント C2

MCC アカウント M2 は、C2 の唯一の直接の親です。

リストされている Google アカウントのいずれも C2 のユーザーではない。

直接アクセス シナリオとマネージャー アクセス シナリオでは、これらのアカウントにデータを送信するように宛先を構成する方法を示します。

直接アクセスのシナリオ

Google 広告アカウントにデータを送信する場合、認証情報が Google 広告アカウントのユーザーである Google アカウントのものである場合:

取り込み

宛先
operating_account	account_id Google 広告アカウントのお客様 ID account_type GOOGLE_ADS
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 アカウント [e-mail] の認証情報を使用した直接アクセスのシナリオの例を次に示します。

取り込み

{
  "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 広告マネージャー アカウントのユーザーである Google アカウントのものである場合:

取り込み

宛先
operating_account	account_id Google 広告クライアント アカウントのお客様 ID account_type GOOGLE_ADS
login_account	account_id Google 広告 MCC アカウントのお客様 ID account_type GOOGLE_ADS
linked_account	linked_account フィールドは設定しないでください。
product_destination_id	オーディエンスまたはコンバージョン アクションの ID。

リソース管理

リクエスト ヘッダー
login-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account	linked-account ヘッダーは設定しないでください。

図の Google 広告クライアント アカウント C2 と Google アカウント [e-mail] の認証情報のマネージャー アクセス シナリオの例を次に示します。

取り込み

{
  "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 アカウント [e-mail] の認証情報に対するマネージャー アクセスのシナリオの別の例を次に示します。

取り込み

{
  "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 つの方法があります。

1. 直接アクセス。ディスプレイ＆ビデオ 360 の広告主アカウントまたはパートナー アカウントのユーザーである Google アカウントの認証情報を使用します。
2. ディスプレイ＆ビデオ 360 パートナー アクセス。認証情報は、ディスプレイ＆ビデオ 360 パートナー アカウントのユーザーである Google アカウントのもので、オペレーティング アカウントはパートナー アカウント配下のディスプレイ＆ビデオ 360 広告主アカウントです。

直接アクセスのシナリオ

ディスプレイ＆ビデオ 360 の広告主アカウントにデータを送信する場合、認証情報は広告主アカウントのユーザーである Google アカウントのものになります。

取り込み

宛先
operating_account	account_id ディスプレイ＆ビデオ 360 広告主アカウントの ID account_type DISPLAY_VIDEO_ADVERTISER
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	account_id ディスプレイ＆ビデオ 360 パートナー アカウントの ID account_type DISPLAY_VIDEO_PARTNER
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	account_id ディスプレイ＆ビデオ 360 広告主アカウントの ID account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id ディスプレイ＆ビデオ 360 パートナー アカウントの ID account_type DISPLAY_VIDEO_PARTNER
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	account_id Google アナリティクスのプロパティの ID account_type GOOGLE_ANALYTICS_PROPERTY
login_account	login_account を設定しないか、operating_account と同じ値に設定します。
linked_account	linked_account フィールドは設定しないでください。
product_destination_id	ウェブデータ ストリームの測定 ID。 アプリデータ ストリームの Firebase アプリ 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 ヘッダーは設定しないでください。

Floodlight

注: operating_account が Floodlight 設定の場合は、login_account を設定しないか、operating_account と同じ値に設定します。それ以外の場合、リクエストはエラー OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH で失敗します。

取り込み

宛先
operating_account	account_id Floodlight 設定 ID 広告主が親広告主の子である場合は、キャンペーン マネージャー 360 の親広告主の ID を Floodlight 設定 ID として使用します。それ以外の場合は、広告主の ID を使用します。 キャンペーン マネージャー 360 の管理画面で広告主 ID を確認する方法 account_type FLOODLIGHT_CONFIG
login_account	login_account を設定しないか、operating_account と同じ値に設定します。
linked_account	linked_account フィールドは設定しないでください。
product_destination_id	Floodlight アクティビティ ID

Floodlight にイベントを送信する Destination の例を次に示します。

取り込み

        {
          "destinations": [
            {
              "operatingAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "loginAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "productDestinationId": "FLOODLIGHT_ACTIVITY_ID"
            }
          ]
        }
      

データ パートナーのシナリオ

データ パートナー アカウントへのパートナー リンクが確立されている広告主アカウントにデータを送信するデータ パートナーの一般的なシナリオで、Destination を構成する方法は次のとおりです。

注: すべてのデータ パートナー シナリオで、認証情報はデータ パートナー アカウントのユーザーである Google アカウントのものである必要があります。

この図は、Data Manager API が認証情報と Destination フィールドを使用して、パートナー リンクを介して広告主アカウントにアクセスする方法を示しています。

Google 広告

次の図は、Google 広告アカウントとデータ パートナー アカウントのセットの例を示しています。この図には、各 Google 広告アカウントまたはデータ パートナー アカウントのユーザーである Google アカウントと、アカウント間のパートナー リンクも示されています。

データ パートナー D1

D1 と Google 広告マネージャー アカウント M2 の間にパートナー リンクが存在する。

Google アカウント [e-mail] は D1 のユーザーです。

データ パートナー D2

D2 と Google 広告クライアント アカウント C1 の間にパートナー リンクが存在する。

Google アカウント [e-mail] は D2 のユーザーです。

マネージャー アカウント M1

M1 には、次の 2 つの直接の子アカウントがあります。

1. マネージャー アカウント M2
2. クライアント アカウント C1

マネージャー アカウント M2

M2 には、次の 2 つの直接の子アカウントがあります。

1. クライアント アカウント C1
2. クライアント アカウント C2

クライアント アカウント C1

C1 には、2 つの直接の親 MCC アカウントがあります。

1. マネージャー アカウント M1
2. マネージャー アカウント M2

クライアント アカウント C2

MCC アカウント M2 は、C2 の唯一の直接の親です。

このアカウント セットでは、次の操作を行うことができます。

データ パートナー D1 として操作する

データ パートナー D1 として機能するには、Google アカウント [e-mail] の認証情報を使用して次の操作を行います。

• login_account をデータ パートナー アカウント D1 に設定し、linked_account をマネージャー アカウント M2 に設定したリンク先を使用して、クライアント アカウント C1 またはクライアント アカウント C2 にデータを送信します。

• login_account がデータ パートナー アカウント D1 に設定されたリンク先を使用して、マネージャー アカウント M2 にデータを直接送信します。linked_account を設定しないでください。

データ パートナー D1 は、D1 と M1 の間にパートナー リンクがないため、マネージャー アカウント M1 にデータを送信できません。

データ パートナー D2 として機能する

データ パートナー D2 として機能するには、Google アカウント [e-mail] の認証情報を使用して、login_account がデータ パートナー アカウント D2 に設定された宛先を使用して、クライアント アカウント C1 にデータを送信します。linked_account を設定しないでください。

データ パートナー D2 は、マネージャー アカウント M1、マネージャー アカウント M2、クライアント アカウント C2 にデータを送信できません。D2 とこれらのアカウントまたはその親マネージャー アカウントとの間にパートナー リンクがないためです。

データ パートナー D1 と D2 の主な違いは、データ パートナーが Google 広告アカウントにリンクされる方法です。

• データ パートナー D1 は Google 広告 MCC アカウントにリンクされています。これは、マネージャー パートナー リンクのシナリオの例です。
• データ パートナー D2 は Google 広告クライアント アカウントにリンクされています。これは、直接パートナー リンクのシナリオの例です。

直接パートナー リンクのシナリオ

Google 広告アカウントにデータを送信する場合、パートナー リンクは Google 広告アカウントとデータ パートナー アカウントの間にあります。

取り込み

宛先
operating_account	account_id Google 広告アカウントのお客様 ID account_type GOOGLE_ADS
login_account	account_id データ パートナー アカウントのお客様 ID account_type DATA_PARTNER
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 アカウント [e-mail] の認証情報を使用して、オーディエンス メンバー データを 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	account_id Google 広告クライアント アカウントのお客様 ID account_type GOOGLE_ADS
login_account	account_id データ パートナー アカウントのお客様 ID account_type DATA_PARTNER
linked_account	account_id Google 広告 MCC アカウントのお客様 ID account_type GOOGLE_ADS
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 アカウント [e-mail] の認証情報を使用して、オーディエンス メンバー データを 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 アカウントにデータを送信できます。

1. データ パートナー アカウントとディスプレイ＆ビデオ 360 のパートナー アカウントまたは広告主アカウントの間の直接パートナー リンクを使用します。
2. データ パートナー アカウントと広告主の親ディスプレイ＆ビデオ 360 パートナー アカウント間のパートナー リンクを使用して、ディスプレイ＆ビデオ 360 広告主にデータを送信します。

直接パートナー リンクのシナリオ

ディスプレイ＆ビデオ 360 の広告主にデータを送信する場合で、パートナー リンクがディスプレイ＆ビデオ 360 の広告主アカウントとデータ パートナー アカウントの間にある場合:

取り込み

宛先
operating_account	account_id ディスプレイ＆ビデオ 360 広告主アカウントの ID account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id データ パートナー アカウントのお客様 ID account_type DATA_PARTNER
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	account_id ディスプレイ＆ビデオ 360 パートナー アカウントの ID account_type DISPLAY_VIDEO_PARTNER
login_account	account_id データ パートナー アカウントのお客様 ID account_type DATA_PARTNER
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 のパートナー アカウントに設定されます。

取り込み

宛先
operating_account	account_id ディスプレイ＆ビデオ 360 広告主アカウントの ID account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id データ パートナー アカウントのお客様 ID account_type DATA_PARTNER
linked_account	account_id ディスプレイ＆ビデオ 360 パートナー アカウントの ID account_type DISPLAY_VIDEO_PARTNER
product_destination_id	オーディエンスまたはコンバージョン アクションの ID。

リソース管理

リクエスト ヘッダー
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

以下は、パートナー リンク シナリオの Destination の例です。データ パートナーと広告主の親ディスプレイ＆ビデオ 360 パートナー間のパートナー リンクを使用して、ディスプレイ＆ビデオ 360 広告主にデータを送信します。

取り込み

{
  "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 アド マネージャー

Google アド マネージャー アカウントにデータを送信する場合、データ パートナー アカウントと Google アド マネージャー アカウントの間にパートナー リンクがある場合は、次の操作を行います。

取り込み

宛先
operating_account	account_id Google アド マネージャー アカウントのオーディエンス リンク ID account_type GOOGLE_AD_MANAGER_AUDIENCE_LINK
login_account	account_id データ パートナー アカウントのお客様 ID account_type DATA_PARTNER
linked_account	linked_account フィールドは設定しないでください。
product_destination_id	オーディエンスの ID。

リソース管理

リクエスト ヘッダー
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	linked-account ヘッダーは設定しないでください。

パートナー リンクを使用して Google アド マネージャー アカウントにデータを送信する Destination の例を次に示します。

取り込み

      {
        "destinations": [
          {
            "operatingAccount": {
              "accountId": "GAM_AUDIENCE_LINK_ID",
              "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK"
            },
            "loginAccount": {
              "accountId": "DATA_PARTNER_ID",
              "accountType": "DATA_PARTNER"
            },
            "productDestinationId": "AUDIENCE_ID"
          }
        ]
      }
      

リソース管理

リクエスト ヘッダー
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	linked-account ヘッダーは設定しないでください。

Google アナリティクス

Data Manager API は、パートナー リンクを使用した Google アナリティクス アカウントへのデータの送信をサポートしていません。代わりに、Google アナリティクスの広告主シナリオのアプローチを使用してください。

Floodlight

Data Manager API は、パートナー リンクを使用した Floodlight 設定へのデータの送信をサポートしていません。代わりに、Floodlight の広告主シナリオのアプローチを使用してください。

詳細な要件

このセクションでは、IngestionService リクエストの Destination のアカウント フィールドの詳細な要件、リソース管理リクエストに相当するリクエスト ヘッダー、product_destination_id の設定方法のヒント、認証情報がアクセスできる場所を特定する方法について説明します。

アカウント フィールド

Destination には、最大 3 つの異なるアカウントを設定できます。

operating_account

operating_account は必須です。

operating_account は、リクエストでデータを受信するアカウントを示します。operating_account には次のいずれかを指定できます。

• Google 広告アカウント
• ディスプレイ＆ビデオ 360 広告主アカウント
• ディスプレイ＆ビデオ 360 パートナー アカウント
• Google アド マネージャー アカウント
• Google アナリティクスのプロパティ
• データ パートナー アカウントが所有するオーディエンスにデータを送信する場合は、データ パートナー アカウント。

Destination の operating_account フィールドに対応するリクエスト ヘッダーはありません。リソース管理リクエストを送信する場合、リクエストのターゲット アカウントはオペレーティング アカウントです。

login_account フィールドと login-account リクエスト ヘッダー

login_account は常に必須ではなく、IngestionService リクエストではデフォルトで operating_account になり、リソース管理リクエストではターゲット アカウントになります。リソース管理リクエストでは、login-account リクエスト ヘッダーを使用してログイン アカウントを識別します。

Data Manager API は、次の点を確認します。

1. 認証情報の Google アカウントが、ログイン アカウントのユーザーである。

2. ログイン アカウントは次のいずれかです。

   • operating_account と同じです。これは、IngestionService リクエストで Destination の login_account を設定しない場合、またはリソース管理リクエストで login-account ヘッダーを設定しない場合のデフォルトです。

   • IngestionService リクエストの operating_account の親、またはリソース管理リクエストのターゲット アカウントの親である Google 広告マネージャーまたはディスプレイ＆ビデオ 360 パートナー アカウント。

   • IngestionService リクエストの linked_account へのパートナー リンク、またはリソース管理リクエストの linked-account ヘッダーを持つデータ パートナー アカウント。

linked_account フィールドと linked-account リクエスト ヘッダー

注: リンクされたアカウントを指定するのは、ログイン アカウントの account_type が DATA_PARTNER に設定され、operating_account の親がデータ パートナー アカウントにリンクされている場合のみです。operating_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 広告の管理画面または Data Manager API を使用して取得します。

Google 広告の管理画面

Google 広告の管理画面からオーディエンス ID を取得するには:

1. Google 広告の管理画面で [オーディエンス マネージャー] に移動します。
2. オーディエンス名をクリックして詳細を表示します。
3. オーディエンス ID は [リスト ID] の横に表示されます。

Data Manager API

List メソッドを使用して UserList を取得し、必要に応じてリクエスト ヘッダーを指定します。商品の宛先 ID には UserList の id を使用します。

Google 広告イベント

イベントを取り込むためのプロダクトのリンク先 ID は、コンバージョン アクション ID です。この ID は、Google 広告の管理画面または Google Ads API を使用して取得します。

Google 広告の管理画面

Google 広告の管理画面からコンバージョン アクション ID を取得するには:

1. Google 広告 UI の [コンバージョン] に移動します。
2. コンバージョン アクション名をクリックします。
3. [詳細] タブに移動します。
4. コンバージョン アクション ID は、[コンバージョンの種類 ID] の横に表示されている番号です。

Google Ads API

Google Ads API からコンバージョン アクション ID を取得するには:

1. 次のクエリを使用して、Search または SearchStream リクエストを GoogleAdsService に送信します。

     SELECT
       conversion_action.id,
       conversion_action.name
     FROM conversion_action
     WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'
   

2. レスポンスの 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 の管理画面

ディスプレイ＆ビデオ 360 の管理画面からオーディエンス ID を取得するには:

1. ディスプレイ＆ビデオ 360 の管理画面（https://displayvideo.google.com）にログインします。
2. operating_account で使用しているディスプレイ＆ビデオ 360 のパートナーまたは広告主に移動します。
3. 左側のメニューから [オーディエンス] に移動し、[すべてのオーディエンス] を選択します。
4. リストからオーディエンスを見つけます。オーディエンス ID は、[名前] 列の名前の横にある番号です。

Data Manager API

List メソッドを使用して UserList を取得し、必要に応じてリクエスト ヘッダーを指定します。商品の宛先 ID には UserList の id を使用します。

Google アナリティクスのイベント

サービス デスティネーション ID は、データ ストリームのタイプによって異なります。

ウェブデータ ストリーム

データ ストリームの測定 ID を使用します。

アプリデータ ストリーム

データ ストリームの Firebase アプリ ID を使用します。Firebase アプリ ID を確認する方法は 2 つあります。

• Google アナリティクスの管理画面で [データ ストリーム] に移動し、データ ストリームをクリックして [FIREBASE アプリ ID] を探します。
• Firebase コンソールを使用する。

Floodlight イベント

Floodlight にイベントを取り込むためのプロダクトのデスティネーション ID は、Floodlight アクティビティ ID です。この ID は、キャンペーン マネージャー 360 の管理画面またはキャンペーン マネージャー 360 API を使用して取得します。

キャンペーン マネージャー 360 の管理画面

キャンペーン マネージャー 360 の管理画面から Floodlight アクティビティ ID を取得するには:

1. キャンペーン マネージャー 360 の管理画面にログインします。
2. operating_account で使用しているキャンペーン マネージャー 360 の広告主に移動します。
3. 左側のメニューで [Floodlight] に移動し、[アクティビティ] を選択します。
4. リストで Floodlight アクティビティを見つけます。ID は、[アクティビティ名] 列の名前の横にある番号です。

キャンペーン マネージャー 360 API

Campaign Manager 360 API から Floodlight アクティビティ ID を取得するには:

1. list リクエストを floodlightActivities リソースに送信します。
2. Floodlight 設定の floodlightConfigurationId を指定します。
3. 必要に応じて、searchString パラメータを使用してアクティビティ名でフィルタします。
4. レスポンスで選択した FloodlightActivity の id フィールドから Floodlight アクティビティ ID を取得します。

認証情報がアクセスできる場所を特定する

Data Manager API リクエストの認可に使用する認証情報は、特定の Google アカウントに関連付けられています。

• ユーザー認証情報を使用する場合、認証情報の生成時にユーザーの代わりに操作する権限を付与したユーザーの Google アカウントとしてリクエストが承認されます。
• サービス アカウントの認証情報を使用すると、リクエストはサービス アカウントの Google アカウントとして認可されます。

認証情報の Google アカウントが、Google 広告、ディスプレイ＆ビデオ 360、Google アナリティクス、キャンペーン マネージャー 360 のアカウントにアクセスできることを確認する方法は次のとおりです。

Google 広告またはデータ パートナー

1. login_account の Google 広告 UI で [アクセスとセキュリティ] に移動します。
2. [ユーザー] タブを選択します。
3. login_account が Google 広告 MCC アカウントの場合は、[全階層のユーザーを表示する] 切り替えボタンをオフにして、子アカウントのユーザーを非表示にします。
4. 認証情報の Google アカウントが、[ユーザー] タブに表示されているアカウントのリストに含まれていることを確認します。

ディスプレイ＆ビデオ 360

1. ディスプレイ＆ビデオ 360 の管理画面で [ユーザー管理とメール設定] に移動します。
2. [ユーザー管理] で、認証情報の Google アカウントが login_account のユーザーであることを確認します。

Google アナリティクス

1. Google アナリティクスの管理画面で、プロパティのアクセス管理に移動します。
2. login_account で指定した Google アナリティクスのプロパティが選択されていることを確認します。
3. 認証情報の Google アカウントに、プロパティに対する編集者または管理者のロールがあることを確認します。

Floodlight（キャンペーン マネージャー 360）

1. キャンペーン マネージャー 360 の管理画面にログインします。
2. 左側のメニューで [管理] > [ユーザー プロフィール] に移動します。
3. 認証情報の Google アカウントが、表示されたプロファイルのリストに含まれていることを確認します。
4. プロファイルをクリックし、login_account として使用されている広告主アカウントへのアクセス権があることを確認します。リクエストで login_account を設定しない場合、デフォルトで operating_account になります。アカウントに、オフライン コンバージョンの挿入権限を持つユーザーロールがあることを確認します。