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 
{

  // 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)

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