กำหนดค่าปลายทาง

Destination แต่ละรายการใน IngestAudienceMembersRequest หรือ IngestEventsRequest จะกำหนดสิ่งต่อไปนี้

  1. บัญชีที่รับข้อมูล เช่น บัญชี Google Ads หรือ พร็อพเพอร์ตี้ Google Analytics
  2. เอนทิตีปลายทางสําหรับข้อมูลภายในบัญชี เช่น การกระทําที่ถือเป็น Conversion ของ Google Ads หรือสตรีม Google Analytics
  3. เส้นทางการเข้าถึงสำหรับข้อมูลเข้าสู่ระบบของคำขอไปยังบัญชีที่รับข้อมูล

หากคุณเป็นผู้ลงโฆษณาหรือเอเจนซี ให้ไปที่ สถานการณ์ของผู้ลงโฆษณาเพื่อดูตัวอย่างวิธีสร้าง Destination

หากคุณเป็นพาร์ทเนอร์ด้านข้อมูล ให้ไปที่ สถานการณ์ของพาร์ทเนอร์ด้านข้อมูลเพื่อดูตัวอย่างวิธีสร้าง Destination เพื่อส่งข้อมูลไปยังบัญชีที่มีลิงก์ผลิตภัณฑ์ไปยังบัญชีพาร์ทเนอร์ด้านข้อมูลของคุณ

ส่วนข้อกำหนดโดยละเอียดจะครอบคลุมข้อกำหนดและกฎการตรวจสอบอย่างละเอียด

สถานการณ์ของผู้ลงโฆษณา

วิธีกำหนดค่า Destination สำหรับสถานการณ์ทั่วไปของผู้ลงโฆษณา และเอเจนซีมีดังนี้ แผนภาพนี้แสดงวิธีที่ Data Manager API ใช้ข้อมูลเข้าสู่ระบบและฟิลด์ Destination เพื่อเข้าถึงบัญชีผู้ลงโฆษณา

เส้นทางการเข้าถึงของผู้ลงโฆษณา

Google Ads

ต่อไปนี้คือแผนภาพที่แสดงตัวอย่างชุดบัญชี Google Ads และผู้ใช้

บัญชีและผู้ใช้ Google Ads

บัญชีดูแลจัดการ M1

M1 มีบัญชีย่อยโดยตรง 2 บัญชี ได้แก่

  1. บัญชีดูแลจัดการ M2
  2. บัญชีลูกค้า C1

บัญชี Google cloudysanfrancisco@gmail.com เป็นผู้ใช้ใน M1

บัญชีดูแลจัดการ M2

M2 มีบัญชีย่อยโดยตรง 2 บัญชี ได้แก่

  1. บัญชีลูกค้า C1
  2. บัญชีลูกค้า C2

บัญชี Google baklavainthebalkans@gmail.com เป็นผู้ใช้ใน M2

บัญชีลูกค้า C1

C1 มีบัญชีดูแลจัดการระดับบนสุดโดยตรง 2 บัญชี ได้แก่

  1. บัญชีดูแลจัดการ M1
  2. บัญชีดูแลจัดการ M2

บัญชี Google jeffersonloveshiking@gmail.com เป็นผู้ใช้ใน C1

บัญชีลูกค้า C2

บัญชีดูแลจัดการ M2 เป็นบัญชีหลักโดยตรงเพียงบัญชีเดียวของ C2

ไม่มีบัญชี Google ที่แสดงเป็นผู้ใช้ใน C2

สถานการณ์การเข้าถึงโดยตรงและสถานการณ์การเข้าถึงของผู้จัดการแสดงวิธีที่คุณจะกำหนดค่าปลายทางเพื่อส่งข้อมูลไปยังบัญชีเหล่านี้

สถานการณ์การเข้าถึงโดยตรง

หากต้องการส่งข้อมูลไปยังบัญชี Google Ads และข้อมูลเข้าสู่ระบบของคุณเป็นของ บัญชี Google ที่เป็นผู้ใช้ในบัญชี Google Ads ให้ทำดังนี้

