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,

  // Union field members can be only one of the following:
  "contactInfoList": {
    object (ContactInfoList)
  },
  "mobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of list of possible types for union field members.
}
ช่อง
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 เท่านั้น
ฟิลด์ Union members สมาชิกเริ่มต้นของกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้า members ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
contactInfoList

object (ContactInfoList)

อินพุตเท่านั้น รายชื่อข้อมูลติดต่อเพื่อกำหนดสมาชิกกลุ่มเป้าหมายเริ่มต้น

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

object (MobileDeviceIdList)

อินพุตเท่านั้น รายการรหัสอุปกรณ์เคลื่อนที่เพื่อกำหนดสมาชิกกลุ่มเป้าหมายเริ่มต้น

ใช้ได้กับ 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

ContactInfoList

ข้อความ Wrapper สำหรับรายชื่อข้อมูลติดต่อที่กำหนดสมาชิกกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้า

การแสดง JSON 
{
  "contactInfos": [
    {
      object (ContactInfo)
    }
  ],
  "consent": {
    object (Consent)
  }
}
ช่อง
contactInfos[]

object (ContactInfo)

รายการออบเจ็กต์ ContactInfo ที่กําหนดสมาชิกกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้า ขนาดของสมาชิกหลังจากแยก contactInfos ต้องไม่เกิน 500,000
consent

object (Consent)

อินพุตเท่านั้น การตั้งค่าความยินยอมสำหรับผู้ใช้ใน contactInfos

การเว้นว่างช่องนี้ไว้หมายความว่าไม่ได้ระบุความยินยอม

หากตั้งค่าฟิลด์ adUserData หรือ adPersonalization เป็น CONSENT_STATUS_DENIED คำขอจะแสดงข้อผิดพลาด

ContactInfo

ข้อมูลติดต่อที่ระบุสมาชิกกลุ่มเป้าหมายการจับคู่ข้อมูลลูกค้า

การแสดง JSON 
{
  "hashedEmails": [
    string
  ],
  "hashedPhoneNumbers": [
    string
  ],
  "zipCodes": [
    string
  ],
  "hashedFirstName": string,
  "hashedLastName": string,
  "countryCode": string
}
ช่อง
hashedEmails[]

string

รายการอีเมลที่แฮช SHA256 ของสมาชิก ก่อนทำการแฮช ให้นำช่องว่างทั้งหมดออกและตรวจสอบว่าสตริงเป็นตัวพิมพ์เล็กทั้งหมด
hashedPhoneNumbers[]

string

รายการหมายเลขโทรศัพท์ที่แฮช SHA256 ของสมาชิก ก่อนทำการแฮช หมายเลขโทรศัพท์ทั้งหมดต้องจัดรูปแบบโดยใช้รูปแบบ E.164 และมีรหัสการโทรของประเทศ
zipCodes[]

string

รายการรหัสไปรษณีย์ของสมาชิก

ต้องตั้งค่าด้วยช่องต่อไปนี้ด้วย
hashedFirstName

string

ชื่อจริงของสมาชิกที่แฮช SHA256 ก่อนทำการแฮช ให้นำช่องว่างทั้งหมดออกและตรวจสอบว่าสตริงเป็นตัวพิมพ์เล็กทั้งหมด

ต้องตั้งค่าด้วยช่องต่อไปนี้ด้วย
hashedLastName

string

นามสกุลของสมาชิกที่แฮชด้วย SHA256 ก่อนทำการแฮช ให้นำช่องว่างทั้งหมดออกและตรวจสอบว่าสตริงเป็นตัวพิมพ์เล็กทั้งหมด

ต้องตั้งค่าด้วยช่องต่อไปนี้ด้วย
countryCode

string

รหัสประเทศของสมาชิก

ต้องตั้งค่าด้วยช่องต่อไปนี้ด้วย

ConsentStatus

สถานะความยินยอม

Enum
CONSENT_STATUS_UNSPECIFIED ไม่ได้ระบุค่าประเภทหรือค่าประเภทไม่รู้จักในเวอร์ชันนี้
CONSENT_STATUS_GRANTED ได้รับความยินยอมแล้ว
CONSENT_STATUS_DENIED ระบบปฏิเสธคำยินยอม

MobileDeviceIdList

ข้อความ Wrapper สำหรับรายการรหัสอุปกรณ์เคลื่อนที่ที่กำหนดสมาชิกกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้า

การแสดง JSON 
{
  "mobileDeviceIds": [
    string
  ],
  "consent": {
    object (Consent)
  }
}
ช่อง
mobileDeviceIds[]

string

รายการรหัสอุปกรณ์เคลื่อนที่ที่กำหนดสมาชิกกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้า ขนาดของ mobileDeviceIds ต้องไม่เกิน 500,000
consent

object (Consent)

อินพุตเท่านั้น การตั้งค่าความยินยอมสำหรับผู้ใช้ใน mobileDeviceIds

การเว้นว่างช่องนี้ไว้หมายความว่าไม่ได้ระบุความยินยอม

หากตั้งค่าฟิลด์ adUserData หรือ adPersonalization เป็น CONSENT_STATUS_DENIED คำขอจะแสดงข้อผิดพลาด

เมธอด

create

 สร้าง FirstPartyAndPartnerAudience

editCustomerMatchMembers

 อัปเดตรายชื่อสมาชิกของกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้า

get

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

list

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

patch

 อัปเดต FirstPartyAndPartnerAudience ที่มีอยู่