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)

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

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

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

string (int64 format)

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

หากขนาดน้อยกว่า 1000 ระบบจะซ่อนตัวเลขและแสดงผล 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)

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

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

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

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

string (int64 format)

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

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

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

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

string (int64 format)

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

หากขนาดน้อยกว่า 1,000 ระบบจะซ่อนตัวเลขและแสดงผลเป็น 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 ที่มีอยู่