ปลายทาง
operating_account
account_id รหัสลูกค้าของบัญชี Google Ads
account_type GOOGLE_ADS
login_account ไม่ตั้งค่า login_account หรือตั้งค่าให้เหมือนกับ ค่าของ operating_account
linked_account อย่าตั้งค่าช่อง linked_account
product_destination_id รหัสของกลุ่มเป้าหมายหรือการกระทำที่ถือเป็น Conversion

ต่อไปนี้คือตัวอย่างสถานการณ์การเข้าถึงโดยตรง โดยใช้บัญชีจากไดอะแกรมและข้อมูลเข้าสู่ระบบสำหรับบัญชี 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"
    }
  ]
}

สถานการณ์การเข้าถึงระดับผู้จัดการ

หากต้องการส่งข้อมูลไปยังบัญชี Google Ads และข้อมูลเข้าสู่ระบบของคุณเป็นของ บัญชี Google ที่เป็นผู้ใช้ในบัญชีดูแลจัดการ Google Ads ซึ่งบัญชี ผู้ลงโฆษณาเป็นบัญชีย่อย ให้ทำดังนี้

ปลายทาง
operating_account
account_id รหัสลูกค้าของบัญชีลูกค้า Google Ads
account_type GOOGLE_ADS
login_account
account_id รหัสลูกค้าของบัญชีดูแลจัดการ Google Ads
account_type GOOGLE_ADS
linked_account อย่าตั้งค่าช่อง linked_account
product_destination_id รหัสของกลุ่มเป้าหมายหรือการกระทำที่ถือเป็น Conversion

ตัวอย่างสถานการณ์การเข้าถึงระดับผู้จัดการสำหรับบัญชีลูกค้า Google Ads 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"
    }
  ]
}

ต่อไปนี้เป็นอีกตัวอย่างหนึ่งของสถานการณ์การเข้าถึงระดับผู้จัดการสำหรับบัญชีลูกค้า Google Ads C2 และข้อมูลเข้าสู่ระบบสำหรับบัญชี Google cloudysanfrancisco@gmail.com ซึ่งเป็นผู้ใช้ในบัญชีดูแลจัดการ Google Ads M1

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Display & Video 360

คุณส่งข้อมูลไปยัง Display & Video 360 ได้ 2 วิธี ดังนี้

  1. การเข้าถึงโดยตรง ซึ่งข้อมูลเข้าสู่ระบบเป็นของบัญชี Google ที่เป็น ผู้ใช้ในบัญชีผู้ลงโฆษณาหรือพาร์ทเนอร์ Display & Video 360
  2. สิทธิ์เข้าถึงพาร์ทเนอร์ Display & Video 360 ซึ่งข้อมูลเข้าสู่ระบบเป็นของบัญชี Google ที่เป็นผู้ใช้ในบัญชีพาร์ทเนอร์ Display & Video 360 และบัญชีที่ดำเนินการเป็น บัญชีผู้ลงโฆษณา Display & Video 360 ภายใต้บัญชีพาร์ทเนอร์

สถานการณ์การเข้าถึงโดยตรง

หากต้องการส่งข้อมูลไปยังบัญชีผู้ลงโฆษณา Display & Video 360 และข้อมูลเข้าสู่ระบบ เป็นของบัญชี Google ที่เป็นผู้ใช้ในบัญชีผู้ลงโฆษณา ให้ทำดังนี้

ปลายทาง
operating_account
account_id รหัสของบัญชีผู้ลงโฆษณา Display & Video 360
account_type DISPLAY_VIDEO_ADVERTISER
login_account ไม่ตั้งค่า login_account หรือตั้งค่าให้เหมือนกับ ค่าของ operating_account
linked_account อย่าตั้งค่าช่อง linked_account
product_destination_id รหัสของกลุ่มเป้าหมาย

ต่อไปนี้คือตัวอย่าง Destination สำหรับสถานการณ์การเข้าถึงโดยตรงเพื่อส่งข้อมูล ไปยังผู้ลงโฆษณา Display & Video 360

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

