AlgorithmRules

خوارزمية مستندة إلى القواعد

تمثيل JSON
{
  "impressionSignalRuleset": {
    object (Ruleset)
  }
}
الحقول
impressionSignalRuleset

object (Ruleset)

قواعد إشارات مرّات الظهور

مجموعة القواعد

مجموعة قواعد تتألف من قائمة بالقواعد وكيفية تجميع القيم الناتجة

تمثيل JSON
{
  "rules": [
    {
      object (Rule)
    }
  ],
  "aggregationType": enum (RuleAggregationType),
  "maxValue": number
}
الحقول
rules[]

object (Rule)

قائمة القواعد لإنشاء قيمة الظهور.

aggregationType

enum (RuleAggregationType)

كيفية تجميع قيم القواعد التي تم تقييمها

maxValue

number

الحد الأقصى للقيمة التي يمكن أن تقيِّمها مجموعة القواعد

القاعدة

مجموعة من الشروط

وتكون القيمة المعروضة للقاعدة إما:

  • إن القيمة المعروضة لشرط واحد مستوفٍ أو
  • القيمة التلقائية المحدّدة للعرض في حال عدم استيفاء أي شروط.
تمثيل JSON
{
  "conditions": [
    {
      object (RuleCondition)
    }
  ],
  "defaultReturnValue": {
    object (SignalValue)
  }
}
الحقول
conditions[]

object (RuleCondition)

قائمة بالشروط في هذه القاعدة يجب أن تكون المعايير بين الشروط متعارضة.

defaultReturnValue

object (SignalValue)

القيمة التلقائية المعروضة عند عدم استيفاء أيّ من الشروط

RuleCondition

مجموعة من مقارنات الإشارات يعادل بيان if.

تمثيل JSON
{
  "signalComparisons": [
    {
      object (SignalComparison)
    }
  ],
  "returnValue": {
    object (SignalValue)
  }
}
الحقول
signalComparisons[]

object (SignalComparison)

قائمة المقارنات التي تنشئ شرط عبارة if يتم دمج المقارنات في شرط واحد باستخدام عوامل التشغيل المنطقية AND.

returnValue

object (SignalValue)

القيمة التي يتم عرضها إذا تم تقييم شرط signalComparisons إلى TRUE.

SignalComparison

مقارنة واحدة وتقارن المقارنة بين signal وcomparisonValue.

يتم تمثيل مقارنة siteId==123 بقيم الحقول التالية:

  • تبلغ قيمة impressionSignal في signalSITE_ID.
  • تم ضبط comparisonOperator على EQUAL.
  • تم ضبط comparisonValue على 123.
تمثيل JSON
{
  "signal": {
    object (Signal)
  },
  "comparisonOperator": enum (ComparisonOperator),
  "comparisonValue": {
    object (ComparisonValue)
  }
}
الحقول
signal

object (Signal)

الإشارة المطلوب مقارنتها

comparisonOperator

enum (ComparisonOperator)

المُعامِل المستخدَم لمقارنة القيمتَين.

في التعبير الناتج، ستكون signal هي القيمة الأولى وستكون comparisonValue هي القيمة الثانية.

comparisonValue

object (ComparisonValue)

القيمة المطلوب المقارنة بها.

إشارة

الإشارة المستخدَمة لتقييم القواعد

تمثيل JSON
{

  // Union field signal can be only one of the following:
  "impressionSignal": enum (ImpressionSignal)
  // End of list of possible types for union field signal.
}
الحقول
حقل الربط signal الإشارة المستخدَمة لتقييم القواعد. يمكن أن يكون signal واحدًا فقط مما يلي:
impressionSignal

enum (ImpressionSignal)

إشارة استنادًا إلى مرّات الظهور

ComparisonValue

قيمة لمقارنة الإشارة بها

تمثيل JSON
{

  // Union field value can be only one of the following:
  "int64Value": string,
  "doubleValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "creativeDimensionValue": {
    object (Dimensions)
  },
  "dayAndTimeValue": {
    object (DayAndTime)
  },
  "deviceTypeValue": enum (RuleDeviceType),
  "onScreenPositionValue": enum (OnScreenPosition),
  "environmentValue": enum (Environment),
  "exchangeValue": enum (Exchange)
  // End of list of possible types for union field value.
}
الحقول
حقل الربط value القيمة المطلوب المقارنة بها مع الإشارة. يمكن أن يكون value واحدًا فقط مما يلي:
int64Value

string (int64 format)

قيمة عدد صحيح

doubleValue

number

قيمة مزدوجة

stringValue

string

قيمة سلسلة.

boolValue

boolean

قيمة منطقية.

creativeDimensionValue

object (Dimensions)

قيمة سمة تصميم الإعلان.

dayAndTimeValue

object (DayAndTime)

قيمة اليوم والوقت يُسمَح باستخدام TIME_ZONE_RESOLUTION_END_USER فقط.

deviceTypeValue

enum (RuleDeviceType)

قيمة نوع الجهاز.

onScreenPositionValue

enum (OnScreenPosition)

قيمة موضع الإعلان

environmentValue

enum (Environment)

قيمة البيئة

exchangeValue

enum (Exchange)

قيمة الصرف

DayAndTime

تمثيل الوقت المحدّد حسب يوم الأسبوع والساعة من اليوم

تمثيل JSON
{
  "dayOfWeek": enum (DayOfWeek),
  "hourOfDay": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
الحقول
dayOfWeek

enum (DayOfWeek)

مطلوب. يوم من الأسبوع

hourOfDay

integer

مطلوب. ساعة من اليوم

timeZoneResolution

enum (TimeZoneResolution)

مطلوب. الآلية المستخدَمة لتحديد المنطقة الزمنية ذات الصلة.

SignalValue

القيمة المعدَّلة للإشارة المستخدَمة في تقييم القاعدة

تمثيل JSON
{
  "number": number
}
الحقول
number

number

القيمة التي سيتم استخدامها كنتيجة.