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

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

宛先またはヘッダーを使用する場合

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

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

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

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

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

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

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

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

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

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

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

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

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

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

広告主様のシナリオ

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

Google 広告

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

クライアント センター（MCC）アカウント M1

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

1. クライアント センター（MCC）アカウント M2
2. クライアント アカウント C1

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

クライアント センター（MCC）アカウント M2

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

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

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

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

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

1. クライアント センター（MCC）アカウント M1
2. クライアント センター（MCC）アカウント 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 広告 MCC アカウントのユーザーである 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 の UI で広告主 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 のユーザーです。

クライアント センター（MCC）アカウント M1

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

1. クライアント センター（MCC）アカウント M2
2. クライアント アカウント C1

クライアント センター（MCC）アカウント M2

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

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

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

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

1. クライアント センター（MCC）アカウント M1
2. クライアント センター（MCC）アカウント M2

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

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

このアカウント セットでは、次のことができます。

データ パートナー D1 として行動する

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

データ パートナー D1 は、D1 とクライアント センター（MCC）アカウント M1 の間にパートナー リンクがないため、M1 にデータを送信できません。

データ パートナー D2 として行動する

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

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

データ パートナー 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

以下は、データ パートナーと広告主の親ディスプレイ＆ビデオ 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 アナリティクスの広告主様のシナリオのアプローチを使用してください。

Floodlight

Data Manager API は、パートナー リンクを使用して Floodlight 設定にデータを送信することをサポートしていません。代わりに、Floodlight の広告主様のシナリオの手法を使用してください。

詳細な要件

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

アカウント フィールド

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

operating_account

operating_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 は、次のことを確認します。

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

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

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

   • Google 広告のクライアント センター（MCC）アカウントまたは ディスプレイ＆ビデオ 360 のパートナー アカウント。IngestionService リクエストの operating_account の親、またはリソース管理リクエストのターゲット アカウントの親。

   • 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 を取得し、必要に応じてリクエスト ヘッダーを指定します。また、UserList の id を商品アイテムの送信先 ID として使用します。

Google 広告イベント

イベントの取り込みに使用するプロダクトのリンク先 ID は、コンバージョン アクション ID です。

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

1. Google 広告の管理画面で [コンバージョン] に移動します。
2. コンバージョン アクション名をクリックすると、詳細が表示されます。

3. コンバージョン アクション ID は、ctId という名前の URL クエリ パラメータの値です。

     https://ads.google.com/aw/conversions/detail?ocid=...&ctId=CONVERSION_ACTION_ID&...
   

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

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

     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 の UI

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

1. https://displayvideo.google.com でディスプレイ＆ビデオ 360 の管理画面にログインします。
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 の UI またはキャンペーン マネージャー 360 API を使用して取得します。

キャンペーン マネージャー 360 の UI

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

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

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

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

1. floodlightActivities リソースに list リクエストを送信します。
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 の UI で [ユーザー管理とメール設定] に移動します。
2. [ユーザー管理] に、認証情報の Google アカウントが login_account のユーザーとして表示されていることを確認します。

Google アナリティクス

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

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

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