ในทำนองเดียวกัน หากคุณต้องการส่งข้อมูลไปยังบัญชีพาร์ทเนอร์ Display & Video 360 และข้อมูลเข้าสู่ระบบของคุณเป็นของบัญชี Google ที่เป็นผู้ใช้ในบัญชีพาร์ทเนอร์ ให้ทำดังนี้

ปลายทาง
operating_account
account_id รหัสของบัญชีพาร์ทเนอร์ Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
login_account ไม่ตั้งค่า login_account หรือตั้งค่าให้เหมือนกับ ค่าของ operating_account
linked_account อย่าตั้งค่าช่อง linked_account
product_destination_id รหัสของกลุ่มเป้าหมาย

ต่อไปนี้คือตัวอย่าง Destination สำหรับสถานการณ์การเข้าถึงโดยตรงเพื่อส่งข้อมูล ไปยังพาร์ทเนอร์ Display & Video 360

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

สถานการณ์การเข้าถึงพาร์ทเนอร์ Display & Video 360

หากต้องการส่งข้อมูลไปยังผู้ลงโฆษณา Display & Video 360 และข้อมูลเข้าสู่ระบบของคุณเป็นของ บัญชี Google ที่เป็นผู้ใช้ในพาร์ทเนอร์ Display & Video 360 หลักของผู้ลงโฆษณา

ปลายทาง
operating_account
account_id รหัสของบัญชีผู้ลงโฆษณา Display & Video 360
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id รหัสของบัญชีพาร์ทเนอร์ Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
linked_account อย่าตั้งค่าช่อง linked_account
product_destination_id รหัสของกลุ่มเป้าหมาย

นี่คือตัวอย่างของ Destination สำหรับสถานการณ์การเข้าถึงของพาร์ทเนอร์เพื่อส่งข้อมูล ไปยังผู้ลงโฆษณา Display & Video 360 ในสถานการณ์นี้ ข้อมูลเข้าสู่ระบบต้องเป็นของบัญชี Google ที่เป็นผู้ใช้ในบัญชีพาร์ทเนอร์ Display & Video 360 PARTNER_ID และบัญชีผู้ลงโฆษณา Display & Video 360 ADVERTISER_ID ต้องเป็นบัญชีย่อยของบัญชีพาร์ทเนอร์ PARTNER_ID

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Google Analytics

หมายเหตุ: operating_account และ login_account ต้องเหมือนกันเมื่อปลายทางเป็นบัญชี Google Analytics มิฉะนั้น คำขอจะล้มเหลวเนื่องจากข้อผิดพลาด OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH

ปลายทาง
operating_account
account_id รหัสของพร็อพเพอร์ตี้ Google Analytics
account_type GOOGLE_ANALYTICS_PROPERTY
login_account ไม่ตั้งค่า login_account หรือตั้งค่าให้เหมือนกับ ค่าของ operating_account
linked_account อย่าตั้งค่าช่อง linked_account
product_destination_id รหัสการวัดของสตรีมข้อมูล

ตัวอย่าง Destination สำหรับการส่งเหตุการณ์ไปยัง Google Analytics มีดังนี้

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}

สถานการณ์ของพาร์ทเนอร์ด้านข้อมูล

วิธีกำหนดค่า Destination สำหรับสถานการณ์ทั่วไปของพาร์ทเนอร์ด้านข้อมูล ที่ส่งข้อมูลไปยังบัญชีผู้ลงโฆษณาที่มีลิงก์ผลิตภัณฑ์ที่สร้างไว้แล้วไปยัง บัญชีพาร์ทเนอร์ด้านข้อมูลมีดังนี้

แผนภาพนี้แสดงวิธีที่ Data Manager API ใช้ข้อมูลเข้าสู่ระบบและฟิลด์ Destination เพื่อเข้าถึงบัญชีผู้ลงโฆษณาผ่านลิงก์ผลิตภัณฑ์

เส้นทางการเข้าถึงพาร์ทเนอร์ด้านข้อมูล

Google Ads

นี่คือแผนภาพที่แสดงตัวอย่างชุดบัญชี Google Ads และพาร์ทเนอร์ข้อมูล แผนภาพยังแสดงบัญชี Google ที่เป็นผู้ใช้ในบัญชี Google Ads หรือพาร์ทเนอร์ข้อมูลแต่ละบัญชี รวมถึงลิงก์ผลิตภัณฑ์ระหว่างบัญชีด้วย

