แชร์ผ่าน

วัตถุข้อมูลเพรดิเคต - การจัดการลูกค้า

  • บทความ

กําหนดเพรดิเคตสําหรับรายการของเอนทิตีที่ร้องขอโดยใช้หนึ่งในการดําเนินการค้นหา ตัวอย่างเช่น SearchAccounts, SearchClientLinks, SearchCustomers หรือ SearchUserInvitations

ไวยากรณ์

<xs:complexType name="Predicate" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Field" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Operator" type="tns:PredicateOperator" />
    <xs:element minOccurs="0" name="Value" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

องค์ ประกอบ

วัตถุเพรดิเคตมีองค์ประกอบต่อไปนี้: Field, Operator, Value

องค์ ประกอบ คำอธิบาย ชนิดข้อมูล
ฟิลด์ ชื่อขององค์ประกอบสําหรับออบเจ็กต์ที่คุณกําลังค้นหา

สําหรับค่าที่เป็นไปได้ โปรดดู หมายเหตุ ด้านล่าง		 สาย อักขระ
ผู้ ประกอบการ กําหนดความสัมพันธ์ระหว่างเขตข้อมูล และค่า PredicateOperator
ค่า สตริงที่จะค้นหาในเขตข้อมูลที่ระบุ

ความยาวของสตริงนี้ต้องเป็นสี่หรือมากกว่า เว้นแต่ว่าเขตข้อมูลถูกตั้งค่าเป็น MarketCountry หรือ MarketLanguage		 สาย อักขระ

หมาย เหตุ

องค์ประกอบเขตข้อมูลและองค์ประกอบตัวดําเนินการที่รองรับของออบเจ็กต์เพรดิเคตสําหรับการดําเนินการบริการแต่ละอย่างมีรายละเอียดด้านล่าง

เพรดิเคต SearchAccounts

สําหรับการดําเนินการบริการ SearchAccounts ต่อไปนี้คือองค์ประกอบเขตข้อมูลที่ได้รับการสนับสนุนและองค์ประกอบตัวดําเนินการของวัตถุเพรดิเคต

ฟิลด์ ผู้ ประกอบการ คำอธิบาย
AccountId เท่ากับ

นิ้ว		 ใช้เขตข้อมูลนี้เพื่อค้นหาองค์ประกอบ ID ของ AdvertiserAccount
AccountLifeCycleStatus เท่ากับ ใช้เขตข้อมูลนี้เพื่อค้นหาองค์ประกอบ AccountLifeCycleStatus ของ AdvertiserAccount

ค่าที่เป็นไปได้ได้แก่ "ใช้งานอยู่", "แบบร่าง", "Inactive", "Pause", "Pending" และ "Suspended"
- เมื่อคุณร้องขอบัญชีโดยสถานะ "ใช้งานอยู่" การดําเนินการจะส่งคืนบัญชีที่มี AccountLifeCycleStatus ที่ตั้งค่าเป็นใช้งานอยู่ การดําเนินการนี้ยังส่งกลับบัญชีที่มี AccountLifeCycleStatus ที่ตั้งค่าเป็น หยุดชั่วคราว โดยที่ค่า PauseReason คือ 2 (บริการการเรียกเก็บเงินหยุดบัญชีชั่วคราว)
- เมื่อคุณร้องขอบัญชีตามสถานะ "หยุดชั่วคราว" การดําเนินการจะส่งกลับบัญชีที่มี AccountLifeCycleStatus ตั้งค่าเป็น หยุดชั่วคราว โดยที่ค่า PauseReason คือ 1 (ผู้ใช้หยุดบัญชีชั่วคราว) หรือ 4 (ผู้ใช้และบริการการเรียกเก็บเงินหยุดบัญชีชั่วคราว)
ชื่อบัญชี ประกอบ ด้วย

เท่ากับ		 ใช้เขตข้อมูลนี้เพื่อค้นหาองค์ประกอบ ชื่อ ของ AdvertiserAccount
หมายเลขบัญชี ประกอบ ด้วย

เท่ากับ

นิ้ว		 ใช้เขตข้อมูลนี้เพื่อค้นหาองค์ประกอบ ตัวเลข ของ AdvertiserAccount
CustomerId เท่ากับ ใช้ฟิลด์นี้เพื่อค้นหาองค์ประกอบ ID ของลูกค้า
UserId เท่ากับ ใช้เขตข้อมูลนี้เพื่อค้นหาองค์ประกอบ UserId ของผู้ใช้

