AlgorithmRules

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

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

object (Ruleset)

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

object (Ruleset)

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

لا يُسمَح باستخدام هذا الحقل إلا للشركاء المُدرَجين في القائمة المسموح بها.
attributionModelId

string (int64 format)

نموذج تحديد المصدر للخوارزمية

لا يُسمَح باستخدام هذا الحقل إلا للشركاء المُدرَجين في القائمة المسموح بها.

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

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

تمثيل 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 في signal مقدار SITE_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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "impressionSignal": enum (ImpressionSignal),
  "clickSignal": enum (ClickSignal),
  "activeViewSignal": enum (ActiveViewSignal)
  // End of mutually exclusive fields.
}
الحقول
الإشارة المستخدَمة لتقييم القواعد في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
impressionSignal

enum (ImpressionSignal)

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

enum (ClickSignal)

إشارة استنادًا إلى النقرات

لا يُسمَح باستخدام هذا الحقل إلا للشركاء المُدرَجين في القائمة المسموح بها.
activeViewSignal

enum (ActiveViewSignal)

إشارة تستند إلى المشاهدات النشطة

لا يُسمَح باستخدام هذا الحقل إلا للشركاء المُدرَجين في القائمة المسموح بها.
نهاية الحقول التي يستبعد كلّ منها الآخر

ComparisonValue

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

تمثيل JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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),
  "contentDurationValue": enum (ContentDuration),
  "contentStreamTypeValue": enum (ContentStreamType),
  "contentGenreIdValue": string,
  "videoPlayerSizeValue": enum (VideoPlayerSize)
  // End of mutually exclusive fields.
}
الحقول
القيمة التي ستتم مقارنة الإشارة بها. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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)

قيمة التبادل
contentDurationValue

enum (ContentDuration)

قيمة مدة محتوى الفيديو
contentStreamTypeValue

enum (ContentStreamType)

قيمة نوع عرض الفيديو
contentGenreIdValue

string (int64 format)

تمثّل هذه السمة قيمة معرّف نوع الفيديو.
videoPlayerSizeValue

enum (VideoPlayerSize)

قيمة حجم مشغّل الفيديو

لا يُسمَح باستخدام هذا الحقل إلا للشركاء المُدرَجين في القائمة المسموح بها.
نهاية الحقول التي يستبعد كلّ منها الآخر

DayAndTime

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

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

enum (DayOfWeek)

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

integer

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

enum (TimeZoneResolution)

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

SignalValue

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

تمثيل JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "activeViewSignal": enum (ActiveViewSignal),
  "floodlightActivityConversionSignal": {
    object (FloodlightActivityConversionSignal)
  }
  // End of mutually exclusive fields.
  "number": number
}
الحقول
الإشارة الأساسية المستخدَمة لإنشاء القيمة في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
activeViewSignal

enum (ActiveViewSignal)

إشارة تستند إلى المشاهدات النشطة يُسمح فقط بالقيمة TIME_ON_SCREEN.

لا يُسمَح باستخدام هذا الحقل إلا للشركاء المُدرَجين في القائمة المسموح بها.
floodlightActivityConversionSignal

object (FloodlightActivityConversionSignal)

إشارة تستند إلى أحداث الإحالات الناجحة في Floodlight.

لا يُسمَح باستخدام هذا الحقل إلا للشركاء المُدرَجين في القائمة المسموح بها.
نهاية الحقول التي يستبعد كلّ منها الآخر
number

number

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

FloodlightActivityConversionSignal

القاعدة التي يتم بموجبها تسجيل نقاط لمرّات الظهور استنادًا إلى أحداث الإحالات الناجحة في Floodlight

تمثيل JSON 
{
  "floodlightActivityId": string,
  "countingMethod": enum (CountingMethod),
  "conversionCounting": enum (ConversionCounting)
}
الحقول
floodlightActivityId

string (int64 format)

الحقل مطلوب. معرّف نشاط Floodlight.
countingMethod

enum (CountingMethod)

الحقل مطلوب. طريقة الحصول على القيمة من نشاط Floodlight، مثل عدد الإحالات الناجحة
conversionCounting

enum (ConversionCounting)

الحقل مطلوب. نوع الإحالات الناجحة التي سيتم استخدامها في احتساب قيمة مرات الظهور، مثل الإحالات الناجحة بعد النقر