REST Resource: firstPartyAndPartnerAudiences

ทรัพยากร: FirstPartyAndPartnerAudience

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

การแสดง JSON 
{
  "name": string,
  "firstPartyAndPartnerAudienceId": string,
  "displayName": string,
  "description": string,
  "firstPartyAndPartnerAudienceType": enum (FirstPartyAndPartnerAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string
}
ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของกลุ่มเป้าหมายบุคคลที่หนึ่งและกลุ่มเป้าหมายของพาร์ทเนอร์
firstPartyAndPartnerAudienceId

string (int64 format)

ตัวระบุ รหัสที่ไม่ซ้ำกันของกลุ่มเป้าหมายบุคคลที่หนึ่งและกลุ่มเป้าหมายของพาร์ทเนอร์ กำหนดโดยระบบ
displayName

string

ไม่บังคับ ชื่อที่แสดงของกลุ่มเป้าหมายบุคคลที่หนึ่งและกลุ่มเป้าหมายของพาร์ทเนอร์
description

string

ไม่บังคับ คําอธิบายกลุ่มเป้าหมายที่ผู้ใช้ระบุ

ใช้ได้กับกลุ่มเป้าหมายบุคคลที่หนึ่งเท่านั้น
firstPartyAndPartnerAudienceType

enum (FirstPartyAndPartnerAudienceType)

เอาต์พุตเท่านั้น กลุ่มเป้าหมายเป็นกลุ่มเป้าหมายบุคคลที่หนึ่งและกลุ่มเป้าหมายของพาร์ทเนอร์หรือไม่
audienceType

enum (AudienceType)

เปลี่ยนแปลงไม่ได้ ประเภทของกลุ่มเป้าหมาย
audienceSource

enum (AudienceSource)

เอาต์พุตเท่านั้น แหล่งที่มาของกลุ่มเป้าหมาย
membershipDurationDays

string (int64 format)

ไม่บังคับ ระยะเวลาเป็นจำนวนวันที่รายการจะยังคงอยู่ในกลุ่มเป้าหมายหลังจากเหตุการณ์ที่เข้าเกณฑ์ ค่าที่ตั้งไว้ต้องมากกว่า 0 และน้อยกว่าหรือเท่ากับ 540

ใช้ได้กับกลุ่มเป้าหมายบุคคลที่หนึ่งเท่านั้น

ต้องระบุข้อมูลในช่องนี้หากใช้ audienceType อย่างใดอย่างหนึ่งต่อไปนี้

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

เอาต์พุตเท่านั้น ขนาดกลุ่มเป้าหมายโดยประมาณสำหรับเครือข่าย Display

หากขนาดน้อยกว่า 1, 000 ระบบจะซ่อนตัวเลขและแสดงผลเป็น 0 เนื่องจากเหตุผลด้านความเป็นส่วนตัว ไม่เช่นนั้น ระบบจะปัดเศษตัวเลขให้เหลือเลขนัยสำคัญ 2 หลัก

แสดงผลในคำขอ GET เท่านั้น
activeDisplayAudienceSize

string (int64 format)

เอาต์พุตเท่านั้น ขนาดกลุ่มเป้าหมายโดยประมาณสำหรับเครือข่าย Display ในเดือนที่ผ่านมา

หากขนาดน้อยกว่า 1, 000 ระบบจะซ่อนตัวเลขและแสดงผลเป็น 0 เนื่องจากเหตุผลด้านความเป็นส่วนตัว ไม่เช่นนั้น ระบบจะปัดเศษตัวเลขให้เหลือเลขนัยสำคัญ 2 หลัก

แสดงผลในคำขอ GET เท่านั้น
youtubeAudienceSize

string (int64 format)

เอาต์พุตเท่านั้น ขนาดกลุ่มเป้าหมายโดยประมาณสำหรับเครือข่าย YouTube

หากขนาดน้อยกว่า 1, 000 ระบบจะซ่อนตัวเลขและแสดงผลเป็น 0 เนื่องจากเหตุผลด้านความเป็นส่วนตัว ไม่เช่นนั้น ระบบจะปัดเศษตัวเลขให้เหลือเลขนัยสำคัญ 2 หลัก

ใช้ได้กับกลุ่มเป้าหมายบุคคลที่หนึ่งเท่านั้น

แสดงผลในคำขอ GET เท่านั้น
gmailAudienceSize

string (int64 format)

เอาต์พุตเท่านั้น ขนาดกลุ่มเป้าหมายโดยประมาณสำหรับเครือข่าย Gmail

หากขนาดน้อยกว่า 1, 000 ระบบจะซ่อนตัวเลขและแสดงผลเป็น 0 เนื่องจากเหตุผลด้านความเป็นส่วนตัว ไม่เช่นนั้น ระบบจะปัดเศษตัวเลขให้เหลือเลขนัยสำคัญ 2 หลัก

ใช้ได้กับกลุ่มเป้าหมายบุคคลที่หนึ่งเท่านั้น

แสดงผลในคำขอ GET เท่านั้น
displayMobileAppAudienceSize

string (int64 format)

เอาต์พุตเท่านั้น ขนาดกลุ่มเป้าหมายโดยประมาณของแอปบนอุปกรณ์เคลื่อนที่ในเครือข่าย Display

หากขนาดน้อยกว่า 1, 000 ระบบจะซ่อนตัวเลขและแสดงผลเป็น 0 เนื่องจากเหตุผลด้านความเป็นส่วนตัว ไม่เช่นนั้น ระบบจะปัดเศษตัวเลขให้เหลือเลขนัยสำคัญ 2 หลัก

ใช้ได้กับกลุ่มเป้าหมายบุคคลที่หนึ่งเท่านั้น

แสดงผลในคำขอ GET เท่านั้น
displayMobileWebAudienceSize

string (int64 format)

เอาต์พุตเท่านั้น ขนาดกลุ่มเป้าหมายโดยประมาณบนเว็บบนมือถือในเครือข่าย Display

หากขนาดน้อยกว่า 1, 000 ระบบจะซ่อนตัวเลขและแสดงผลเป็น 0 เนื่องจากเหตุผลด้านความเป็นส่วนตัว ไม่เช่นนั้น ระบบจะปัดเศษตัวเลขให้เหลือเลขนัยสำคัญ 2 หลัก

ใช้ได้กับกลุ่มเป้าหมายบุคคลที่หนึ่งเท่านั้น

แสดงผลในคำขอ GET เท่านั้น
displayDesktopAudienceSize

string (int64 format)

เอาต์พุตเท่านั้น ขนาดกลุ่มเป้าหมายบนเดสก์ท็อปโดยประมาณในเครือข่าย Display

หากขนาดน้อยกว่า 1, 000 ระบบจะซ่อนตัวเลขและแสดงผลเป็น 0 เนื่องจากเหตุผลด้านความเป็นส่วนตัว ไม่เช่นนั้น ระบบจะปัดเศษตัวเลขให้เหลือเลขนัยสำคัญ 2 หลัก

ใช้ได้กับกลุ่มเป้าหมายบุคคลที่หนึ่งเท่านั้น

แสดงผลในคำขอ GET เท่านั้น
appId

string

ไม่บังคับ appId ตรงกับประเภทของ mobileDeviceIds ที่อัปโหลด

ใช้ได้กับ audienceType CUSTOMER_MATCH_DEVICE_ID เท่านั้น

FirstPartyAndPartnerAudienceType

ประเภทที่เป็นไปได้ของทรัพยากรกลุ่มเป้าหมายบุคคลที่หนึ่งและพาร์ทเนอร์

Enum
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED ค่าเริ่มต้นเมื่อไม่ได้ระบุประเภทหรือไม่รู้จักประเภท
TYPE_FIRST_PARTY กลุ่มเป้าหมายที่สร้างขึ้นผ่านการใช้ข้อมูลลูกค้า
TYPE_PARTNER กลุ่มเป้าหมายที่ได้จากผู้ให้บริการข้อมูลบุคคลที่สาม

AudienceType

ประเภทกลุ่มเป้าหมายที่เป็นไปได้

Enum
AUDIENCE_TYPE_UNSPECIFIED ค่าเริ่มต้นเมื่อไม่ได้ระบุประเภทหรือไม่รู้จักประเภท
CUSTOMER_MATCH_CONTACT_INFO ระบบสร้างกลุ่มเป้าหมายผ่านการจับคู่ลูกค้ากับข้อมูลติดต่อที่ทราบ
CUSTOMER_MATCH_DEVICE_ID กลุ่มเป้าหมายสร้างขึ้นจากการจับคู่ลูกค้ากับรหัสอุปกรณ์เคลื่อนที่ที่รู้จัก
CUSTOMER_MATCH_USER_ID ระบบสร้างกลุ่มเป้าหมายโดยการจับคู่ลูกค้ากับรหัสผู้ใช้ที่รู้จัก
ACTIVITY_BASED

เลิกใช้งานแล้ว: กลุ่มเป้าหมายสร้างขึ้นตามกิจกรรมแคมเปญ
FREQUENCY_CAP

เลิกใช้งานแล้ว: กลุ่มเป้าหมายสร้างขึ้นโดยอิงตามการยกเว้นจำนวนการแสดงผลที่แสดง
TAG_BASED ระบบสร้างกลุ่มเป้าหมายตามตัวแปรที่กำหนดเองซึ่งแนบมากับพิกเซล
YOUTUBE_USERS กลุ่มเป้าหมายสร้างขึ้นจากการโต้ตอบที่ผ่านมากับวิดีโอ โฆษณา YouTube หรือช่อง YouTube
THIRD_PARTY กลุ่มเป้าหมายได้รับอนุญาตให้ใช้งานจากบุคคลที่สาม
COMMERCE กลุ่มเป้าหมายที่พาร์ทเนอร์เชิงพาณิชย์จัดหาให้โดยมีค่าธรรมเนียม
LINEAR ผู้ชมเนื้อหาทีวีแบบดั้งเดิม
AGENCY กลุ่มเป้าหมายที่เอเจนซีระบุ

AudienceSource

แหล่งที่มาของกลุ่มเป้าหมายที่เป็นไปได้

Enum
AUDIENCE_SOURCE_UNSPECIFIED ค่าเริ่มต้นเมื่อไม่ได้ระบุแหล่งที่มาของกลุ่มเป้าหมายหรือไม่ทราบแหล่งที่มา
DISPLAY_VIDEO_360 มาจาก Display & Video 360
CAMPAIGN_MANAGER มาจาก Campaign Manager 360
AD_MANAGER มาจาก Google Ad Manager
SEARCH_ADS_360 มาจาก Search Ads 360
YOUTUBE มาจาก YouTube
ADS_DATA_HUB มาจาก Ads Data Hub

เมธอด

get

 รับกลุ่มเป้าหมายบุคคลที่หนึ่งหรือกลุ่มเป้าหมายของพาร์ทเนอร์

list

 แสดงรายการกลุ่มเป้าหมายบุคคลที่หนึ่งและกลุ่มเป้าหมายของพาร์ทเนอร์