REST Resource: floodlightGroups

ทรัพยากร: FloodlightGroup

กลุ่ม Floodlight กลุ่มเดียว

การแสดง JSON
{
  "name": string,
  "floodlightGroupId": string,
  "displayName": string,
  "webTagType": enum (WebTagType),
  "lookbackWindow": {
    object (LookbackWindow)
  },
  "customVariables": {
    object
  },
  "activeViewConfig": {
    object (ActiveViewVideoViewabilityMetricConfig)
  }
}
ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของกลุ่ม Floodlight

floodlightGroupId

string (int64 format)

เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของกลุ่ม Floodlight กำหนดโดยระบบ

displayName

string

ต้องระบุ ชื่อที่แสดงของกลุ่ม Floodlight

webTagType

enum (WebTagType)

ต้องระบุ ประเภทแท็กเว็บที่เปิดใช้สําหรับกลุ่ม Floodlight

lookbackWindow

object (LookbackWindow)

ต้องระบุ กรอบเวลามองย้อนกลับสําหรับกลุ่ม Floodlight ต้องระบุทั้ง clickDays และ impressionDays ค่าที่ยอมรับได้สำหรับทั้ง 2 รายการคือ 0 ถึง 90

customVariables

object (Struct format)

ตัวแปรที่กําหนดเองซึ่งผู้ใช้กําหนดซึ่งกลุ่ม Floodlight เป็นเจ้าของ ใช้ตัวแปร Floodlight ที่กำหนดเองเพื่อสร้างข้อมูลการรายงานที่เหมาะกับความต้องการทางธุรกิจที่เฉพาะเจาะจงของคุณ ตัวแปร Floodlight ที่กำหนดเองใช้คีย์ U1=, U2= และอื่นๆ และคุณจะนำค่าที่คุณเลือกส่งไปให้ได้ คุณสามารถใช้ตัวแปรเหล่านี้เพื่อติดตามข้อมูลเกือบทุกประเภทที่คุณรวบรวมเกี่ยวกับลูกค้า เช่น ประเภทภาพยนตร์ที่ลูกค้าซื้อ ประเทศที่จัดส่งสินค้า และอื่นๆ

คุณไม่สามารถใช้ตัวแปร Floodlight ที่กำหนดเองเพื่อส่งข้อมูลที่อาจนำไปใช้หรือรับรู้ได้ว่าเป็นข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII)

ตัวอย่าง: customVariables { fields { "U1": value { numberValue: 123.4 }, "U2": value { stringValue: "MyVariable2" }, "U3": value { stringValue: "MyVariable3" } } }

ค่าที่ยอมรับได้สำหรับคีย์คือ "U1" ถึง "U100" (รวมค่าแรกและค่าสุดท้าย) ค่าสตริงต้องมีความยาวไม่เกิน 64 อักขระและต้องไม่มีอักขระ "<>

activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

การกําหนดค่าเมตริกการมองเห็นโฆษณาวิดีโอของมุมมองแอ็กทีฟสําหรับกลุ่ม Floodlight

WebTagType

ประเภทแท็กเว็บที่เป็นไปได้สําหรับกลุ่ม Floodlight

Enum
WEB_TAG_TYPE_UNSPECIFIED ไม่ได้ระบุค่าประเภทหรือค่าประเภทไม่รู้จักในเวอร์ชันนี้
WEB_TAG_TYPE_NONE ไม่มีประเภทแท็ก
WEB_TAG_TYPE_IMAGE แท็กรูปภาพ
WEB_TAG_TYPE_DYNAMIC แท็กแบบไดนามิก

LookbackWindow

ระบุจํานวนวันที่ย้อนกลับไปเพื่อพิจารณาว่าจะบันทึก Conversion หรือไม่

การแสดง JSON
{
  "clickDays": integer,
  "impressionDays": integer
}
ช่อง
clickDays

integer

กรอบเวลามองย้อนกลับเป็นจำนวนวันนับจากครั้งที่ผู้ใช้รายหนึ่งคลิกโฆษณาของคุณครั้งล่าสุด

impressionDays

integer

กรอบเวลามองย้อนกลับเป็นจำนวนวันนับจากครั้งล่าสุดที่ผู้ใช้ที่ระบุดูโฆษณารายการใดรายการหนึ่งของคุณ

ActiveViewVideoViewabilityMetricConfig

การกําหนดค่าสําหรับเมตริกการมองเห็นวิดีโอมุมมองแอ็กทีฟที่กําหนดเอง

การแสดง JSON
{
  "displayName": string,
  "minimumViewability": enum (VideoViewabilityPercent),
  "minimumVolume": enum (VideoVolumePercent),
  "minimumDuration": enum (VideoDurationSeconds),
  "minimumQuartile": enum (VideoDurationQuartile)
}
ช่อง
displayName

string

ต้องระบุ ชื่อที่แสดงของเมตริกที่กําหนดเอง

minimumViewability

enum (VideoViewabilityPercent)

ต้องระบุ เปอร์เซ็นต์ขั้นต่ำของพิกเซลโฆษณาวิดีโอที่มองเห็นบนหน้าจอเพื่อให้ระบบบันทึกการแสดงผล

minimumVolume

enum (VideoVolumePercent)

