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= などを使用し、任意の値を取ることができます。顧客が購入した映画のジャンルや商品の配送先の国など、顧客に関して収集した、ほぼすべてのタイプのデータのトラッキングに使用できます。

個人情報(PII)として使用または認識される可能性のあるデータを渡すためにカスタム Floodlight 変数を使用することはできません。

例: 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 四分位(50%)。
VIDEO_DURATION_QUARTILE_THIRD 第 3 四分位。
VIDEO_DURATION_QUARTILE_FOURTH 第 4 四分位(完了)。

Methods

get

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

patch

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