REST Resource: floodlightGroups

리소스: 플러드라이트Group

단일 플러드라이트 그룹

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

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