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(ID_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 โอเปอเรเตอร์ที่คืนค่า true ถ้าองค์ประกอบใน leftOperands มีองค์ประกอบใดๆ ใน rightOperands หากไม่ใช่ ให้แสดงผลเป็นเท็จ 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

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

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 รหัสชุดรายการฟีดในบริบทคำขอ