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)

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