UserList

รายชื่อผู้ใช้ นี่คือรายชื่อผู้ใช้ที่ลูกค้าอาจกำหนดเป้าหมาย

การแสดง JSON 
{
  "resourceName": string,
  "membershipStatus": enum (UserListMembershipStatus),
  "sizeRangeForDisplay": enum (UserListSizeRange),
  "sizeRangeForSearch": enum (UserListSizeRange),
  "type": enum (UserListType),
  "closingReason": enum (UserListClosingReason),
  "accessReason": enum (AccessReason),
  "accountUserListStatus": enum (UserListAccessStatus),
  "id": string,
  "readOnly": boolean,
  "name": string,
  "description": string,
  "integrationCode": string,
  "membershipLifeSpan": string,
  "sizeForDisplay": string,
  "sizeForSearch": string,
  "eligibleForSearch": boolean,
  "eligibleForDisplay": boolean,
  "matchRatePercentage": integer,

  // Union field user_list can be only one of the following:
  "crmBasedUserList": {
    object (CrmBasedUserListInfo)
  },
  "similarUserList": {
    object (SimilarUserListInfo)
  },
  "ruleBasedUserList": {
    object (RuleBasedUserListInfo)
  },
  "logicalUserList": {
    object (LogicalUserListInfo)
  },
  "basicUserList": {
    object (BasicUserListInfo)
  }
  // End of list of possible types for union field user_list.
}
ช่อง
resourceName

string

เปลี่ยนแปลงไม่ได้ ชื่อทรัพยากรของรายชื่อผู้ใช้ ชื่อทรัพยากรของรายชื่อผู้ใช้มีรูปแบบดังนี้

customers/{customerId}/userLists/{userListId}
membershipStatus

enum (UserListMembershipStatus)

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

enum (UserListSizeRange)

เอาต์พุตเท่านั้น ช่วงขนาดในแง่ของจำนวนผู้ใช้รายการผู้ใช้ในเครือข่ายดิสเพลย์ของ Google

ช่องนี้เป็นแบบอ่านอย่างเดียว
type

enum (UserListType)

เอาต์พุตเท่านั้น ประเภทของรายการนี้

ช่องนี้เป็นแบบอ่านอย่างเดียว
closingReason

enum (UserListClosingReason)

การระบุเหตุผลที่ปิดสถานะการเป็นสมาชิกในรายชื่อผู้ใช้นี้ ข้อมูลนี้จะเพิ่มลงในรายการที่ปิดโดยอัตโนมัติเนื่องจากไม่มีการใช้งานเท่านั้น และระบบจะล้างออกเมื่อสถานะการเป็นสมาชิกในรายการเปิดขึ้น
accessReason

enum (AccessReason)

เอาต์พุตเท่านั้น ระบุเหตุผลที่บัญชีนี้ได้รับสิทธิ์เข้าถึงรายการ สามารถแชร์เหตุผล เป็นเจ้าของ ได้รับอนุญาต หรือติดตามแล้ว

ช่องนี้เป็นแบบอ่านอย่างเดียว
accountUserListStatus

enum (UserListAccessStatus)

ระบุว่ายังเปิดใช้การแชร์นี้อยู่หรือไม่ เมื่อมีการแชร์ UserList กับผู้ใช้ ค่านี้จะตั้งเป็น ENABLED ภายหลัง เจ้าของ userList สามารถตัดสินใจที่จะเพิกถอนการแชร์และปิดใช้สิทธิ์ดังกล่าว ค่าเริ่มต้นของช่องนี้ตั้งค่าเป็น ENABLED
id

string (int64 format)

เอาต์พุตเท่านั้น รหัสของรายชื่อผู้ใช้
readOnly

boolean

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

ช่องนี้เป็นแบบอ่านอย่างเดียว
name

string

ชื่อของรายชื่อผู้ใช้นี้ ชื่อรายชื่อผู้ใช้อาจซ้ำกันได้ (เช่น if accessreason=SHARED) ทั้งนี้ขึ้นอยู่กับการเข้าถึงเหตุผล
description

string

คำอธิบายของรายชื่อผู้ใช้นี้
integrationCode

string