บัญชีและผู้ใช้พาร์ทเนอร์ข้อมูลและ Google Ads

พาร์ทเนอร์ด้านข้อมูล D1

มีการลิงก์ผลิตภัณฑ์ระหว่าง D1 กับบัญชีผู้จัดการ Google Ads M2

บัญชี Google 222larabrown@gmail.com เป็นผู้ใช้ใน D1

พาร์ทเนอร์ด้านข้อมูล D2

มีการลิงก์ผลิตภัณฑ์ระหว่าง D2 กับบัญชีลูกค้า Google Ads C1

บัญชี Google jeffersonloveshiking@gmail.com เป็นผู้ใช้ใน D2

บัญชีดูแลจัดการ M1

M1 มีบัญชีย่อยโดยตรง 2 บัญชี ได้แก่

  1. บัญชีดูแลจัดการ M2
  2. บัญชีลูกค้า C1
บัญชีดูแลจัดการ M2

M2 มีบัญชีย่อยโดยตรง 2 บัญชี ได้แก่

  1. บัญชีลูกค้า C1
  2. บัญชีลูกค้า C2
บัญชีลูกค้า C1

C1 มีบัญชีดูแลจัดการระดับบนสุดโดยตรง 2 บัญชี ได้แก่

  1. บัญชีดูแลจัดการ M1
  2. บัญชีดูแลจัดการ M2
บัญชีลูกค้า C2

บัญชีดูแลจัดการ M2 เป็นบัญชีหลักโดยตรงเพียงบัญชีเดียวของ C2

คุณสามารถทำสิ่งต่อไปนี้ได้ด้วยชุดบัญชีนี้

ทำหน้าที่เป็นพาร์ทเนอร์ด้านข้อมูล D1

หากต้องการทำหน้าที่เป็นพาร์ทเนอร์ด้านข้อมูล D1 ให้ใช้ข้อมูลเข้าสู่ระบบสำหรับบัญชี Google 222larabrown@gmail.com เพื่อส่งข้อมูลไปยังบัญชีดูแลจัดการ M2, บัญชีลูกค้า C1 หรือบัญชีลูกค้า C2 โดยใช้ปลายทางที่มี login_account ตั้งค่าเป็นบัญชีพาร์ทเนอร์ด้านข้อมูล D1 และ linked_account ตั้งค่าเป็นบัญชีดูแลจัดการ M2

ในฐานะพาร์ทเนอร์ด้านข้อมูล D1 คุณจะส่งข้อมูลไปยังบัญชีดูแลจัดการ M1 ไม่ได้เนื่องจากไม่มีลิงก์ผลิตภัณฑ์ระหว่าง D1 กับ M1

ทำหน้าที่เป็นพาร์ทเนอร์ด้านข้อมูล D2

หากต้องการทำหน้าที่เป็นพาร์ทเนอร์ด้านข้อมูล D2 ให้ใช้ข้อมูลเข้าสู่ระบบสำหรับบัญชี Google jeffersonloveshiking@gmail.com เพื่อส่งข้อมูลไปยังบัญชีลูกค้า C1 โดยใช้ปลายทางที่มี login_account ตั้งค่าเป็นบัญชีพาร์ทเนอร์ด้านข้อมูล D2 และ linked_account ตั้งค่าเป็นบัญชีลูกค้า C1

ในฐานะพาร์ทเนอร์ด้านข้อมูล D2 คุณจะส่งข้อมูลไปยังบัญชีดูแลจัดการ M1, บัญชีดูแลจัดการ M2 หรือบัญชีลูกค้า C2 ไม่ได้เนื่องจากไม่มีลิงก์ผลิตภัณฑ์ระหว่าง D2 กับบัญชีเหล่านั้นหรือบัญชีดูแลจัดการหลักของบัญชีเหล่านั้น

ความแตกต่างที่สำคัญระหว่างพาร์ทเนอร์ข้อมูล D1 กับ D2 คือวิธีที่พาร์ทเนอร์ข้อมูล ลิงก์กับบัญชี Google Ads

