AlgorithmRules

Algoritma berbasis aturan.

Representasi JSON
{
  "impressionSignalRuleset": {
    object (Ruleset)
  },
  "postImpressionSignalRuleset": {
    object (Ruleset)
  },
  "attributionModelId": string
}
Kolom
impressionSignalRuleset

object (Ruleset)

Aturan untuk sinyal tayangan iklan.

postImpressionSignalRuleset

object (Ruleset)

Aturan untuk sinyal pasca-tayangan iklan.

Kolom ini hanya didukung untuk partner yang diizinkan.

attributionModelId

string (int64 format)

Model atribusi untuk algoritma.

Kolom ini hanya didukung untuk partner yang diizinkan.

Kumpulan aturan

Kumpulan aturan yang terdiri dari daftar aturan dan cara menggabungkan nilai yang dihasilkan.

Representasi JSON
{
  "rules": [
    {
      object (Rule)
    }
  ],
  "aggregationType": enum (RuleAggregationType),
  "maxValue": number
}
Kolom
rules[]

object (Rule)

Daftar aturan untuk menghasilkan nilai tayangan iklan.

aggregationType

enum (RuleAggregationType)

Cara menggabungkan nilai aturan yang dievaluasi.

maxValue

number

Nilai maksimum yang dapat dievaluasi oleh kumpulan aturan.

Aturan

Kumpulan kondisi.

Nilai yang ditampilkan dari aturan adalah:

  • Nilai yang ditampilkan untuk kondisi metrik tunggal atau
  • Nilai pengembalian default yang ditentukan jika tidak ada kondisi yang terpenuhi.
Representasi JSON
{
  "conditions": [
    {
      object (RuleCondition)
    }
  ],
  "defaultReturnValue": {
    object (SignalValue)
  }
}
Kolom
conditions[]

object (RuleCondition)

Daftar kondisi dalam aturan ini. Kriteria di antara kondisi harus saling eksklusif.

defaultReturnValue

object (SignalValue)

Nilai pengembalian default yang diterapkan jika tidak ada kondisi yang terpenuhi.

RuleCondition

Setel perbandingan sinyal. Setara dengan pernyataan if.

Representasi JSON
{
  "signalComparisons": [
    {
      object (SignalComparison)
    }
  ],
  "returnValue": {
    object (SignalValue)
  }
}
Kolom
signalComparisons[]

object (SignalComparison)

Daftar perbandingan yang membangun kondisi pernyataan if. Perbandingan digabungkan menjadi satu kondisi dengan operator logika AND.

returnValue

object (SignalValue)

Nilai yang ditampilkan jika kondisi signalComparisons menghasilkan TRUE.

SignalComparison

Satu perbandingan. Perbandingan ini membandingkan signal dengan comparisonValue.

Perbandingan siteId==123 diwakili dengan nilai kolom berikut:

  • signal memiliki impressionSignal SITE_ID.
  • comparisonOperator disetel ke EQUAL.
  • comparisonValue disetel ke 123.
Representasi JSON
{
  "signal": {
    object (Signal)
  },
  "comparisonOperator": enum (ComparisonOperator),
  "comparisonValue": {
    object (ComparisonValue)
  }
}
Kolom
signal

object (Signal)

Sinyal yang akan dibandingkan.

comparisonOperator

enum (ComparisonOperator)

Operator yang digunakan untuk membandingkan dua nilai.

Dalam ekspresi yang dihasilkan, signal akan menjadi nilai pertama dan `comparisonValue akan menjadi nilai kedua.

comparisonValue

object (ComparisonValue)

Nilai untuk membandingkan sinyal.

Sinyal

Sinyal yang digunakan untuk mengevaluasi aturan.

Representasi 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.
}
Kolom
Sinyal yang digunakan untuk mengevaluasi aturan. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
impressionSignal

enum (ImpressionSignal)

Sinyal berdasarkan tayangan iklan.

clickSignal

enum (ClickSignal)

Sinyal berdasarkan klik.

Kolom ini hanya didukung untuk partner yang diizinkan.

activeViewSignal

enum (ActiveViewSignal)

Sinyal berdasarkan tampilan aktif.

Kolom ini hanya didukung untuk partner yang diizinkan.

Akhir kolom yang saling eksklusif.

ComparisonValue

Nilai untuk membandingkan sinyal.

Representasi 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.
}
Kolom
Nilai yang akan dibandingkan dengan sinyal. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
int64Value

string (int64 format)

Nilai bilangan bulat.

doubleValue

number

Nilai ganda.

stringValue

string

Nilai string.

boolValue

boolean

Nilai boolean

creativeDimensionValue

object (Dimensions)

Nilai dimensi materi iklan.

dayAndTimeValue

object (DayAndTime)

Nilai hari dan waktu. Hanya TIME_ZONE_RESOLUTION_END_USER yang didukung.

deviceTypeValue

enum (RuleDeviceType)

Nilai jenis perangkat.

onScreenPositionValue

enum (OnScreenPosition)

Nilai posisi iklan.

environmentValue

enum (Environment)

Nilai lingkungan.

exchangeValue

enum (Exchange)

Nilai penukaran.

contentDurationValue

enum (ContentDuration)

Nilai durasi konten video.

contentStreamTypeValue

enum (ContentStreamType)

Nilai jenis penayangan video.

contentGenreIdValue

string (int64 format)

Nilai ID genre video.

videoPlayerSizeValue

enum (VideoPlayerSize)

Nilai ukuran pemutar video.

Kolom ini hanya didukung untuk partner yang diizinkan.

Akhir kolom yang saling eksklusif.

DayAndTime

Representasi waktu yang ditentukan menurut hari dalam seminggu dan jam dalam sehari.

Representasi JSON
{
  "dayOfWeek": enum (DayOfWeek),
  "hourOfDay": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
Kolom
dayOfWeek

enum (DayOfWeek)

Wajib. Hari.

hourOfDay

integer

Wajib. Waktu.

timeZoneResolution

enum (TimeZoneResolution)

Wajib. Mekanisme yang digunakan untuk menentukan zona waktu yang relevan.

SignalValue

Nilai yang disesuaikan dari sinyal yang digunakan untuk evaluasi aturan.

Representasi 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
}
Kolom
Sinyal dasar yang digunakan untuk menghasilkan nilai. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
activeViewSignal

enum (ActiveViewSignal)

Sinyal berdasarkan tampilan aktif. Hanya TIME_ON_SCREEN yang didukung.

Kolom ini hanya didukung untuk partner yang diizinkan.

floodlightActivityConversionSignal

object (FloodlightActivityConversionSignal)

Sinyal berdasarkan peristiwa konversi Floodlight.

Kolom ini hanya didukung untuk partner yang diizinkan.

Akhir kolom yang saling eksklusif.
number

number

Nilai yang akan digunakan sebagai hasil.

FloodlightActivityConversionSignal

Aturan untuk memberi skor pada tayangan iklan berdasarkan peristiwa konversi Floodlight.

Representasi JSON
{
  "floodlightActivityId": string,
  "countingMethod": enum (CountingMethod),
  "conversionCounting": enum (ConversionCounting)
}
Kolom
floodlightActivityId

string (int64 format)

Wajib. ID aktivitas Floodlight.

countingMethod

enum (CountingMethod)

Wajib. Cara mendapatkan nilai dari aktivitas Floodlight, misalnya, jumlah konversi.

conversionCounting

enum (ConversionCounting)

Wajib. Jenis konversi yang akan digunakan dalam penghitungan nilai tayangan iklan, misalnya, konversi pascaklik.