รหัสจากระบบภายนอก โดยผู้ขายรายชื่อผู้ใช้จะใช้ข้อมูลดังกล่าวเพื่อเชื่อมโยงรหัสในระบบของผู้ขาย
membershipLifeSpan

string (int64 format)

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

ระบบจะไม่สนใจช่องนี้สำหรับประเภท LogUserList และ rulesBasedUserList การเป็นสมาชิกในรายการประเภทเหล่านี้ขึ้นอยู่กับกฎที่กำหนดโดยรายการ
sizeForDisplay

string (int64 format)

เอาต์พุตเท่านั้น จำนวนผู้ใช้โดยประมาณในรายการผู้ใช้นี้ในเครือข่ายดิสเพลย์ของ Google ค่านี้จะเป็น Null หากยังไม่ได้กำหนดจำนวนผู้ใช้

ช่องนี้เป็นแบบอ่านอย่างเดียว
eligibleForDisplay

boolean

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

ช่องนี้เป็นแบบอ่านอย่างเดียว
matchRatePercentage

integer

เอาต์พุตเท่านั้น ระบุอัตราการจับคู่สำหรับรายการการจับคู่ข้อมูลลูกค้า ช่วงของฟิลด์นี้คือ [0-100] ตัวแปรนี้จะไม่มีข้อมูลสําหรับรายการประเภทอื่นๆ หรือเมื่อคํานวณอัตราการจับคู่ไม่ได้

ช่องนี้เป็นแบบอ่านอย่างเดียว

ฟิลด์สหภาพ user_list รายชื่อผู้ใช้

ต้องตั้งค่าหนึ่งรายการเท่านั้น user_list ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
crmBasedUserList

object (CrmBasedUserListInfo)

รายชื่อผู้ใช้ของผู้ใช้ CRM ที่ผู้ลงโฆษณาให้ไว้
similarUserList

object (SimilarUserListInfo)

เอาต์พุตเท่านั้น รายการผู้ใช้ที่คล้ายกับผู้ใช้จากรายการ UserList อื่น รายการเหล่านี้เป็นแบบอ่านอย่างเดียวและสร้างโดยอัตโนมัติโดย Google
ruleBasedUserList

object (RuleBasedUserListInfo)

รายการผู้ใช้ที่สร้างโดยกฎ
logicalUserList

object (LogicalUserListInfo)

รายการผู้ใช้คือชุดค่าผสมของรายชื่อผู้ใช้และความสนใจของผู้ใช้ที่กำหนดเอง
basicUserList

object (BasicUserListInfo)

การกำหนดเป้าหมายรายการผู้ใช้เป็นคอลเล็กชันการกระทำที่ถือเป็น Conversion หรือรีมาร์เก็ตติ้ง

UserListMembershipStatus

ennum ที่มีสถานะการเป็นสมาชิกในรายชื่อผู้ใช้ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
OPEN สถานะเปิด - รายการกำลังมีสมาชิกและสามารถกำหนดเป้าหมายได้
CLOSED สถานะปิดแล้ว - ไม่มีการเพิ่มสมาชิกใหม่ ไม่สามารถใช้ในการกำหนดเป้าหมาย

UserListSizeRange

