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 群組的專屬 ID。由系統指派。
displayName

string

必要欄位。Floodlight 群組的顯示名稱。
webTagType

enum (WebTagType)

必要欄位。為 Floodlight 群組啟用的網頁代碼類型。
lookbackWindow

object (LookbackWindow)

必要欄位。Floodlight 群組的回溯期。clickDays 和 impressionDays 皆為必要欄位。兩者可接受的值為 0 到 90 (包含這兩者)。
customVariables

object (Struct format)

Floodlight 群組擁有的使用者定義自訂變數。Floodlight 自訂變數可讓您根據特定業務需求建立報表資料。Floodlight 自訂變數使用 U1=、U2= 等鍵，也可接受任何您選擇傳送的值。您可以使用 Floodlight 自訂變數來追蹤任何一種您針對客戶所收集的資料，例如客戶購買的電影類型、商品運達國家/地區等等。

您不得使用 Floodlight 自訂變數傳遞任何可用於/認定為個人識別資訊 (PII) 的資料。

範例：customVariables { fields { "U1": value { numberValue: 123.4 }, "U2": value { stringValue: "MyVariable2" }, "U3": value { stringValue: "MyVariable3" } } }

可接受的鍵值為「U1」到「U100」(包含這兩者)。字串值的長度不得超過 64 個半形字元，且不得包含下列字元："<>。
activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

Floodlight 群組的 Active View 影片可視度指標設定。

WebTagType

Floodlight 群組的可能網頁代碼類型。

列舉
WEB_TAG_TYPE_UNSPECIFIED 這個版本未指定類型值或不明。
WEB_TAG_TYPE_NONE 沒有代碼類型。
WEB_TAG_TYPE_IMAGE 圖片代碼。
WEB_TAG_TYPE_DYNAMIC 動態代碼。

LookbackWindow

指定要往回追溯的天數，系統會根據這項設定判斷是否要記錄轉換。

JSON 表示法 
{
  "clickDays": integer,
  "impressionDays": integer
}
欄位
clickDays

integer

回溯期 (以天為單位)，從指定使用者上次點按您的廣告開始計算。
impressionDays

integer

回溯期天數，從指定使用者上次觀看您的廣告起計算。

ActiveViewVideoViewabilityMetricConfig

自訂 Active View 影片可視度指標的設定。

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 或兩者皆指定。如果同時指定這兩項條件，只要符合任一項條件 (兩者取其先)，該曝光即符合指標規定。
minimumQuartile

enum (VideoDurationQuartile)

依據影片四分位數，計算記錄曝光所需的影片最低觀看時間。

您必須指定 minimumDuration 或 minimumQuartile，或同時指定這兩個項目。如果同時指定這兩項條件，只要符合任一項條件 (兩者取其先)，該曝光即符合指標規定。

VideoViewabilityPercent

影片廣告可顯示像素的可能百分比值。

列舉
VIEWABILITY_PERCENT_UNSPECIFIED 這個版本未指定值或值不明。
VIEWABILITY_PERCENT_0 可視度 0%。
VIEWABILITY_PERCENT_25 25% 可視。
VIEWABILITY_PERCENT_50 50% 可視。
VIEWABILITY_PERCENT_75 可視率達 75%。
VIEWABILITY_PERCENT_100 100% 可視。

VideoVolumePercent

影片廣告播放音量可能的百分比值。

列舉
VIDEO_VOLUME_PERCENT_UNSPECIFIED 這個版本未指定值或未知值。
VIDEO_VOLUME_PERCENT_0 音量為 0%。
VIDEO_VOLUME_PERCENT_10 音量調到 10%。

VideoDurationSeconds

影片廣告可見時間長度 (以秒為單位) 的可能值。

列舉
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

影片廣告可見時間的可能四分位數值。

列舉
VIDEO_DURATION_QUARTILE_UNSPECIFIED 這個版本未指定值或未知值。
VIDEO_DURATION_QUARTILE_NONE 沒有四分位數值。
VIDEO_DURATION_QUARTILE_FIRST 播完四分之一。
VIDEO_DURATION_QUARTILE_SECOND 播放到 50% (中點)。
VIDEO_DURATION_QUARTILE_THIRD 播完四分之三。
VIDEO_DURATION_QUARTILE_FOURTH 播完四分之一 (完成)。

方法

get

 取得 Floodlight 群組。

patch

 更新現有的 Floodlight 群組。