MatchingFunction

دالة مطابقة مرتبطة بخلاصة العملاء أو خلاصة الحملة أو خلاصة المجموعة الإعلانية. يتم استخدام دالة المطابقة لفلترة مجموعة عناصر الخلاصة المحدّدة.

تمثيل 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(true) أو IDENTITY(false). جميع العناصر في الخلاصة أو لم يتم عرضها مطلقًا
  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

العوامل المحتملة في دالة مطابقة.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
IN عامل IN.
IDENTITY عامل التشغيل IDENTITY.
EQUALS عامل EQUALS
AND يشير ذلك المصطلح إلى عامل تشغيل يستخدم معاملَين أو أكثر من النوع الخاص بالدالة ويتحقّق من أنّ جميع المعاملات يتم تقييمها على أنّها صحيحة. بالنسبة إلى الدوالّ ذات الصلة بأشكال الإعلانات، يجب أن تكون جميع المعاملات بدالّة يسار خاصة.
CONTAINS_ANY يشير ذلك المصطلح إلى المشغّل الذي يعرض القيمة true إذا كانت العناصر في عامل التشغيل الأيسر خاصات تحتوي على أي من العناصر في هذه السمة. وفي حال لم تكن كذلك، يمكنك عرض false. يجب أن تحتوي السمات المناسبة على سمة واحدة على الأقل ولا يزيد عددها عن 3 سمات Constant specials.

المُعامل

معامل في دالة مطابقة.

تمثيل 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

أنواع السياق المحتملة لمعامل في دالة مطابقة.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
FEED_ITEM_ID معرّف العنصر في الخلاصة في سياق الطلب.
DEVICE_NAME الجهاز المستخدَم (القيم المحتملة هي "كمبيوتر مكتبي" أو "جهاز جوّال").
FEED_ITEM_SET_ID رقم تعريف مجموعة عناصر الخلاصة في سياق الطلب.