กำหนดค่าปลายทางและส่วนหัว

ทั้งแนวคิดของ Destination และส่วนหัวของคำขอจะปรากฏขึ้น บ่อยครั้งเมื่อทำงานกับ Data Manager API อ่านคู่มือนี้เพื่อทำความเข้าใจ วิธีกำหนดค่าปลายทางและส่วนหัวสำหรับสถานการณ์ต่างๆ

เมื่อใดควรใช้ปลายทางหรือส่วนหัว

• ใช้ Destination ในคำขอส่งผ่านข้อมูล คำขอส่งผ่านข้อมูลใช้ IngestionService เพื่อเพิ่มหรือ นำสมาชิกออกจากกลุ่มเป้าหมาย หรือส่งเหตุการณ์ destinations รายการใน IngestAudienceMembersRequest หรือ IngestEventsRequest จะกำหนดสิ่งต่อไปนี้

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

  คุณใส่ปลายทางหลายแห่งในคำขอส่งผ่านข้อมูลเดียวกันได้

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

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

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

สลับไปมาระหว่างรายละเอียดในคู่มือนี้สำหรับคำขอแต่ละประเภทโดยคลิกแท็บการส่งผ่านข้อมูลหรือการจัดการทรัพยากรที่อยู่รอบๆ ตารางแต่ละตาราง

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

• Google Ads
• Display & Video 360
• Google Analytics

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

• Google Ads
• Display & Video 360
• Google Analytics

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

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

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

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 ให้ทำดังนี้

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

ตัวอย่างสถานการณ์การเข้าถึงระดับผู้จัดการสำหรับบัญชีลูกค้า 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 ที่เป็นผู้ใช้ในบัญชีผู้ลงโฆษณา ให้ทำดังนี้

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

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

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

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

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

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

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

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

Google Analytics

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

ตัวอย่าง 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 หรือพาร์ทเนอร์ข้อมูลแต่ละบัญชี รวมถึงลิงก์ผลิตภัณฑ์ระหว่างบัญชีด้วย

พาร์ทเนอร์ด้านข้อมูล 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

• พาร์ทเนอร์ข้อมูล D1 ลิงก์กับบัญชีดูแลจัดการ Google Ads นี่คือ ตัวอย่างสถานการณ์การลิงก์ผลิตภัณฑ์ของบัญชีดูแลจัดการ
• พาร์ทเนอร์ข้อมูล D2 ลิงก์กับบัญชีลูกค้า Google Ads นี่คือ ตัวอย่างสถานการณ์ลิงก์ผลิตภัณฑ์โดยตรง

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

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

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

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

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

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

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

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

ต่อไปนี้เป็นตัวอย่างของ 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สำหรับคำขอIngestionService ส่วนหัวของคำขอที่เทียบเท่าสำหรับคำขอการจัดการทรัพยากร เคล็ดลับในการตั้งค่าproduct_destination_id และวิธีพิจารณาว่าข้อมูลเข้าสู่ระบบของคุณมีสิทธิ์เข้าถึงที่ใด

ฟิลด์บัญชี

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

operating_account

operating_account ต้องระบุ

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

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

ไม่มีส่วนหัวของคำขอที่สอดคล้องกับฟิลด์ operating_account ของ Destination เมื่อส่งคำขอการจัดการทรัพยากร บัญชีเป้าหมายของคำขอคือบัญชีปฏิบัติการ

ฟิลด์ login_account และส่วนหัวของคำขอ login-account

login_account ไม่ได้จำเป็นเสมอไป และค่าเริ่มต้นคือ operating_account ในคำขอ IngestionService และ บัญชีเป้าหมายในคำขอการจัดการทรัพยากร ในคำขอการจัดการทรัพยากร ให้ใช้ส่วนหัวคำขอ login-account เพื่อระบุบัญชีเข้าสู่ระบบ

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

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

2. บัญชีที่ใช้เข้าสู่ระบบคือบัญชีใดบัญชีหนึ่งต่อไปนี้

   • เหมือนกับ operating_account นี่คือค่าเริ่มต้นหากคุณไม่ได้ตั้งค่า login_account ของ Destination ในคำขอ IngestionService หรือไม่ได้ตั้งค่าส่วนหัว login-account ในคำขอการจัดการทรัพยากร

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

   • บัญชีพาร์ทเนอร์ด้านข้อมูลที่มีลิงก์ผลิตภัณฑ์ไปยัง linked_account ในคำขอ IngestionService หรือส่วนหัว linked-account ในคำขอการจัดการทรัพยากร

ฟิลด์ linked_account และส่วนหัวของคำขอ linked-account

linked_account แสดงบัญชีที่มีลิงก์ผลิตภัณฑ์ไปยัง login_account ของคำขอ IngestionService หรือบัญชีเป้าหมายของคำขอการจัดการทรัพยากร

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

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

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

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

รหัสปลายทางของผลิตภัณฑ์สำหรับการส่งผ่านข้อมูลสมาชิกในกลุ่มเป้าหมายคือรหัสกลุ่มเป้าหมาย ดึงข้อมูลรหัสนี้โดยใช้ UI ของ Google Ads หรือ Data Manager API

Google Ads UI

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

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

Data Manager API

เรียกข้อมูล UserList โดยใช้เมธอด List ระบุส่วนหัวของคำขอหากจำเป็น และใช้ id ของ UserList สำหรับรหัสปลายทางผลิตภัณฑ์

เหตุการณ์ 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 หรือ Data Manager API

UI ของ Display & Video 360

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

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

Data Manager API

เรียกข้อมูล UserList โดยใช้เมธอด List ระบุส่วนหัวของคำขอหากจำเป็น และใช้ id ของ UserList สำหรับรหัสปลายทางผลิตภัณฑ์

เหตุการณ์ 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 สำหรับข้อมูลเข้าสู่ระบบมี บทบาทผู้แก้ไขหรือผู้ดูแลระบบ ในพร็อพเพอร์ตี้