REST Resource: floodlightGroups

Tài nguyên: FloodlightGroup

Một nhóm Floodlight duy nhất.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "floodlightGroupId": string,
  "displayName": string,
  "webTagType": enum (WebTagType),
  "lookbackWindow": {
    object (LookbackWindow)
  },
  "customVariables": {
    object
  },
  "activeViewConfig": {
    object (ActiveViewVideoViewabilityMetricConfig)
  }
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên của nhóm Floodlight.
floodlightGroupId

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng duy nhất của nhóm Floodlight. Do hệ thống chỉ định.
displayName

string

Bắt buộc. Tên hiển thị của nhóm Floodlight.
webTagType

enum (WebTagType)

Bắt buộc. Loại thẻ trang web được bật cho nhóm Floodlight.
lookbackWindow

object (LookbackWindow)

Bắt buộc. Giai đoạn xem lại cho nhóm Floodlight. Bạn bắt buộc phải sử dụng cả clickDays và impressionDays. Các giá trị được chấp nhận cho cả hai là từ 0 đến 90.
customVariables

object (Struct format)

Biến tuỳ chỉnh do người dùng xác định thuộc nhóm Floodlight. Sử dụng các biến Floodlight tuỳ chỉnh để tạo dữ liệu báo cáo phù hợp với nhu cầu kinh doanh riêng biệt của bạn. Biến Floodlight tuỳ chỉnh sử dụng các khoá U1=, U2=, v.v. và có thể nhận mọi giá trị mà bạn chọn truyền vào đó. Bạn có thể sử dụng các biến này để theo dõi hầu hết mọi loại dữ liệu mà bạn thu thập về khách hàng, chẳng hạn như thể loại phim mà khách hàng mua, quốc gia mà mặt hàng được vận chuyển, v.v.

Bạn không được sử dụng các biến Floodlight tuỳ chỉnh để truyền bất kỳ dữ liệu nào có thể được dùng hoặc được coi là thông tin nhận dạng cá nhân (PII).

Ví dụ: customVariables { fields { "U1": value { numberValue: 123.4 }, "U2": value { stringValue: "MyVariable2" }, "U3": value { stringValue: "MyVariable3" } } }

Các giá trị có thể chấp nhận cho khoá là "U1" đến "U100". Giá trị chuỗi phải có độ dài dưới 64 ký tự và không được chứa các ký tự sau: "<>.
activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

Cấu hình chỉ số khả năng xem video của Chế độ xem đang kích hoạt cho nhóm Floodlight.

WebTagType

Các loại thẻ trang web có thể có cho một nhóm Floodlight.

Enum
WEB_TAG_TYPE_UNSPECIFIED Bạn chưa chỉ định hoặc không xác định được giá trị loại trong phiên bản này.
WEB_TAG_TYPE_NONE Không có loại thẻ.
WEB_TAG_TYPE_IMAGE Thẻ hình ảnh.
WEB_TAG_TYPE_DYNAMIC Thẻ động.

LookbackWindow

Chỉ định số ngày trong quá khứ cần xem xét khi xác định có ghi lại một lượt chuyển đổi hay không.

Biểu diễn dưới dạng JSON 
{
  "clickDays": integer,
  "impressionDays": integer
}
Trường
clickDays

integer

Khoảng thời gian xem lại (tính bằng ngày) kể từ lần cuối cùng một người dùng nhất định nhấp vào một trong những quảng cáo của bạn.
impressionDays

integer

Khoảng thời gian xem lại (tính bằng ngày) kể từ lần cuối cùng một người dùng nhất định xem một trong các quảng cáo của bạn.

ActiveViewVideoViewabilityMetricConfig

Cấu hình cho các chỉ số tuỳ chỉnh về khả năng xem video của Active View.

Biểu diễn dưới dạng JSON 
{
  "displayName": string,
  "minimumViewability": enum (VideoViewabilityPercent),
  "minimumVolume": enum (VideoVolumePercent),
  "minimumDuration": enum (VideoDurationSeconds),
  "minimumQuartile": enum (VideoDurationQuartile)
}
Trường
displayName

string

Bắt buộc. Tên hiển thị của chỉ số tuỳ chỉnh.
minimumViewability

enum (VideoViewabilityPercent)

Bắt buộc. Tỷ lệ phần trăm tối thiểu số pixel của quảng cáo dạng video hiển thị trên màn hình để hệ thống ghi nhận một lượt hiển thị.
minimumVolume

enum (VideoVolumePercent)

Bắt buộc. Tỷ lệ phần trăm tối thiểu về âm lượng của quảng cáo dạng video cần thiết để ghi lại một lượt hiển thị.
minimumDuration