สําหรับการดําเนินการบริการ SearchClientLinks ต่อไปนี้คือองค์ประกอบเขตข้อมูลที่ได้รับการสนับสนุนและองค์ประกอบตัวดําเนินการของวัตถุเพรดิเคต

ฟิลด์ ผู้ ประกอบการ คำอธิบาย
ClientAccountId เท่ากับ

นิ้ว		 ค้นหาออบเจ็กต์ ClientLink ของบัญชีผู้ลงโฆษณาโดยตัวระบุบัญชีผู้โฆษณาไคลเอ็นต์
ClientCustomerId เท่ากับ

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

โปรดสังเกตกฎเพรดิเคตต่อไปนี้สําหรับ SearchClientLinks

  • คุณไม่สามารถรวมทั้ง DirectManagingCustomerId และ ManageringCustomerId
  • คุณไม่สามารถรวม ClientAccountId และ ClientCustomerId ได้
  • ถ้าคุณรวมเพรดิเคต ClientAccountId และ ManageringCustomerId ไว้ในการเรียกบริการเดียวกัน การจัดการ CustomerId จะถูกละเว้น
  • ถ้าคุณรวมเพรดิเคต ClientCustomerId และ DirectManagingCustomerId ไว้ในการเรียกใช้บริการเดียวกัน ผลลัพธ์จะรวมเฉพาะลิงก์ไคลเอ็นต์ลูกค้าที่ตรงตามเงื่อนไขเพรดิเคตทั้งสองเท่านั้น
  • ถ้าคุณรวมทั้งเพรดิเคต ClientAccountId และ DirectManagingCustomerId ในการเรียกใช้บริการเดียวกัน ผลลัพธ์จะมีลิงก์ไคลเอ็นต์บัญชีผู้ลงโฆษณาที่ตรงตามเงื่อนไขเพรดิเคตทั้งสองรายการเท่านั้น

เพรดิเคตของ SearchCustomers

สําหรับการดําเนินการบริการ SearchCustomers ต่อไปนี้คือองค์ประกอบเขตข้อมูลที่ได้รับการสนับสนุนและองค์ประกอบตัวดําเนินการของวัตถุเพรดิเคต

ฟิลด์ ผู้ ประกอบการ คำอธิบาย
AccountId เท่ากับ ใช้เขตข้อมูลนี้เพื่อค้นหาองค์ประกอบ ID ของ AdvertiserAccount
ชื่อบัญชี ประกอบ ด้วย

เท่ากับ		 ใช้เขตข้อมูลนี้เพื่อค้นหาองค์ประกอบ ชื่อ ของ AdvertiserAccount
หมายเลขบัญชี ประกอบ ด้วย

เท่ากับ		 ใช้เขตข้อมูลนี้เพื่อค้นหาองค์ประกอบ ตัวเลข ของ AdvertiserAccount
ApplicationScope เท่ากับ สําหรับใช้ภายในเท่านั้น
CreatedDate GreaterThanEquals

LessThanEquals		 ใช้ฟิลด์นี้เพื่อค้นหาวันที่ที่สร้างหรือลงทะเบียนลูกค้า

วันที่จะถูกจัดเก็บไว้ในเวลามาตรฐานสากล (UTC) ใช้เฉพาะเดือน วัน และปีของสตริงที่ระบุเท่านั้นสําหรับการค้นหา ถ้าคุณระบุชั่วโมง นาที และวินาทีของวันที่ จะถูกละเว้น

สําหรับข้อมูลเกี่ยวกับรูปแบบของวันที่และเวลา ดูรายการ dateTime ในชนิดข้อมูล Primitive XML
CustomerId เท่ากับ

นิ้ว		 ใช้ฟิลด์นี้เพื่อค้นหาองค์ประกอบ ID ของลูกค้า
ชื่อลูกค้า ประกอบ ด้วย

เท่ากับ		 ใช้ฟิลด์นี้เพื่อค้นหาองค์ประกอบ ชื่อ ของลูกค้า
MarketCountry เท่ากับ ใช้ฟิลด์นี้เพื่อค้นหาองค์ประกอบ MarketCountry ของลูกค้า

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

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

เพรดิเคต SearchUserInvitations

สําหรับการดําเนินการบริการ SearchUserInvitations ต่อไปนี้คือองค์ประกอบเขตข้อมูลที่ได้รับการสนับสนุนและองค์ประกอบตัวดําเนินการของวัตถุเพรดิเคต

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

ข้อกําหนด

บริการ: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities

ใช้โดย

SearchAccounts
SearchClientLinks
SearchCustomers
SearchUserInvitations