สถานการณ์ลิงก์ผลิตภัณฑ์โดยตรง

หากต้องการส่งข้อมูลไปยังบัญชี Google Ads และลิงก์ผลิตภัณฑ์อยู่ ระหว่างบัญชี Google Ads กับบัญชีพาร์ทเนอร์ข้อมูล ให้ทำดังนี้

ปลายทาง
operating_account
account_id รหัสลูกค้าของบัญชี Google Ads
account_type GOOGLE_ADS
login_account
account_id รหัสลูกค้าของบัญชีพาร์ทเนอร์ด้านข้อมูล
account_type DATA_PARTNER
linked_account อย่าตั้งค่าช่อง linked_account
product_destination_id รหัสของกลุ่มเป้าหมายหรือการกระทำที่ถือเป็น Conversion

ต่อไปนี้คือตัวอย่างสถานการณ์ลิงก์ผลิตภัณฑ์โดยตรงโดยใช้บัญชีจากแผนภาพ ในสถานการณ์นี้ พาร์ทเนอร์ข้อมูล D2 จะส่งข้อมูลสมาชิกกลุ่มเป้าหมายไปยังลูกค้า C1 ของ Google Ads โดยใช้ลิงก์ผลิตภัณฑ์ระหว่าง D2 กับ C1 และข้อมูลเข้าสู่ระบบสำหรับบัญชี Google jeffersonloveshiking@gmail.com

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

สถานการณ์การลิงก์ผลิตภัณฑ์ของผู้จัดการ

หากต้องการส่งข้อมูลไปยังบัญชี Google Ads และลิงก์ผลิตภัณฑ์อยู่ ระหว่างบัญชีดูแลจัดการ Google Ads หลักกับบัญชีพาร์ทเนอร์ด้านข้อมูล ให้ทำดังนี้

ปลายทาง
operating_account
account_id รหัสลูกค้าของบัญชีลูกค้า Google Ads
account_type GOOGLE_ADS
login_account
account_id รหัสลูกค้าของบัญชีพาร์ทเนอร์ด้านข้อมูล
account_type DATA_PARTNER
linked_account
account_id รหัสลูกค้าของบัญชีดูแลจัดการ Google Ads
account_type GOOGLE_ADS
product_destination_id รหัสของกลุ่มเป้าหมายหรือการกระทำที่ถือเป็น Conversion

ต่อไปนี้คือตัวอย่างสถานการณ์การลิงก์ผลิตภัณฑ์ของบัญชีดูแลจัดการโดยใช้บัญชีจากไดอะแกรม ในสถานการณ์นี้ พาร์ทเนอร์ข้อมูล D1 จะส่งข้อมูลสมาชิกกลุ่มเป้าหมายไปยังลูกค้า C2 ของ Google Ads โดยใช้ลิงก์ผลิตภัณฑ์ระหว่าง D1 กับ M2 และข้อมูลเข้าสู่ระบบสำหรับบัญชี Google 222larabrown@gmail.com ดังนี้

{
  "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"
    }
  ]
}

Display & Video 360

ในฐานะพาร์ทเนอร์ด้านข้อมูล คุณสามารถส่งข้อมูลไปยังบัญชี Display & Video 360 ได้ 2 วิธี ดังนี้

  1. ใช้ลิงก์ผลิตภัณฑ์โดยตรงระหว่างบัญชีพาร์ทเนอร์ข้อมูลกับบัญชีพาร์ทเนอร์หรือบัญชีผู้ลงโฆษณา Display & Video 360
  2. ส่งข้อมูลไปยังผู้ลงโฆษณา Display & Video 360 โดยใช้ลิงก์ผลิตภัณฑ์ระหว่างบัญชีพาร์ทเนอร์ข้อมูล กับบัญชีพาร์ทเนอร์ Display & Video 360 หลักของผู้ลงโฆษณา

หากต้องการส่งข้อมูลไปยังผู้ลงโฆษณา Display & Video 360 และลิงก์ผลิตภัณฑ์อยู่ ระหว่างบัญชีผู้ลงโฆษณา Display & Video 360 กับบัญชีพาร์ทเนอร์ข้อมูล ให้ทำดังนี้

