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 ควอร์ไทล์ที่ 2 (จุดกึ่งกลาง)
VIDEO_DURATION_QUARTILE_THIRD ควอร์ไทล์ที่ 3
VIDEO_DURATION_QUARTILE_FOURTH ควอร์ไทล์ที่ 4 (เล่นจนจบ)

เมธอด

get

 รับกลุ่ม Floodlight

patch

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