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 グループのルックバック ウィンドウ。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」です。指定されています。文字列値は 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)

インプレッションを記録するには、動画の最小再生時間(秒単位)が必要です。

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

メソッド

get

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

patch

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