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 روی ۱۲۳ تنظیم شده است.
نمایش 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)

الزامی. نوع تبدیل‌هایی که باید در محاسبه مقدار ظهور استفاده شود، برای مثال، تبدیل‌های پس‌از کلیک.