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 condition ประเมินเป็น 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` จะเป็นค่าที่สอง

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.
}
ช่อง
ฟิลด์ Union 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.
}
ช่อง
ฟิลด์ Union value ค่าที่จะเปรียบเทียบกับสัญญาณ value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
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)

มูลค่าการแลกเปลี่ยน

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
}
ช่อง
ฟิลด์ Union signal สัญญาณพื้นฐานที่ใช้ในการสร้างมูลค่า signal ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
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 หลังคลิก