MatchingFunction

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

การแสดง 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(รหัสฟีด,{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 โอเปอเรเตอร์ที่ส่งคืนค่า "จริง" หากองค์ประกอบในด้านซ้าย (ทำซ้ำ) มีองค์ประกอบใดๆ ใน rightOperands หากไม่ใช่ ให้แสดงค่า "เท็จ" ตัวถูกดำเนินการที่ถูกต้องต้องมีค่าคงที่อย่างน้อย 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 รหัสชุดรายการฟีดในบริบทคำขอ