REST Resource: floodlightGroups

리소스: FloodlightGroup

단일 플러드라이트 그룹

JSON 표현 
{
  "name": string,
  "floodlightGroupId": string,
  "displayName": string,
  "webTagType": enum (WebTagType),
  "lookbackWindow": {
    object (LookbackWindow)
  },
  "customVariables": {
    object
  },
  "activeViewConfig": {
    object (ActiveViewVideoViewabilityMetricConfig)
  }
}
필드
name

string

출력 전용입니다. 플러드라이트 그룹의 리소스 이름입니다.
floodlightGroupId

string (int64 format)

출력 전용입니다. 플러드라이트 그룹의 고유 ID입니다. 시스템에서 할당합니다.
displayName

string

필수 항목입니다. 플러드라이트 그룹의 표시 이름입니다.
webTagType

enum (WebTagType)

필수 항목입니다. 플러드라이트 그룹에 사용 설정된 웹 태그 유형입니다.
lookbackWindow

object (LookbackWindow)

필수 항목입니다. 플러드라이트 그룹의 전환 확인 기간입니다. clickDays 및 impressionDays은 필수입니다. 두 값 모두 0~90(포함)입니다.
customVariables

object (Struct format)

플러드라이트 그룹이 소유한 사용자 정의 맞춤 변수입니다. 맞춤 플러드라이트 변수를 사용하여 고유한 비즈니스 요구사항에 맞는 보고 데이터를 만듭니다. 맞춤 플러드라이트 변수는 U1=, U2= 등의 키를 사용하며, 전달하려는 어떤 값이든 가져올 수 있습니다. 이를 사용하여 고객에 대해 수집하는 거의 모든 유형의 데이터(예: 고객이 구매하는 영화의 장르, 상품이 배송되는 국가 등)를 추적할 수 있습니다.

맞춤 플러드라이트 변수는 개인 식별 정보 (PII)로 사용되거나 인식될 수 있는 데이터를 전달하는 데 사용할 수 없습니다.

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

키에 허용되는 값은 'U1'부터 'U100'까지입니다. 문자열 값은 64자(영문 기준) 미만이어야 하며 "<> 문자를 포함할 수 없습니다.
activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

플러드라이트 그룹의 Active View 동영상 조회가능성 측정항목 구성입니다.

WebTagType

플러드라이트 그룹에 사용할 수 있는 웹 태그 유형입니다.

열거형
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 1분위
VIDEO_DURATION_QUARTILE_SECOND 2분위 (중간점)
VIDEO_DURATION_QUARTILE_THIRD 3분위
VIDEO_DURATION_QUARTILE_FOURTH 4분위 (완료)

메서드

get

 플러드라이트 그룹을 가져옵니다.

patch

 기존 플러드라이트 그룹을 업데이트합니다.