ปลายทาง
operating_account
account_id รหัสของบัญชีผู้ลงโฆษณา Display & Video 360
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id รหัสลูกค้าของบัญชีพาร์ทเนอร์ด้านข้อมูล
account_type DATA_PARTNER
linked_account อย่าตั้งค่าช่อง linked_account
product_destination_id รหัสของกลุ่มเป้าหมายหรือการกระทำที่ถือเป็น Conversion

ตัวอย่าง Destination สำหรับสถานการณ์ลิงก์ผลิตภัณฑ์โดยตรงเพื่อส่งข้อมูลไปยังผู้ลงโฆษณา Display & Video 360 มีดังนี้

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

หากต้องการส่งข้อมูลไปยังบัญชีพาร์ทเนอร์ Display & Video 360 คุณต้องมีลิงก์ผลิตภัณฑ์ ระหว่างบัญชีพาร์ทเนอร์ Display & Video 360 กับบัญชีพาร์ทเนอร์ข้อมูล

ปลายทาง
operating_account
account_id รหัสของบัญชีพาร์ทเนอร์ Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
login_account
account_id รหัสลูกค้าของบัญชีพาร์ทเนอร์ด้านข้อมูล
account_type DATA_PARTNER
linked_account อย่าตั้งค่าช่อง linked_account
product_destination_id รหัสของกลุ่มเป้าหมายหรือการกระทำที่ถือเป็น Conversion

ตัวอย่าง Destination สำหรับสถานการณ์ลิงก์ผลิตภัณฑ์โดยตรงเพื่อส่งข้อมูลไปยังพาร์ทเนอร์ Display & Video 360 มีดังนี้

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

หากต้องการส่งข้อมูลไปยังผู้ลงโฆษณา Display & Video 360 และลิงก์ผลิตภัณฑ์ไปยัง บัญชีพาร์ทเนอร์ข้อมูลของคุณกับบัญชีพาร์ทเนอร์ Display & Video 360 ที่บัญชีผู้ลงโฆษณา เป็นบัญชีย่อย ให้ทำดังนี้

ปลายทาง
operating_account
account_id รหัสของบัญชีผู้ลงโฆษณา Display & Video 360
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id รหัสลูกค้าของบัญชีพาร์ทเนอร์ด้านข้อมูล
account_type DATA_PARTNER
linked_account
account_id รหัสของบัญชีพาร์ทเนอร์ Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
product_destination_id รหัสของกลุ่มเป้าหมายหรือการกระทำที่ถือเป็น Conversion

ต่อไปนี้เป็นตัวอย่างของ Destination สำหรับสถานการณ์การลิงก์ผลิตภัณฑ์พาร์ทเนอร์เพื่อส่งข้อมูลไปยังผู้ลงโฆษณา Display & Video 360 โดยใช้ลิงก์ผลิตภัณฑ์ระหว่างพาร์ทเนอร์ข้อมูลกับพาร์ทเนอร์ Display & Video 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"
    }
  ]
}

Google Analytics

Data Manager API ไม่รองรับการส่งข้อมูลไปยังบัญชี Google Analytics โดยใช้ลิงก์ผลิตภัณฑ์ โปรดใช้แนวทางสถานการณ์ของผู้ลงโฆษณาสำหรับ Google Analytics แทน

ข้อกำหนดโดยละเอียด

ส่วนนี้มีข้อกำหนดโดยละเอียดสำหรับฟิลด์บัญชีของ Destination เคล็ดลับในการตั้งค่า product_destination_id และ วิธีพิจารณาว่าข้อมูลเข้าสู่ระบบของคุณมีสิทธิ์เข้าถึงที่ใด

ฟิลด์บัญชี

Destination มีบัญชีที่แตกต่างกันได้สูงสุด 3 บัญชี ดังนี้

operating_account

operating_account ต้องระบุ

operating_account ระบุบัญชีที่ได้รับข้อมูลในคำขอ operating_account อาจเป็นค่าใดก็ได้ต่อไปนี้

login_account