ennum ที่มีช่วงขนาดรายการผู้ใช้ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
LESS_THAN_FIVE_HUNDRED รายการผู้ใช้มีผู้ใช้น้อยกว่า 500 ราย
LESS_THAN_ONE_THOUSAND รายการผู้ใช้มีจำนวนผู้ใช้ในช่วง 500 ถึง 1,000 คน
ONE_THOUSAND_TO_TEN_THOUSAND รายการผู้ใช้มีจำนวนผู้ใช้ในช่วง 1000 ถึง 10,000 คน
TEN_THOUSAND_TO_FIFTY_THOUSAND รายการผู้ใช้มีจำนวนผู้ใช้ในช่วง 10,000 ถึง 50,000 คน
FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND รายการผู้ใช้มีจำนวนผู้ใช้ในช่วง 50,000 ถึง 100,000 คน
ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND รายการผู้ใช้มีจำนวนผู้ใช้ในช่วง 100,000 ถึง 300,000 คน
THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THOUSAND รายการผู้ใช้มีจำนวนผู้ใช้ในช่วง 300,000 ถึง 500,000 คน
FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION รายการผู้ใช้มีจำนวนผู้ใช้ในช่วง 500,000 ถึง 1 ล้านคน
ONE_MILLION_TO_TWO_MILLION รายการผู้ใช้มีจำนวนผู้ใช้ในช่วง 1-2 ล้าน
TWO_MILLION_TO_THREE_MILLION รายการผู้ใช้มีจำนวนผู้ใช้ในช่วง 2 ถึง 3 ล้าน
THREE_MILLION_TO_FIVE_MILLION รายการผู้ใช้มีจำนวนผู้ใช้ในช่วง 3 ถึง 5 ล้าน
FIVE_MILLION_TO_TEN_MILLION รายการผู้ใช้มีจำนวนผู้ใช้ในช่วง 5 ถึง 10 ล้าน
TEN_MILLION_TO_TWENTY_MILLION รายการผู้ใช้มีจำนวนผู้ใช้ในช่วง 10 ถึง 20 ล้าน
TWENTY_MILLION_TO_THIRTY_MILLION รายการผู้ใช้มีจำนวนผู้ใช้ในช่วง 20 ถึง 30 ล้านราย
THIRTY_MILLION_TO_FIFTY_MILLION รายการผู้ใช้มีจำนวนผู้ใช้ในช่วง 30 ถึง 50 ล้านราย
OVER_FIFTY_MILLION รายชื่อผู้ใช้มีผู้ใช้มากกว่า 50 ล้านคน

UserListType

enum ที่มีประเภทรายชื่อผู้ใช้ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
REMARKETING UserList แสดงเป็นคอลเล็กชันของประเภท Conversion
LOGICAL UserList เป็นการรวมรายการ/ความสนใจของผู้ใช้อื่นๆ เข้าด้วยกัน
EXTERNAL_REMARKETING UserList ที่สร้างในแพลตฟอร์ม Google Ad Manager
RULE_BASED UserList ที่เชื่อมโยงกับกฎ
SIMILAR UserList ที่มีผู้ใช้คล้ายกับผู้ใช้ของ UserList อื่น
CRM_BASED รายชื่อผู้ใช้ของข้อมูล CRM ของบุคคลที่หนึ่งที่ผู้ลงโฆษณาให้ไว้ในรูปแบบอีเมลหรือรูปแบบอื่นๆ

UserListClosingReason

คำอธิบายที่อธิบายเหตุผลที่ปิดรายชื่อผู้ใช้ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
UNUSED รายชื่อผู้ใช้ถูกปิดเนื่องจากไม่มีการใช้งานนานกว่า 1 ปี

AccessReason

คำอธิบายที่อธิบายเหตุผลที่เป็นไปได้ในการเข้าถึง

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
OWNED ผู้ใช้เป็นเจ้าของทรัพยากร
SHARED มีการแชร์ทรัพยากรกับผู้ใช้
LICENSED ผู้ใช้ใช้ทรัพยากรได้
SUBSCRIBED ผู้ใช้สมัครใช้บริการทรัพยากร
AFFILIATED ผู้ใช้เข้าถึงทรัพยากรได้

UserListAccessStatus

enum ที่มีสถานะการเข้าถึงรายชื่อผู้ใช้ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ENABLED เปิดใช้การเข้าถึงแล้ว
DISABLED การเข้าถึงถูกปิด

CrmBasedUserListInfo

รายชื่อผู้ใช้ของผู้ใช้ CRM ที่ผู้ลงโฆษณาให้ไว้

การแสดง JSON 
{
  "uploadKeyType": enum (CustomerMatchUploadKeyType),
  "dataSourceType": enum (UserListCrmDataSourceType),
  "appId": string
}
ช่อง
uploadKeyType

enum (CustomerMatchUploadKeyType)

ประเภทคีย์ที่ตรงกันของรายการ ไม่อนุญาตให้ใช้ข้อมูลประเภทต่างๆ รวมกันในรายการเดียวกัน ต้องระบุข้อมูลในช่องนี้สำหรับการดำเนินการ ADD
dataSourceType

