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 自訂變數不得用來傳送任何可用於傳送或視為個人識別資訊 (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 播完四分之二 (中點)。
VIDEO_DURATION_QUARTILE_THIRD 播完四分之三。
VIDEO_DURATION_QUARTILE_FOURTH 第四四分位數 (完成)。

方法

get

 取得 Floodlight 群組。

patch

 更新現有的 Floodlight 群組。