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 群組。