login_account ไม่จำเป็นเสมอไป และค่าเริ่มต้นคือ operating_account

Data Manager API จะตรวจสอบสิ่งต่อไปนี้

  1. บัญชี Google ของข้อมูลเข้าสู่ระบบคือผู้ใช้ใน login_account

  2. login_account เป็นค่าใดค่าหนึ่งต่อไปนี้

    • เหมือนกับ operating_account โดยระบบจะใช้ค่านี้เป็นค่าเริ่มต้นหากคุณไม่ได้ตั้งค่า login_account

    • บัญชีดูแลจัดการ Google Ads หรือ พาร์ทเนอร์ Display & Video 360 ที่เป็นบัญชีหลัก ของ operating_account

    • บัญชีพาร์ทเนอร์ด้านข้อมูลที่มีลิงก์ผลิตภัณฑ์ไปยัง linked_account

linked_account

linked_account แสดงบัญชีที่มีลิงก์ผลิตภัณฑ์ไปยัง login_account

รหัสปลายทางของผลิตภัณฑ์

product_destination_id ของ Destination จะระบุออบเจ็กต์ใน operating_account ที่รับข้อมูล เช่น อาจเป็นรหัสกลุ่มเป้าหมาย สำหรับ Google Ads หรือ Display & Video 360, รหัสการกระทำที่ถือเป็น Conversion สำหรับ Google Ads หรือรหัสการวัดสำหรับสตรีม Google Analytics

วิธีค้นหารหัสสำหรับปลายทางผลิตภัณฑ์แต่ละประเภทมีดังนี้

กลุ่มเป้าหมาย Google Ads

รหัสปลายทางของผลิตภัณฑ์สำหรับการส่งผ่านข้อมูลสมาชิกในกลุ่มเป้าหมายคือรหัสกลุ่มเป้าหมาย

วิธีรับรหัสกลุ่มเป้าหมายจาก UI ของ Google Ads

  1. ไปที่ตัวจัดการกลุ่มเป้าหมายใน UI ของ Google Ads
  2. คลิกชื่อกลุ่มเป้าหมายเพื่อดูรายละเอียด
  3. รหัสกลุ่มเป้าหมายจะแสดงอยู่ข้างรหัสรายการ

วิธีรับรหัสกลุ่มเป้าหมายจาก Google Ads API

  1. ส่งคำขอ Search หรือ SearchStream ไปยัง GoogleAdsService พร้อมคำค้นหาต่อไปนี้

    SELECT
      user_list.id,
      user_list.name
    FROM user_list
    WHERE user_list.name = 'USER_LIST_NAME'
    
  2. รับรหัสผู้ชมจากช่อง id ใน user_list ในการตอบกลับ

    [
      {
        "results": [
          {
            "userList": {
              "resourceName": "customers/CUSTOMER_ID/userLists/USER_LIST_ID",
              "id": "USER_LIST_ID",
              "name": "USER_LIST_NAME"
            }
          }
        ]
      }
    ]
    

เหตุการณ์ Google Ads

รหัสปลายทางผลิตภัณฑ์สําหรับการนําเข้าเหตุการณ์คือรหัสการกระทําที่ถือเป็น Conversion

วิธีรับรหัสการกระทําที่ถือเป็น Conversion จาก UI ของ Google Ads

  1. ไปที่ Conversion ใน UI ของ Google Ads
  2. คลิกชื่อการกระทำที่ถือเป็น Conversion เพื่อดูรายละเอียด
  3. รหัสการกระทำที่ถือเป็น Conversion คือค่าของพารามิเตอร์การค้นหา URL ที่ชื่อ ctId

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

วิธีรับรหัสการกระทําที่ถือเป็น Conversion จาก Google Ads API

  1. ส่งคำขอ Search หรือ SearchStream ไปยัง GoogleAdsService พร้อมคำค้นหาต่อไปนี้

    SELECT
      conversion_action.id,
      conversion_action.name
    FROM conversion_action
    WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'
    
  2. รับรหัสการกระทำที่ถือเป็น Conversion จากidฟิลด์ในconversion_action ในการตอบกลับ

    [
      {
        "results": [
          {
            "conversionAction": {
              "resourceName": "customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID",
              "id": "CONVERSION_ACTION_ID",
              "name": "CONVERSION_ACTION_NAME"
            }
          }
        ]
      }
    ]
    

