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)

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

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

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

string (int64 format)

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

หากขนาดน้อยกว่า 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)

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

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

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

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

string (int64 format)

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

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

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

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

string (int64 format)

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

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

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

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

string

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

ใช้ได้เฉพาะกับ 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)
    }
  ]
}
ช่อง
contactInfos[]

object (ContactInfo)

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

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

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

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

MobileDeviceIdList

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

การแสดง JSON 
{
  "mobileDeviceIds": [
    string
  ]
}
ช่อง
mobileDeviceIds[]

string

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

วิธีการ

create

 สร้าง FirstAndThirdPartyAudience

editCustomerMatchMembers

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

get

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

list

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

patch

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