REST Resource: firstAndThirdPartyAudiences

แหล่งข้อมูล: FirstAndThirdPartyAudience

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

การแสดง JSON 
{
  "name": string,
  "firstAndThirdPartyAudienceId": string,
  "displayName": string,
  "description": string,
  "firstAndThirdPartyAudienceType": enum (FirstAndThirdPartyAudienceType),
  "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

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

string (int64 format)

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

string

ชื่อที่แสดงของผู้ชมบุคคลที่หนึ่งและบุคคลที่สาม
description

string

คำอธิบายกลุ่มเป้าหมายที่ผู้ใช้ให้ไว้

มีผลกับกลุ่มเป้าหมายบุคคลที่หนึ่งเท่านั้น
firstAndThirdPartyAudienceType

enum (FirstAndThirdPartyAudienceType)

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

enum (AudienceType)

ประเภทของกลุ่มเป้าหมาย
audienceSource

enum (AudienceSource)

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

string (int64 format)

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

มีผลกับกลุ่มเป้าหมายบุคคลที่หนึ่งเท่านั้น

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

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

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

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

แสดงเฉพาะในคำขอ GET
activeDisplayAudienceSize

string (int64 format)

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

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

แสดงเฉพาะในคำขอ GET
youtubeAudienceSize

string (int64 format)

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

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

มีผลกับกลุ่มเป้าหมายบุคคลที่หนึ่งเท่านั้น

ส่งคืนในคำขอ GET เท่านั้น
gmailAudienceSize

string (int64 format)

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

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

มีผลกับกลุ่มเป้าหมายบุคคลที่หนึ่งเท่านั้น

ส่งคืนในคำขอ GET เท่านั้น
displayMobileAppAudienceSize

string (int64 format)

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

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

มีผลกับกลุ่มเป้าหมายบุคคลที่หนึ่งเท่านั้น

ส่งคืนในคำขอ GET เท่านั้น
displayMobileWebAudienceSize

string (int64 format)

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

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

มีผลกับกลุ่มเป้าหมายบุคคลที่หนึ่งเท่านั้น

ส่งคืนในคำขอ GET เท่านั้น
displayDesktopAudienceSize

string (int64 format)

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

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

มีผลกับกลุ่มเป้าหมายบุคคลที่หนึ่งเท่านั้น

แสดงเฉพาะในคำขอ GET
appId

string

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

ใช้ได้กับ audienceType CUSTOMER_MATCH_DEVICE_ID เท่านั้น
ฟิลด์สหภาพ members สมาชิกเริ่มต้นของกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้า members ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
contactInfoList

object (ContactInfoList)

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

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

object (MobileDeviceIdList)

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

มีผลกับ audienceType CUSTOMER_MATCH_DEVICE_ID เท่านั้น

FirstAndThirdPartyAudienceType

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

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

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 ที่ผ่านมา
LICENSED ประเภทย่อยของประเภทกลุ่มเป้าหมายบุคคลที่สาม

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

 สร้าง FirstAndThirdPartyAudience

editCustomerMatchMembers

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

get

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

list

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

patch

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