AlgorithmRules

אלגוריתם מבוסס-כללים.

ייצוג ב-JSON 
{
  "impressionSignalRuleset": {
    object (Ruleset)
  },
  "postImpressionSignalRuleset": {
    object (Ruleset)
  },
  "attributionModelId": string
}
שדות
impressionSignalRuleset

object (Ruleset)

כללים לגבי אותות החשיפה.
postImpressionSignalRuleset

object (Ruleset)

כללים לאותות בעקבות חשיפה.

השדה הזה נתמך רק בשותפים שנכללים ברשימת ההיתרים.
attributionModelId

string (int64 format)

מודל השיוך לאלגוריתם.

השדה הזה נתמך רק בשותפים שנכללים ברשימת ההיתרים.

Ruleset

קבוצת כללים שמורכבת מרשימה של כללים ומאופן צבירת הערכים שמתקבלים.

ייצוג ב-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)

חובה. סוג ההמרות שישמשו לחישוב ערך החשיפה, לדוגמה, המרות לאחר קליק.