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)

โอเปอเรเตอร์ที่ใช้เปรียบเทียบค่า 2 ค่า

ในนิพจน์ที่ได้ signal จะเป็นค่าแรกและ `comparisonValue` จะเป็นค่าที่ 2

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.
}
ช่อง
สัญญาณที่ใช้ในการประเมินกฎ ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
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.
}
ช่อง
ค่าที่จะเปรียบเทียบกับสัญญาณ ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
int64Value

string (int64 format)

ค่าจำนวนเต็ม

doubleValue

number

ค่า Double

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
}
ช่อง
สัญญาณฐานที่ใช้สร้างค่า ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
activeViewSignal

enum (ActiveViewSignal)

สัญญาณที่อิงตามมุมมองแอ็กทีฟ รองรับ TIME_ON_SCREEN เท่านั้น

ช่องนี้รองรับเฉพาะพาร์ทเนอร์ที่อยู่ในรายการที่อนุญาตเท่านั้น

floodlightActivityConversionSignal

object (FloodlightActivityConversionSignal)

สัญญาณที่อิงตามเหตุการณ์ Conversion ของ Floodlight

ช่องนี้รองรับเฉพาะพาร์ทเนอร์ที่อยู่ในรายการที่อนุญาตเท่านั้น

สิ้นสุดฟิลด์ที่แยกกัน
number

number

ค่าที่จะใช้เป็นผลลัพธ์

FloodlightActivityConversionSignal

กฎในการให้คะแนนการแสดงผลตามเหตุการณ์ Conversion ของ Floodlight

การแสดง JSON
{
  "floodlightActivityId": string,
  "countingMethod": enum (CountingMethod),
  "conversionCounting": enum (ConversionCounting)
}
ช่อง
floodlightActivityId

string (int64 format)

ต้องระบุ รหัสของกิจกรรม Floodlight

countingMethod

enum (CountingMethod)

ต้องระบุ วิธีรับมูลค่าจากกิจกรรม Floodlight เช่น จํานวน Conversion

conversionCounting

enum (ConversionCounting)

ต้องระบุ ประเภทของ Conversion ที่จะใช้ในการคํานวณมูลค่าการแสดงผล เช่น Conversion หลังการคลิก