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 מוגדר ל-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)

אות שמבוסס על Active View.

השדה הזה נתמך רק אצל שותפים שנמצאים ברשימת ההיתרים.
סוף השדות שמוציאים זה את זה.

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)

אות שמבוסס על Active View. יש תמיכה רק ב-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)

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