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

方法

get

 取得 Floodlight 群組。

patch

 更新現有的 Floodlight 群組。