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)

필수 항목입니다. 플러드라이트 그룹의 전환 확인 기간입니다. clickDaysimpressionDays가 모두 필요합니다. 둘 다 사용 가능한 값: 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

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