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)

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