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 群組的回溯期。clickDaysimpressionDays 皆為必填。兩者可接受的值為 090 (含頭尾)。

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 播完四分之二 (中點)。
VIDEO_DURATION_QUARTILE_THIRD 播完四分之三。
VIDEO_DURATION_QUARTILE_FOURTH 第四四分位數 (完成)。

方法

get

取得 Floodlight 群組。

patch

更新現有的 Floodlight 群組。