MatchingFunction

ฟังก์ชันจับคู่ที่เชื่อมโยงกับ CustomerFeed, CampaignFeed หรือระดับกลุ่มโฆษณา ใช้ฟังก์ชันการจับคู่เพื่อกรองชุดรายการฟีดที่เลือก

การแสดง JSON 
{
  "operator": enum (MatchingFunctionOperator),
  "leftOperands": [
    {
      object (Operand)
    }
  ],
  "rightOperands": [
    {
      object (Operand)
    }
  ],
  "functionString": string
}
ช่อง
operator

enum (MatchingFunctionOperator)

โอเปอเรเตอร์สำหรับฟังก์ชัน
leftOperands[]

object (Operand)

ตัวถูกดำเนินการทางด้านซ้ายมือของสมการ นอกจากนั้น ยังเป็นตัวถูกดำเนินการที่จะใช้กับนิพจน์ตัวถูกดำเนินการเดี่ยว เช่น NOT
rightOperands[]

object (Operand)

ตัวถูกดำเนินการทางด้านขวาของสมการ
functionString

string

การแสดงสตริงของฟังก์ชัน

ตัวอย่าง

  1. IDENTITY(จริง) หรือ IDENTITY(เท็จ) แสดงรายการฟีดทั้งหมดหรือไม่แสดงเลย
  2. EQUALS(CONTEXT.DEVICE,"Mobile")
  3. IN(FEED_ITEM_ID,{1000001,1000002,1000003})
  4. CONTAINS_ANY(FeedAttribute[12345678,0],{"Mars cruise","Venus cruise"})
  5. AND(IN(FEED_ITEM_ID,{10001,10002}),EQUALS(CONTEXT.DEVICE,"Mobile"))

ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/google-ads/api/docs/extensions/feeds/matching-functions

โปรดทราบว่าเนื่องจากสตริงหลายรายการอาจนำเสนอฟังก์ชันพื้นฐานที่เหมือนกัน (เช่น ช่องว่างและเครื่องหมายคำพูดเดี่ยวกับคู่) ค่าที่แสดงผลอาจไม่ตรงกับสตริงที่ส่งในคำขอเปลี่ยนแปลง

MatchingFunctionOperator

โอเปอเรเตอร์ที่เป็นไปได้ในฟังก์ชันจับคู่

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
IN โอเปอเรเตอร์ IN
IDENTITY โอเปอเรเตอร์ IDENTITY
EQUALS โอเปอเรเตอร์ EQUALS
AND โอเปอเรเตอร์ที่มีตัวถูกดำเนินการอย่างน้อย 2 ตัวที่เป็นประเภท FunctionOperand และตรวจสอบว่าตัวถูกดำเนินการทั้งหมดประเมินเป็นจริง สำหรับฟังก์ชันที่เกี่ยวข้องกับรูปแบบโฆษณา ตัวถูกดำเนินการทั้งหมดต้องอยู่ในตัวเชื่อมด้านซ้าย
CONTAINS_ANY โอเปอเรเตอร์ที่แสดงค่าเป็น "จริง" หากองค์ประกอบใน leftOperand มีองค์ประกอบใดก็ตามใน rightOperand ไม่เช่นนั้น ให้แสดงผล "เท็จ" ผู้เหมาะสมต้องมีอย่างน้อย 1 ตัว แต่ไม่เกิน 3 ตัว

ตัวถูกดำเนินการ

ตัวถูกดำเนินการในฟังก์ชันจับคู่

การแสดง JSON 
{

  // Union field function_argument_operand can be only one of the following:
  "constantOperand": {
    object (ConstantOperand)
  },
  "feedAttributeOperand": {
    object (FeedAttributeOperand)
  },
  "functionOperand": {
    object (FunctionOperand)
  },
  "requestContextOperand": {
    object (RequestContextOperand)
  }
  // End of list of possible types for union field function_argument_operand.
}
ช่อง
ช่องการรวม function_argument_operand ตัวถูกดำเนินการต่างๆ ที่สามารถใช้ในฟังก์ชันจับคู่ ต้องระบุ function_argument_operand ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
constantOperand

object (ConstantOperand)

ตัวถูกดำเนินการคงที่ในฟังก์ชันจับคู่
feedAttributeOperand

object (FeedAttributeOperand)

ตัวถูกดำเนินการนี้ระบุแอตทริบิวต์ฟีดในฟีด
functionOperand

object (FunctionOperand)

ตัวถูกดำเนินการของฟังก์ชันในฟังก์ชันจับคู่ ใช้เพื่อแสดงฟังก์ชันที่ฝัง
requestContextOperand

object (RequestContextOperand)

ตัวถูกดำเนินการในฟังก์ชันที่อ้างถึงค่าในบริบทคำขอ

ConstantOperand

ตัวถูกดำเนินการคงที่ในฟังก์ชันจับคู่

การแสดง JSON 
{

  // Union field constant_operand_value can be only one of the following:
  "stringValue": string,
  "longValue": string,
  "booleanValue": boolean,
  "doubleValue": number
  // End of list of possible types for union field constant_operand_value.
}
ช่อง
ช่องการรวม constant_operand_value ค่าตัวถูกดำเนินการคงที่ ต้องระบุ constant_operand_value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
stringValue

string

ค่าสตริงของตัวถูกดำเนินการหากเป็นประเภทสตริง
longValue

string (int64 format)

ค่า Int64 ของตัวถูกดำเนินการหากเป็นประเภท int64
booleanValue

boolean

ค่าบูลีนของตัวถูกดำเนินการหากเป็นประเภทบูลีน
doubleValue

number

ค่า Double ของตัวถูกดำเนินการหากเป็นประเภท Double

FeedAttributeOperand

ตัวถูกดำเนินการของแอตทริบิวต์ฟีดในฟังก์ชันการจับคู่ ใช้เพื่อแสดงแอตทริบิวต์ฟีดในฟีด

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

string (int64 format)

ฟีดที่เชื่อมโยง ต้องระบุ
feedAttributeId

string (int64 format)

รหัสของแอตทริบิวต์ฟีดที่อ้างอิง ต้องระบุ

FunctionOperand

ตัวถูกดำเนินการของฟังก์ชันในฟังก์ชันจับคู่ ใช้เพื่อแสดงฟังก์ชันที่ฝัง

การแสดง JSON 
{
  "matchingFunction": {
    object (MatchingFunction)
  }
}
ช่อง
matchingFunction

object (MatchingFunction)

เก็บฟังก์ชันการจับคู่ไว้ในตัวถูกดำเนินการนี้

RequestContextOperand

ตัวถูกดำเนินการในฟังก์ชันที่อ้างถึงค่าในบริบทคำขอ

การแสดง JSON 
{
  "contextType": enum (MatchingFunctionContextType)
}
ช่อง
contextType

enum (MatchingFunctionContextType)

ประเภทค่าที่จะอ้างอิงในบริบทของคำขอ

MatchingFunctionContextType

ประเภทบริบทที่เป็นไปได้สำหรับตัวถูกดำเนินการในฟังก์ชันการจับคู่

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
FEED_ITEM_ID รหัสรายการฟีดในบริบทคำขอ
DEVICE_NAME อุปกรณ์ที่ใช้ (ค่าที่เป็นไปได้คือ "เดสก์ท็อป" หรือ "อุปกรณ์เคลื่อนที่")
FEED_ITEM_SET_ID รหัสชุดรายการฟีดในบริบทคำขอ