REST Resource: floodlightGroups

リソース: FloodlightGroup

1 つの 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 変数を使用して、個人情報(PII)として使用または認識される可能性のあるデータを渡すことはできません。

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

キーに指定できる値は「U1」~「U100」です。文字列値は 64 文字未満で指定してください。次の文字を含めることはできません。"<>

activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

Floodlight グループのアクティブ ビュー動画の視認性指標の設定。

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

アクティブ ビューの動画の視認性に関するカスタム指標の設定です。

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)

インプレッションを記録するために必要な表示可能な最小再生時間(秒単位)。

minimumDurationminimumQuartile、またはその両方を指定する必要があります。両方を指定した場合は、いずれかの要件が満たされていれば(いずれか早いほう)、インプレッションは指標の条件を満たしている必要があります。

minimumQuartile

enum (VideoDurationQuartile)

インプレッションを記録するために最低限必要な、動画の四分位数に基づく表示時間。

minimumDurationminimumQuartile、またはその両方を指定する必要があります。両方を指定した場合は、いずれかの要件が満たされていれば(いずれか早いほう)、インプレッションは指標の条件を満たしている必要があります。

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 第 1 四分位。
VIDEO_DURATION_QUARTILE_SECOND 第 2 四分位(中点)。
VIDEO_DURATION_QUARTILE_THIRD 第 3 四分位。
VIDEO_DURATION_QUARTILE_FOURTH 第 4 四分位(完了)。

Methods

get

Floodlight グループを取得します。

patch

既存の Floodlight グループを更新します。