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 بقيم الحقول التالية:

  • signal لديه impressionSignal بقيمة 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 
{

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

enum (ImpressionSignal)

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

enum (ClickSignal)

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

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

enum (ActiveViewSignal)

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

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

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),
  "videoPlayerSizeValue": enum (VideoPlayerSize)
  // 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)

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

enum (VideoPlayerSize)

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

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

DayAndTime

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

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

enum (DayOfWeek)

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

integer

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

enum (TimeZoneResolution)

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

SignalValue

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

تمثيل JSON 
{

  // Union field signal can be only one of the following:
  "activeViewSignal": enum (ActiveViewSignal),
  "floodlightActivityConversionSignal": {
    object (FloodlightActivityConversionSignal)
  }
  // End of list of possible types for union field signal.
  "number": number
}
الحقول
حقل الدمج signal الإشارة الأساسية المستخدَمة لإنشاء القيمة. يمكن أن تكون signal إحدى القيم التالية فقط:
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)

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