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 )

مقدار بازگشتی پیش‌فرض زمانی اعمال می‌شود که هیچ یک از شرایط برقرار نباشد.

شرط قاعده

مجموعه‌ای از مقایسه‌های سیگنال. معادل یک دستور if .

نمایش JSON 
{
  "signalComparisons": [
    {
      object (SignalComparison)
    }
  ],
  "returnValue": {
    object (SignalValue)
  }
}
فیلدها
signalComparisons[]

object ( SignalComparison )

فهرست مقایسه‌هایی که شرط دستور if می‌سازند. مقایسه‌ها با استفاده از عملگرهای منطقی AND در یک شرط واحد ترکیب می‌شوند.

returnValue

object ( SignalValue )

مقداری که در صورت TRUE بودن شرط signalComparisons بازگردانده می‌شود.

مقایسه سیگنال

یک مقایسه واحد. این مقایسه، 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

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 )

سیگنال بر اساس بازدیدهای فعال.

این فیلد فقط برای شرکای مجاز پشتیبانی می‌شود.

مقایسهمقدار

مقداری برای مقایسه سیگنال.

نمایش 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),
  "contentDurationValue": enum (ContentDuration),
  "contentStreamTypeValue": enum (ContentStreamType),
  "contentGenreIdValue": string,
  "videoPlayerSizeValue": enum (VideoPlayerSize)
  // End of list of possible types for union field value.
}
فیلدها
value فیلد Union. مقداری که سیگنال با آن مقایسه می‌شود. 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 )

ارزش مبادله‌ای.

contentDurationValue

enum ( ContentDuration )

مقدار مدت زمان محتوای ویدیویی.

contentStreamTypeValue

enum ( ContentStreamType )

مقدار نوع ارائه ویدیو.

contentGenreIdValue

string ( int64 format)

مقدار شناسه ژانر ویدیو.

videoPlayerSizeValue

enum ( VideoPlayerSize )

مقدار اندازه پخش کننده ویدیو.

این فیلد فقط برای شرکای مجاز پشتیبانی می‌شود.

روز و زمان

نمایش زمان که توسط روز هفته و ساعت روز تعریف می‌شود.

نمایش JSON 
{
  "dayOfWeek": enum (DayOfWeek),
  "hourOfDay": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
فیلدها
dayOfWeek

enum ( DayOfWeek )

الزامی. روز هفته.

hourOfDay

integer

الزامی. ساعت روز.

timeZoneResolution

enum ( TimeZoneResolution )

الزامی. مکانیزمی که برای تعیین منطقه زمانی مربوطه استفاده می‌شود.

مقدار سیگنال

مقدار تنظیم‌شده‌ی سیگنال مورد استفاده برای ارزیابی قانون.

نمایش 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 )

سیگنال مبتنی بر رویدادهای تبدیل نورافکن.

این فیلد فقط برای شرکای مجاز پشتیبانی می‌شود.

number

number

ارزشی که به عنوان نتیجه استفاده می‌شود.

سیگنال تبدیل فعالیت نورافکن

قانون امتیازدهی به نمایش‌ها بر اساس رویدادهای تبدیل Floodlight.

نمایش JSON 
{
  "floodlightActivityId": string,
  "countingMethod": enum (CountingMethod),
  "conversionCounting": enum (ConversionCounting)
}
فیلدها
floodlightActivityId

string ( int64 format)

الزامی. شناسه فعالیت نورافکن.

countingMethod

enum ( CountingMethod )

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

conversionCounting

enum ( ConversionCounting )

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