ต้องระบุ เปอร์เซ็นต์ขั้นต่ำของปริมาณโฆษณาวิดีโอที่จําเป็นเพื่อให้ระบบบันทึกการแสดงผล

minimumDuration

enum (VideoDurationSeconds)

ระยะเวลาขั้นต่ำของวิดีโอที่มองเห็นได้ (เป็นวินาที) เพื่อให้ระบบบันทึกการแสดงผล

คุณต้องระบุ minimumDuration, minimumQuartile หรือทั้ง 2 อย่าง หากมีการระบุทั้ง 2 อย่าง การแสดงผลจะตรงตามเกณฑ์เมตริกหากเป็นไปตามข้อกำหนดข้อใดข้อหนึ่ง (ขึ้นอยู่กับว่ากรณีใดจะเกิดขึ้นก่อน)

minimumQuartile

enum (VideoDurationQuartile)

ระยะเวลาขั้นต่ำของวิดีโอที่มองเห็นได้ซึ่งขึ้นอยู่กับควอร์ไทล์ของวิดีโอเพื่อบันทึกการแสดงผล

คุณต้องระบุ minimumDuration, minimumQuartile หรือทั้ง 2 อย่าง หากมีการระบุทั้ง 2 อย่าง การแสดงผลจะตรงตามเกณฑ์เมตริกหากเป็นไปตามข้อกำหนดข้อใดข้อหนึ่ง (ขึ้นอยู่กับว่ากรณีใดจะเกิดขึ้นก่อน)

VideoViewabilityPercent

ค่าเปอร์เซ็นต์ที่เป็นไปได้ของพิกเซลที่มองเห็นได้ของโฆษณาวิดีโอ

Enum
VIEWABILITY_PERCENT_UNSPECIFIED ไม่ได้ระบุค่าหรือไม่ทราบค่าในเวอร์ชันนี้
VIEWABILITY_PERCENT_0 สามารถดูได้ 0%
VIEWABILITY_PERCENT_25 มองเห็นได้ 25%
VIEWABILITY_PERCENT_50 50%
VIEWABILITY_PERCENT_75 ดูได้ 75%
VIEWABILITY_PERCENT_100 แสดงได้ 100%

VideoVolumePercent

ค่าเปอร์เซ็นต์ที่เป็นไปได้ของระดับเสียงการเล่นของโฆษณาวิดีโอ

Enum
VIDEO_VOLUME_PERCENT_UNSPECIFIED ไม่ได้ระบุค่าหรือไม่ทราบค่าในเวอร์ชันนี้
VIDEO_VOLUME_PERCENT_0 ระดับเสียง 0%
VIDEO_VOLUME_PERCENT_10 ระดับเสียง 10%

VideoDurationSeconds

ค่าที่เป็นไปได้ของระยะเวลาที่มองเห็นได้ของโฆษณาวิดีโอเป็นวินาที

Enum
VIDEO_DURATION_UNSPECIFIED ไม่ได้ระบุค่าหรือไม่ทราบค่าในเวอร์ชันนี้
VIDEO_DURATION_SECONDS_NONE ไม่มีค่าระยะเวลา
VIDEO_DURATION_SECONDS_0 0 วินาที
VIDEO_DURATION_SECONDS_1 1 วินาที
VIDEO_DURATION_SECONDS_2 2 วินาที
VIDEO_DURATION_SECONDS_3 3 วินาที
VIDEO_DURATION_SECONDS_4 4 วินาที
VIDEO_DURATION_SECONDS_5 5 วินาที
VIDEO_DURATION_SECONDS_6 6 วินาที
VIDEO_DURATION_SECONDS_7 7 วินาที
VIDEO_DURATION_SECONDS_8 8 วินาที
VIDEO_DURATION_SECONDS_9 9 วินาที
VIDEO_DURATION_SECONDS_10 10 วินาที
VIDEO_DURATION_SECONDS_11 11 วินาที
VIDEO_DURATION_SECONDS_12 12 วินาที
VIDEO_DURATION_SECONDS_13 13 วินาที
VIDEO_DURATION_SECONDS_14 14 วินาที
VIDEO_DURATION_SECONDS_15 15 วินาที
VIDEO_DURATION_SECONDS_30 30 วินาที
VIDEO_DURATION_SECONDS_45 45 วินาที
VIDEO_DURATION_SECONDS_60 60 วินาที

VideoDurationQuartile

ค่าควอไทล์ที่เป็นไปได้ของระยะเวลาที่มองเห็นของโฆษณาวิดีโอ

Enum
VIDEO_DURATION_QUARTILE_UNSPECIFIED ไม่ได้ระบุค่าหรือไม่ทราบค่าในเวอร์ชันนี้
VIDEO_DURATION_QUARTILE_NONE ไม่มีค่าควอไทล์
VIDEO_DURATION_QUARTILE_FIRST ควอไทล์แรก
VIDEO_DURATION_QUARTILE_SECOND ควอไทล์ที่สอง (จุดกึ่งกลาง)
VIDEO_DURATION_QUARTILE_THIRD ควอร์ไทล์ที่ 3
VIDEO_DURATION_QUARTILE_FOURTH ควอร์ไทล์ที่ 4 (การเสร็จสมบูรณ์)

เมธอด

get

รับกลุ่ม Floodlight

patch

อัปเดตกลุ่ม Floodlight ที่มีอยู่