กลุ่มเป้าหมาย Display & Video 360

รหัสปลายทางของผลิตภัณฑ์สำหรับการส่งผ่านข้อมูลสมาชิกในกลุ่มเป้าหมายคือรหัสกลุ่มเป้าหมาย

วิธีรับรหัสกลุ่มเป้าหมายจาก UI ของ Display & Video 360

  1. ลงชื่อเข้าใช้ UI ของ Display & Video 360 ที่ https://displayvideo.google.com
  2. ไปที่พาร์ทเนอร์หรือผู้ลงโฆษณา Display & Video 360 ที่คุณใช้สำหรับ operating_account
  3. ไปที่กลุ่มเป้าหมายในเมนูด้านซ้าย แล้วเลือกกลุ่มเป้าหมายทั้งหมด
  4. ค้นหากลุ่มเป้าหมายในรายการ รหัสกลุ่มเป้าหมายคือตัวเลขข้างชื่อในคอลัมน์ชื่อ

เหตุการณ์ Google Analytics

รหัสปลายทางของผลิตภัณฑ์สําหรับการนําเข้าเหตุการณ์คือรหัสการวัดของสตรีมข้อมูล

กำหนดว่าข้อมูลเข้าสู่ระบบมีสิทธิ์เข้าถึงที่ใด

ข้อมูลเข้าสู่ระบบที่คุณใช้เพื่อให้สิทธิ์คำขอ Data Manager API จะ เชื่อมโยงกับบัญชี Google ที่เฉพาะเจาะจง

  • หากใช้ข้อมูลเข้าสู่ระบบของผู้ใช้ คำขอจะได้รับอนุญาตในฐานะบัญชี Google ของ ผู้ใช้ที่ให้สิทธิ์ในการดำเนินการในนามของตนเมื่อคุณสร้าง ข้อมูลเข้าสู่ระบบ
  • หากคุณใช้ข้อมูลเข้าสู่ระบบของบัญชีบริการ ระบบจะให้สิทธิ์คำขอในฐานะบัญชี Google ของบัญชีบริการ

วิธีตรวจสอบว่าบัญชี Google สำหรับข้อมูลเข้าสู่ระบบของคุณมีสิทธิ์เข้าถึงบัญชี Google Ads, Display & Video 360 หรือ Google Analytics หรือไม่

Google Ads หรือพาร์ทเนอร์ด้านข้อมูล

  1. ไปที่การเข้าถึงและความปลอดภัย ใน UI ของ Google Ads สำหรับ login_account
  2. เลือกแท็บผู้ใช้
  3. หาก login_account เป็นบัญชีดูแลจัดการ Google Ads ให้ปิดปุ่มสลับแสดงผู้ใช้ทั้งลำดับชั้นเพื่อซ่อนผู้ใช้จากบัญชีย่อย
  4. ตรวจสอบว่าบัญชี Google สำหรับข้อมูลเข้าสู่ระบบของคุณอยู่ในรายการบัญชีที่แสดงในแท็บผู้ใช้

Display & Video 360

  1. ไปที่ การจัดการผู้ใช้และการตั้งค่าอีเมล ใน UI ของ Display & Video 360
  2. ตรวจสอบว่าการจัดการผู้ใช้แสดงว่าบัญชี Google สำหรับข้อมูลเข้าสู่ระบบ ของคุณเป็นผู้ใช้ใน login_account

Google Analytics

  1. ไปที่การจัดการการเข้าถึงพร็อพเพอร์ตี้ ใน UI ของ Google Analytics
  2. ตรวจสอบว่าได้เลือกพร็อพเพอร์ตี้ Google Analytics ที่ระบุใน login_account แล้ว
  3. ตรวจสอบว่าบัญชี Google สำหรับข้อมูลเข้าสู่ระบบมี บทบาทผู้แก้ไขหรือผู้ดูแลระบบ ในพร็อพเพอร์ตี้