enum (UserListCrmDataSourceType)

แหล่งข้อมูลของรายการ ค่าเริ่มต้นคือ FIRST_PARTY มีเพียงลูกค้าในรายการที่อนุญาตเท่านั้นที่จะสร้างรายการ CRM ที่มาจากบุคคลที่สามได้
appId

string

สตริงที่ระบุแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่ใช้รวบรวมข้อมูลได้อย่างไม่ซ้ำกัน สำหรับ iOS สตริงรหัสคือสตริงที่มีตัวเลข 9 หลักที่ปรากฏต่อท้าย URL ของ App Store (เช่น "476943146" สำหรับ "Flood-It!" 2" ซึ่งมีลิงก์ App Store คือ http://itunes.apple.com/us/app/flood-it!-2/id476943146) สำหรับ Android สตริงรหัสคือชื่อแพ็กเกจของแอปพลิเคชัน (เช่น "com.labpixies.colordrips" สำหรับ "Color Drips" ตามลิงก์ Google Play https://play.google.com/store/apps/details?id=com.labpixies.colordrips) ต้องระบุเมื่อสร้าง CrmBasedUserList สำหรับการอัปโหลดรหัสโฆษณาบนอุปกรณ์เคลื่อนที่

CustomerMatchUploadKeyType

enum ที่อธิบายประเภทคีย์การอัปโหลดการจับคู่ข้อมูลลูกค้าที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
CONTACT_INFO ระบบจะจับคู่สมาชิกจากข้อมูลลูกค้า เช่น อีเมล หมายเลขโทรศัพท์ หรือที่อยู่จริง
CRM_ID ระบบจะจับคู่สมาชิกจาก User-ID ที่สร้างขึ้นและกำหนดโดยผู้ลงโฆษณา
MOBILE_ADVERTISING_ID ระบบจะจับคู่สมาชิกจากรหัสโฆษณาบนอุปกรณ์เคลื่อนที่

UserListCrmDataSourceType

Enum ที่อธิบายประเภทแหล่งข้อมูล CRM ของรายชื่อผู้ใช้ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
FIRST_PARTY ข้อมูลที่อัปโหลดเป็นข้อมูลจากบุคคลที่หนึ่ง
THIRD_PARTY_CREDIT_BUREAU ข้อมูลที่อัปโหลดมาจากบริษัทข้อมูลเครดิตบุคคลที่สาม
THIRD_PARTY_VOTER_FILE ข้อมูลที่อัปโหลดมาจากไฟล์ผู้โหวตบุคคลที่สาม

SimilarUserListInfo

SimilarUserList คือรายชื่อผู้ใช้ที่คล้ายกับผู้ใช้จาก UserList อื่น รายการเหล่านี้เป็นแบบอ่านอย่างเดียวและ Google สร้างขึ้นโดยอัตโนมัติ

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

string

UserList ของ Seed ที่ดึงมาจากรายการนี้

RuleBasedUserListInfo

การแสดงรายการผู้ใช้ที่สร้างขึ้นจากกฎ

การแสดง JSON 
{
  "prepopulationStatus": enum (UserListPrepopulationStatus),
  "flexibleRuleUserList": {
    object (FlexibleRuleUserListInfo)
  }
}
ช่อง
prepopulationStatus

enum (UserListPrepopulationStatus)

สถานะของการป้อนข้อมูลล่วงหน้า ช่องนี้จะมีค่าเริ่มต้นเป็น "ไม่มี" หากไม่ได้ตั้งค่าไว้ ซึ่งหมายความว่าระบบจะไม่พิจารณาผู้ใช้ก่อนหน้านี้ หากตั้งค่าเป็น "REQUESTED" ผู้ที่เคยเข้าชมเว็บไซต์หรือผู้ใช้แอปที่ตรงกับคำจำกัดความของรายการจะรวมอยู่ในรายการ (ทำงานในเครือข่ายดิสเพลย์เท่านั้น) ตัวเลือกนี้จะเพิ่มเฉพาะผู้ใช้ในอดีตที่อยู่ในช่วง 30 วันที่ผ่านมาเท่านั้น โดยขึ้นอยู่กับระยะเวลาการเป็นสมาชิกของรายการและวันที่ที่มีการเพิ่มแท็กรีมาร์เก็ตติ้ง สถานะจะอัปเดตเป็น "เสร็จสิ้น" เมื่อมีการประมวลผลคำขอ หรือ "ล้มเหลว" หากคำขอล้มเหลว
flexibleRuleUserList

object (FlexibleRuleUserListInfo)

การแสดงกฎที่ยืดหยุ่นสำหรับผู้เข้าชมที่มีการดำเนินการหนึ่งหรือหลายการดำเนินการ รายการผู้ใช้ที่ยืดหยุ่นจะกำหนดโดยรายการตัวถูกดำเนินการ 2 รายการ ได้แก่ รวมตัวถูกดำเนินการและตัวถูกดำเนินการสุดพิเศษ ตัวถูกดำเนินการแต่ละรายการแสดงกลุ่มผู้ใช้ตามการดำเนินการที่ผู้ใช้ทำในกรอบเวลาที่กำหนด รายการตัวถูกดำเนินการเหล่านี้จะถูกรวมเข้ากับโอเปอเรเตอร์ AND_NOT เพื่อให้ผู้ใช้ตัวถูกดำเนินการดังกล่าวรวมอยู่ในรายชื่อผู้ใช้ และลบผู้ใช้ที่มาจากตัวถูกดำเนินการเฉพาะตัว

UserListPrepopulationStatus

Enum ที่อธิบายสถานะการป้อนข้อมูลรายการผู้ใช้ที่เป็นไปได้ล่วงหน้า

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
REQUESTED กำลังขอการป้อนข้อมูลล่วงหน้า
FINISHED การป้อนข้อมูลล่วงหน้าเสร็จสมบูรณ์แล้ว
FAILED การป้อนข้อมูลล่วงหน้าไม่สำเร็จ

FlexibleRuleUserListInfo

การแสดงกฎที่ยืดหยุ่นสำหรับผู้เข้าชมที่มีการดำเนินการหนึ่งหรือหลายการดำเนินการ รายการผู้ใช้ที่ยืดหยุ่นจะกำหนดโดยรายการตัวถูกดำเนินการ 2 รายการ ได้แก่ รวมตัวถูกดำเนินการและตัวถูกดำเนินการสุดพิเศษ ตัวถูกดำเนินการแต่ละรายการแสดงกลุ่มผู้ใช้ตามการดำเนินการที่ผู้ใช้ทำในกรอบเวลาที่กำหนด รายการตัวถูกดำเนินการเหล่านี้จะถูกรวมเข้ากับโอเปอเรเตอร์ AND_NOT เพื่อให้ผู้ใช้ตัวถูกดำเนินการดังกล่าวรวมอยู่ในรายชื่อผู้ใช้ และลบผู้ใช้ที่มาจากตัวถูกดำเนินการเฉพาะตัว

การแสดง JSON 
{
  "inclusiveRuleOperator": enum (UserListFlexibleRuleOperator),
  "inclusiveOperands": [
    {
      object (FlexibleRuleOperandInfo)
    }
  ],
  "exclusiveOperands": [
    {
      object (FlexibleRuleOperandInfo)
    }
  ]
}
ช่อง
inclusiveRuleOperator

enum (UserListFlexibleRuleOperator)

โอเปอเรเตอร์ที่กำหนดวิธีรวมตัวถูกดำเนินการแบบรวม
inclusiveOperands[]

object (FlexibleRuleOperandInfo)

กฎที่แสดงถึงผู้ใช้ที่ควรรวมอยู่ในรายชื่อผู้ใช้ พารามิเตอร์เหล่านี้จะอยู่ทางด้านซ้ายของโอเปอเรเตอร์ AND_NOT และรวมเข้าด้วยกันด้วย AND/OR ตามที่ระบุโดย inclusiveRuleOperator
exclusiveOperands[]

object (FlexibleRuleOperandInfo)

กฎที่แสดงถึงผู้ใช้ที่ควรยกเว้นจากรายชื่อผู้ใช้ พารามิเตอร์เหล่านี้จะอยู่ทางด้านขวาของโอเปอเรเตอร์ AND_NOT และรวมเข้าด้วยกันโดย OR

UserListFlexibleRuleOperator

Enum ที่อธิบายโอเปอเรเตอร์กฎแบบรวมของรายชื่อผู้ใช้ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
AND ก และ ข
OR ก. หรือ ข.

FlexibleRuleOperandInfo

กฎที่ยืดหยุ่นซึ่งรวมกฎทั่วไปและกรอบเวลามองย้อนกลับ

การแสดง JSON 
{
  "rule": {
    object (UserListRuleInfo)
  },
  "lookbackWindowDays": string
}
ช่อง
rule

object (UserListRuleInfo)

รายการกลุ่มรายการของกฎที่กำหนดกฎนี้ ระบบจะจัดกลุ่มรายการกฎไว้ด้วยกัน
lookbackWindowDays

string (int64 format)

กรอบเวลามองย้อนกลับสำหรับกฎนี้ในหน่วยวัน ตั้งแต่นี้จนถึง X วันที่ผ่านมา

UserListRuleInfo

กฎที่ลูกค้ากำหนดตามพารามิเตอร์ที่กำหนดเองที่ส่งโดยเว็บไซต์ หรือที่อัปโหลดโดยผู้ลงโฆษณา

การแสดง JSON 
{
  "ruleType": enum (UserListRuleType),
  "ruleItemGroups": [
    {
      object (UserListRuleItemGroupInfo)
    }
  ]
}
ช่อง
ruleType

enum (UserListRuleType)

ประเภทของกฎจะใช้ในการกำหนดวิธีจัดกลุ่มรายการกฎ

ค่าเริ่มต้นคือ OR ของ AND (รูปแบบปกติที่ไม่ต่อเนื่อง) กล่าวคือ รายการกฎจะใช้ "และ" รวมกันภายในกลุ่มรายการกฎ และตัวกลุ่มเองจะใช้ OR ร่วมกัน

OR ของ AND เป็นประเภทที่รองรับเพียงประเภทเดียวสำหรับ WindowRuleUserList
ruleItemGroups[]

object (UserListRuleItemGroupInfo)

รายการกลุ่มรายการของกฎที่กำหนดกฎนี้ ระบบจะจัดกลุ่มรายการของกฎไว้ด้วยกันตาม rulesType

UserListRuleType

Enum ที่อธิบายประเภทกฎของรายการผู้ใช้ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
AND_OF_ORS รูปประกอบปกติ
OR_OF_ANDS รูปแบบปกติที่ไม่ต่อเนื่อง

UserListRuleItemGroupInfo

กลุ่มของรายการกฎ

การแสดง JSON 
{
  "ruleItems": [
    {
      object (UserListRuleItemInfo)
    }
  ]
}
ช่อง
ruleItems[]

object (UserListRuleItemInfo)

รายการกฎที่จะจัดกลุ่มไว้ด้วยกันตาม rulesType

UserListRuleItemInfo

รายการกฎอะตอม

การแสดง JSON 
{
  "name": string,

  // Union field rule_item can be only one of the following:
  "numberRuleItem": {
    object (UserListNumberRuleItemInfo)
  },
  "stringRuleItem": {
    object (UserListStringRuleItemInfo)
  },
  "dateRuleItem": {
    object (UserListDateRuleItemInfo)
  }
  // End of list of possible types for union field rule_item.
}
ช่อง
name

string

ชื่อตัวแปรของกฎ ซึ่งควรตรงกับชื่อคีย์ที่เกี่ยวข้องที่พิกเซลเริ่มทํางาน ชื่อต้องขึ้นต้นด้วยตัวอักษร US-ascii หรือขีดล่าง หรือรหัส UTF8 ที่มากกว่า 127 และประกอบด้วยตัวอักษรหรือตัวเลข US-ascii หรือขีดล่าง หรือรหัส UTF8 ที่มากกว่า 127 สำหรับเว็บไซต์ จะมี URL ตัวแปรบิวท์อิน 2 รายการ (ชื่อ = "url__") และ URL ผู้อ้างอิง (ชื่อ = 'ref_url__') ต้องกรอกข้อมูลในช่องนี้เมื่อสร้างรายการกฎใหม่
ฟิลด์สหภาพ rule_item รายการกฎอะตอม rule_item ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
numberRuleItem

object (UserListNumberRuleItemInfo)

รายการกฎอะตอมที่ประกอบด้วยการดำเนินการตัวเลข
stringRuleItem

object (UserListStringRuleItemInfo)

รายการกฎอะตอมที่ประกอบด้วยการดำเนินการสตริง
dateRuleItem

object (UserListDateRuleItemInfo)

รายการกฎอะตอมที่ประกอบด้วยการดำเนินการวันที่

UserListNumberRuleItemInfo

รายการกฎที่ประกอบด้วยการดำเนินการตัวเลข

การแสดง JSON 
{
  "operator": enum (UserListNumberRuleItemOperator),
  "value": number
}
ช่อง
operator

enum (UserListNumberRuleItemOperator)

โอเปอเรเตอร์การเปรียบเทียบตัวเลข ต้องกรอกข้อมูลในช่องนี้และต้องป้อนข้อมูลเมื่อสร้างรายการกฎตัวเลขใหม่
value

number

ค่าตัวเลขที่จะเปรียบเทียบกับตัวแปร ต้องกรอกข้อมูลในช่องนี้และต้องป้อนข้อมูลเมื่อสร้างรายการกฎตัวเลขใหม่

UserListNumberRuleItemOperator

Enum ที่อธิบายโอเปอเรเตอร์สำหรับกฎรายการผู้ใช้ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
GREATER_THAN มากกว่า
GREATER_THAN_OR_EQUAL มากกว่าหรือเท่ากับ
EQUALS เท่ากับ
NOT_EQUALS ไม่เท่ากัน
LESS_THAN น้อยกว่า
LESS_THAN_OR_EQUAL น้อยกว่าหรือเท่ากับ

UserListStringRuleItemInfo

รายการกฎที่ประกอบด้วยการดำเนินการสตริง

การแสดง JSON 
{
  "operator": enum (UserListStringRuleItemOperator),
  "value": string
}
ช่อง
operator

enum (UserListStringRuleItemOperator)

โอเปอเรเตอร์เปรียบเทียบสตริง ต้องระบุข้อมูลในช่องนี้และต้องป้อนข้อมูลเมื่อสร้างรายการกฎสตริงใหม่
value

string

ด้านขวามือของรายการกฎสตริง สำหรับ URL หรือ URL ผู้อ้างอิง ค่าต้องไม่มีอักขระ URL ที่ไม่ถูกต้อง เช่น บรรทัดใหม่ เครื่องหมายคำพูด แท็บ หรือวงเล็บ ต้องระบุข้อมูลในช่องนี้และต้องป้อนข้อมูลเมื่อสร้างรายการกฎสตริงใหม่

UserListStringRuleItemOperator

Enum ที่อธิบายโอเปอเรเตอร์รายการของกฎรายการผู้ใช้ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
CONTAINS มี
EQUALS เท่ากับ
STARTS_WITH ขึ้นต้นด้วย
ENDS_WITH ลงท้ายด้วย
NOT_EQUALS ไม่เท่ากัน
NOT_CONTAINS ไม่มี
NOT_STARTS_WITH ไม่ได้ขึ้นต้นด้วย
NOT_ENDS_WITH ไม่ได้ลงท้ายด้วย

UserListDateRuleItemInfo

รายการกฎที่ประกอบด้วยการดำเนินการวันที่

การแสดง JSON 
{
  "operator": enum (UserListDateRuleItemOperator),
  "value": string,
  "offsetInDays": string
}
ช่อง
operator

enum (UserListDateRuleItemOperator)

โอเปอเรเตอร์การเปรียบเทียบวันที่ ต้องระบุข้อมูลในช่องนี้และต้องป้อนข้อมูลเมื่อสร้างรายการกฎวันที่ใหม่
value

string

สตริงที่แสดงค่าวันที่ที่จะเปรียบเทียบกับตัวแปรของกฎ รูปแบบวันที่ที่รองรับคือ YYYY-MM-DD ระบบจะรายงานเวลาในเขตเวลาของลูกค้า
offsetInDays

string (int64 format)

ค่าวันที่สัมพัทธ์ของด้านขวามือซึ่งแสดงด้วยจำนวนวันชดเชยจากตอนนี้ ช่องค่าจะลบล้างช่องนี้เมื่อมีทั้ง 2 ช่อง

UserListDateRuleItemOperator

Enum ที่อธิบายโอเปอเรเตอร์รายการกฎวันที่ในรายชื่อผู้ใช้ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
EQUALS เท่ากับ
NOT_EQUALS ไม่เท่ากับ
BEFORE ก่อนหน้านี้
AFTER หลังจากนั้น

LogicalUserListInfo

แสดงรายชื่อผู้ใช้ซึ่งเป็นชุดค่าผสมที่กำหนดเองของรายการผู้ใช้

การแสดง JSON 
{
  "rules": [
    {
      object (UserListLogicalRuleInfo)
    }
  ]
}
ช่อง
rules[]

object (UserListLogicalRuleInfo)

กฎรายการเชิงตรรกะที่กำหนดรายชื่อผู้ใช้นี้ กฎจะกำหนดเป็นโอเปอเรเตอร์ทางตรรกะ (ทั้งหมด/ทั้งหมด/ไม่มี) และชุดรายการผู้ใช้ กฎทั้งหมดจะใช้ AND เมื่อมีการประเมิน

จำเป็นสำหรับการสร้างรายชื่อผู้ใช้เชิงตรรกะ

UserListLogicalRuleInfo

กฎเชิงตรรกะของรายชื่อผู้ใช้ กฎจะมีโอเปอเรเตอร์เชิงตรรกะ (และ/หรือ/ไม่ใช่) และชุดรายการผู้ใช้เป็นตัวถูกดำเนินการ

การแสดง JSON 
{
  "operator": enum (UserListLogicalRuleOperator),
  "ruleOperands": [
    {
      object (LogicalUserListOperandInfo)
    }
  ]
}
ช่อง
operator

enum (UserListLogicalRuleOperator)

โอเปอเรเตอร์เชิงตรรกะของกฎ
ruleOperands[]

object (LogicalUserListOperandInfo)

รายการตัวถูกดำเนินการของกฎ

UserListLogicalRuleOperator

Enum ที่อธิบายโอเปอเรเตอร์กฎเชิงตรรกะของรายชื่อผู้ใช้ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ALL และ - ตัวถูกดำเนินการทั้งหมด
ANY หรือ - ตัวถูกดำเนินการอย่างน้อยหนึ่งตัว
NONE ไม่ใช่ - ไม่มีตัวถูกดำเนินการ

LogicalUserListOperandInfo

ตัวดำเนินการของรายชื่อผู้ใช้เชิงตรรกะที่ประกอบด้วยรายชื่อผู้ใช้

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

string

ชื่อทรัพยากรของรายชื่อผู้ใช้ในรูปแบบตัวถูกดำเนินการ

BasicUserListInfo

การกำหนดเป้าหมายรายการผู้ใช้เป็นคอลเล็กชัน Conversion หรือการกระทำรีมาร์เก็ตติ้ง

การแสดง JSON 
{
  "actions": [
    {
      object (UserListActionInfo)
    }
  ]
}
ช่อง
actions[]

object (UserListActionInfo)

การดำเนินการที่เชื่อมโยงกับรายชื่อผู้ใช้นี้

UserListActionInfo

แสดงประเภทการทำงานที่ใช้สร้างรายการผู้ใช้สำหรับรีมาร์เก็ตติ้ง

การแสดง JSON 
{

  // Union field user_list_action can be only one of the following:
  "conversionAction": string,
  "remarketingAction": string
  // End of list of possible types for union field user_list_action.
}
ช่อง
ฟิลด์สหภาพ user_list_action ประเภทย่อยของการดําเนินการตามรายชื่อผู้ใช้ user_list_action ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
conversionAction

string

การกระทำที่ถือเป็น Conversion ที่ไม่ได้สร้างขึ้นจากรีมาร์เก็ตติ้ง
remarketingAction

string

การดำเนินการรีมาร์เก็ตติ้ง