enum (VideoDurationSeconds)

Thời lượng tối thiểu mà video phải hiển thị (tính bằng giây) để lượt hiển thị được ghi lại.

Bạn phải chỉ định minimumDuration, minimumQuartile hoặc cả hai. Nếu bạn chỉ định cả hai, thì một lượt hiển thị sẽ đáp ứng tiêu chí về chỉ số nếu đáp ứng một trong hai yêu cầu (bất kể yêu cầu nào được đáp ứng trước).
minimumQuartile

enum (VideoDurationQuartile)

Thời lượng tối thiểu mà video hiển thị, dựa trên các phần tư của video, để một lượt hiển thị được ghi lại.

Bạn phải chỉ định minimumDuration, minimumQuartile hoặc cả hai. Nếu bạn chỉ định cả hai, thì một lượt hiển thị sẽ đáp ứng tiêu chí về chỉ số nếu đáp ứng một trong hai yêu cầu (bất kể yêu cầu nào được đáp ứng trước).

VideoViewabilityPercent

Các giá trị phần trăm có thể có của số pixel hiển thị của quảng cáo dạng video.

Enum
VIEWABILITY_PERCENT_UNSPECIFIED Giá trị không được chỉ định hoặc không xác định trong phiên bản này.
VIEWABILITY_PERCENT_0 0% có thể xem.
VIEWABILITY_PERCENT_25 Có thể xem 25%.
VIEWABILITY_PERCENT_50 Có thể xem 50%.
VIEWABILITY_PERCENT_75 75% có thể xem.
VIEWABILITY_PERCENT_100 Có thể xem 100%.

VideoVolumePercent

Các giá trị phần trăm có thể có của âm lượng phát quảng cáo dạng video.

Enum
VIDEO_VOLUME_PERCENT_UNSPECIFIED Giá trị không được chỉ định hoặc không xác định trong phiên bản này.
VIDEO_VOLUME_PERCENT_0 Âm lượng ở mức 0%.
VIDEO_VOLUME_PERCENT_10 Âm lượng ở mức 10%.

VideoDurationSeconds

Các giá trị có thể có tính bằng giây về thời lượng hiển thị của quảng cáo dạng video.

Enum
VIDEO_DURATION_UNSPECIFIED Giá trị không được chỉ định hoặc không xác định trong phiên bản này.
VIDEO_DURATION_SECONDS_NONE Không có giá trị thời lượng.
VIDEO_DURATION_SECONDS_0 0 giây.
VIDEO_DURATION_SECONDS_1 1 giây.
VIDEO_DURATION_SECONDS_2 2 giây.
VIDEO_DURATION_SECONDS_3 3 giây.
VIDEO_DURATION_SECONDS_4 4 giây.
VIDEO_DURATION_SECONDS_5 5 giây.
VIDEO_DURATION_SECONDS_6 6 giây.
VIDEO_DURATION_SECONDS_7 7 giây.
VIDEO_DURATION_SECONDS_8 8 giây.
VIDEO_DURATION_SECONDS_9 9 giây.
VIDEO_DURATION_SECONDS_10 10 giây.
VIDEO_DURATION_SECONDS_11 11 giây.
VIDEO_DURATION_SECONDS_12 12 giây.
VIDEO_DURATION_SECONDS_13 13 giây.
VIDEO_DURATION_SECONDS_14 14 giây.
VIDEO_DURATION_SECONDS_15 15 giây.
VIDEO_DURATION_SECONDS_30 30 giây.
VIDEO_DURATION_SECONDS_45 45 giây.
VIDEO_DURATION_SECONDS_60 60 giây.

VideoDurationQuartile

Các giá trị có thể có của tứ phân vị về thời lượng hiển thị của quảng cáo dạng video.

Enum
VIDEO_DURATION_QUARTILE_UNSPECIFIED Giá trị không được chỉ định hoặc không xác định trong phiên bản này.
VIDEO_DURATION_QUARTILE_NONE Không có giá trị tứ phân vị.
VIDEO_DURATION_QUARTILE_FIRST Tứ phân vị thứ nhất.
VIDEO_DURATION_QUARTILE_SECOND Tứ phân vị thứ hai (điểm giữa).
VIDEO_DURATION_QUARTILE_THIRD Tứ phân vị thứ ba.
VIDEO_DURATION_QUARTILE_FOURTH Tứ phân vị thứ tư (hoàn thành).

Phương thức

get

 Lấy một nhóm Floodlight.

patch

 Cập nhật một nhóm Floodlight hiện có.