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 ارزیابی شود.

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

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

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

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

روز و زمان

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

نمایندگی 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

ارزش استفاده به عنوان نتیجه

FloodlightActivityConversionSignal

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

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

string ( int64 format)

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

countingMethod

enum ( CountingMethod )

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

conversionCounting

enum ( ConversionCounting )

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

،

الگوریتم مبتنی بر قانون

نمایندگی 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 ارزیابی شود.

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

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

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

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

روز و زمان

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

نمایندگی 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

ارزش استفاده به عنوان نتیجه

FloodlightActivityConversionSignal

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

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

string ( int64 format)

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

countingMethod

enum ( CountingMethod )

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

conversionCounting

enum ( ConversionCounting )

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