- 리소스: CuratedPackage
- 상태
- AccessControlSettings
- PackageTargeting
- DeviceType
- 환경
- CreativeFormat
- AcceleratedMobilePageType
- AuthorizedSellerStatus
- NativeInventoryType
- OpenMeasurementType
- RestrictedCategory
- RewardedType
- PackageVideoTargeting
- VideoMimeType
- MaximumVideoAdDuration
- PositionType
- ContentDeliveryMethod
- VideoPlcmtTargeting
- SelectionType
- VideoPlcmtType
- PlaybackMethod
- VideoPlayerSizeTargeting
- StringTargetingDimension
- AdSize
- 유형
- CriteriaTargeting
- PackagePlacementTargeting
- PackagePublisherProvidedSignalsTargeting
- TaxonomyTargeting
- CurationFeeVisibility
- 메서드
리소스: CuratedPackage
큐레이터가 만들고 관리하는 선별된 인벤토리 패키지를 나타냅니다.
| JSON 표현 |
|---|
{ "name": string, "displayName": string, "description": string, "createTime": string, "updateTime": string, "floorPriceCpm": { object ( |
| 필드 | |
|---|---|
name |
식별자. 선별된 패키지의 고유 리소스 이름입니다. 형식: |
displayName |
필수 항목입니다. 큐레이터가 선별된 패키지에 할당한 표시 이름입니다. |
description |
선택사항입니다. 큐레이터가 제공하는 큐레이션된 패키지에 대한 설명입니다. |
createTime |
출력 전용입니다. 선별된 패키지가 생성된 타임스탬프입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
updateTime |
출력 전용입니다. 선별된 패키지가 마지막으로 업데이트된 타임스탬프입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
floorPriceCpm |
선택사항입니다. 이 큐레이션된 패키지의 인벤토리 입찰에 참여하기 위해 구매자가 입찰해야 하는 최소 CPM입니다. |
state |
출력 전용입니다. 선별된 패키지의 상태입니다. |
accessSettings |
필수 항목입니다. 선별된 패키지에 대한 액세스를 제어하는 설정입니다. 이 선별된 패키지에 대한 액세스는 허용 목록에 추가된 미디어 기획자와 크리에이터로 제한됩니다. 구매자와 입찰자는 이 리소스에 대해 허용 목록에 추가되거나 직접 액세스할 수 없습니다. |
targeting |
선택사항입니다. 선별된 패키지의 타겟팅 기준입니다. |
curationFeeVisibility |
선택사항입니다. 변경할 수 없습니다. 결합된 큐레이션 패키지 수수료와 데이터 세그먼트 수수료 (총 큐레이션 수수료)의 표시 여부 |
| 이 패키지에 대해 큐레이터에게 지급되는 수수료입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다. | |
feeCpm |
선택사항입니다. 큐레이터가 이 선별된 패키지를 사용하는 구매자에게 청구하는 CPM 수수료입니다. |
millipercentOfMediaFee |
선택사항입니다. 수수료는 노출 비용의 백분율로 청구되며, 밀리퍼센트로 표시됩니다. 예를 들어 1% 는 1000으로 표시됩니다. |
| 상호 배타적 필드의 끝입니다. | |
주
선별된 패키지의 상태입니다.
| 열거형 | |
|---|---|
STATE_UNSPECIFIED |
기본값 |
ACTIVE |
선별된 패키지가 활성 상태입니다. |
INACTIVE |
선별된 패키지가 비활성 상태입니다. |
AccessControlSettings
선별된 패키지에 대한 액세스를 제어하는 설정입니다.
| JSON 표현 |
|---|
{ "allowlistedMediaPlanners": [ string ] } |
| 필드 | |
|---|---|
allowlistedMediaPlanners[] |
필수 항목. 변경할 수 없습니다. 선별된 패키지에 대한 액세스 권한이 명시적으로 부여된 미디어 기획자 목록입니다. 사용 가능한 미디어 기획자는 형식: |
PackageTargeting
선별 패키지 및 입찰 패키지의 타겟팅 기준입니다.
| JSON 표현 |
|---|
{ "includedDeviceTypes": [ enum ( |
| 필드 | |
|---|---|
includedDeviceTypes[] |
선택사항입니다. 타겟팅할 포함된 기기 유형 목록입니다. 비어 있으면 모든 기기 유형이 타겟팅됩니다. |
includedEnvironment |
선택사항입니다. 타겟팅할 환경입니다. 지정하지 않으면 모든 환경이 타겟팅됩니다. |
includedCreativeFormat |
선택사항입니다. 타겟팅할 광고 소재 형식입니다. 설정하지 않으면 모든 광고 소재 마크업 유형이 타겟팅됩니다. |
includedAcceleratedMobilePageType |
선택사항입니다. 타겟팅된 Accelerated Mobile Pages 유형입니다. 설정하지 않으면 AMP 상태와 관계없이 인벤토리가 타겟팅됩니다. |
includedAuthorizedSellerStatuses[] |
선택사항입니다. 타겟팅된 공식 판매자 상태의 포함된 목록입니다. 비어 있으면 판매자 상태와 관계없이 인벤토리가 타겟팅됩니다. |
includedNativeInventoryTypes[] |
선택사항입니다. 타겟팅된 네이티브 인벤토리 유형입니다. 비어 있으면 네이티브 인벤토리 유형과 관계없이 인벤토리가 타겟팅됩니다. |
includedOpenMeasurementTypes[] |
선택사항입니다. 타겟팅된 Open Measurement 유형의 목록입니다. 비어 있으면 Open Measurement 지원 여부와 관계없이 인벤토리가 타겟팅됩니다. |
includedRestrictedCategories[] |
선택사항입니다. 타겟팅된 제한된 카테고리의 목록입니다. 비어 있으면 제한된 카테고리와 관계없이 인벤토리가 타겟팅됩니다. |
includedRewardedType |
선택사항입니다. 타겟팅된 보상 유형입니다. 설정하지 않으면 보상 유형과 관계없이 인벤토리가 타겟팅됩니다. |
videoTargeting |
선택사항입니다. 동영상별 타겟팅 기준입니다. |
minimumPredictedViewabilityPercentage |
선택사항입니다. 타겟팅된 최소 예상 조회가능성 비율입니다. 이 값은 10 이상 90 이하의 10의 배수여야 합니다. 예를 들어 10은 유효하지만 0, 15, 100은 유효하지 않습니다. 값이 10이면 조회가능성이 10% 이상으로 예측되는 광고 슬롯만 구성과 일치합니다. 값이 설정되지 않으면 예상 조회가능성과 관계없이 인벤토리가 타겟팅됩니다. |
languageTargeting |
선택사항입니다. 타겟팅할 언어입니다. 설정하지 않으면 언어와 관계없이 인벤토리가 타겟팅됩니다. 지원되는 언어 코드 목록은 https://developers.google.com/google-ads/api/data/codes-formats#languages를 참고하세요. |
includedAdSizes[] |
선택사항입니다. 타겟팅할 광고 크기 목록입니다. 설정하지 않으면 광고 크기와 관계없이 인벤토리가 타겟팅됩니다. 선별된 패키지는 |
publisherTargeting |
선택사항입니다. 타겟팅된 게시자입니다. 설정하지 않으면 게시자와 관계없이 인벤토리가 타겟팅됩니다. 게시자는 ads.txt/app-ads.txt의 게시자 ID로 식별됩니다. 자세한 내용은 https://iabtechlab.com/ads-txt/ 및 https://iabtechlab.com/app-ads-txt/를 참고하세요. |
minimumPredictedClickThroughRatePercentageMillis |
선택사항입니다. 타겟팅된 최소 예상 클릭률로, 값 범위는 [10, 10000] (0.01%~10%)입니다. 값이 50이면 클릭률이 0.05% 이상으로 예측되는 광고 슬롯만 구성과 일치합니다. 값이 설정되지 않으면 예상 클릭률과 관계없이 인벤토리가 타겟팅됩니다. |
verticalTargeting |
선택사항입니다. https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals에 정의된 대로 포함되거나 제외된 카테고리입니다. 설정하지 않으면 카테고리와 관계없이 인벤토리가 타겟팅됩니다. |
geoTargeting |
선택사항입니다. https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv에 정의된 대로 포함하거나 제외할 지역 기준 ID입니다. 설정하지 않으면 지역에 관계없이 인벤토리가 타겟팅됩니다. |
includedDataSegments[] |
선택사항입니다. 타겟팅할 활성 데이터 세그먼트입니다. 설정하지 않으면 데이터 세그먼트와 관계없이 인벤토리가 타겟팅됩니다. 형식: |
placementTargeting |
선택사항입니다. 게재위치 타겟팅 정보(예: URL, 모바일 애플리케이션) |
publisherProvidedSignalsTargeting |
선택사항입니다. 타겟팅할 게시자 제공 신호입니다. 설정하지 않으면 게시자 제공 신호와 관계없이 인벤토리가 타겟팅됩니다. |
DeviceType
타겟팅할 기기의 일반적인 유형입니다.
| 열거형 | |
|---|---|
DEVICE_TYPE_UNSPECIFIED |
기본값 타겟팅 사양에 사용해서는 안 됩니다. |
DEVICE_TYPE_PERSONAL_COMPUTER |
데스크톱 또는 노트북 컴퓨터를 타겟팅합니다. |
DEVICE_TYPE_CONNECTED_TV |
커넥티드 TV를 타겟팅합니다. 스마트 TV, 게임 콘솔, 스트리밍 박스/스틱 등 TV 콘텐츠를 스트리밍하는 기기입니다. |
DEVICE_TYPE_PHONE |
고급형 휴대기기를 타겟팅합니다. |
DEVICE_TYPE_TABLET |
태블릿 기기를 타겟팅합니다. |
환경
타겟팅할 환경입니다.
| 열거형 | |
|---|---|
ENVIRONMENT_UNSPECIFIED |
기본값 타겟팅 사양에 사용해서는 안 됩니다. |
ENVIRONMENT_SITE |
광고 지원 웹사이트 내에서 렌더링되는 인벤토리를 타겟팅합니다. |
ENVIRONMENT_APP |
모바일 애플리케이션 내의 인벤토리를 타겟팅합니다. |
CreativeFormat
타겟팅할 수 있는 광고 소재 형식입니다.
| 열거형 | |
|---|---|
CREATIVE_FORMAT_UNSPECIFIED |
기본값 타겟팅 사양에 사용해서는 안 됩니다. |
CREATIVE_FORMAT_DISPLAY |
HTML 디스플레이 광고 소재를 위한 광고 슬롯을 타겟팅합니다. |
CREATIVE_FORMAT_VIDEO |
동영상 광고 소재를 위한 광고 슬롯을 타겟팅합니다. |
CREATIVE_FORMAT_AUDIO |
오디오 광고 소재를 위한 광고 슬롯을 타겟팅합니다. |
AcceleratedMobilePageType
타겟팅할 Accelerated Mobile Pages (AMP) 구현 유형입니다.
| 열거형 | |
|---|---|
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED |
기본값 타겟팅 사양에 사용해서는 안 됩니다. |
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP |
AMP 프레임워크를 사용하지 않는 표준 웹페이지의 인벤토리를 타겟팅합니다. |
ACCELERATED_MOBILE_PAGE_TYPE_AMP |
핵심 AMP HTML 프레임워크를 사용하여 빌드된 페이지의 인벤토리를 타겟팅합니다. |
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY |
시각적 스토리텔링 (예: 탭할 수 있는 전체 화면 환경)에 최적화된 AMP 스토리 (STAMP) 형식을 사용하는 페이지의 인벤토리를 타겟팅합니다. |
AuthorizedSellerStatus
ads.txt 또는 app-ads.txt 파일에 선언된 게시자와 판매자 간의 관계를 나타냅니다.
| 열거형 | |
|---|---|
AUTHORIZED_SELLER_STATUS_UNSPECIFIED |
기본값 타겟팅 사양에 사용해서는 안 됩니다. |
AUTHORIZED_SELLER_STATUS_DIRECT |
판매자가 'DIRECT'로 선언된 인벤토리를 타겟팅합니다. 이는 게시자 (콘텐츠 소유자)가 판매자 계정을 직접 관리하며 이 계정에 대해 광고 시스템과 직접적인 비즈니스 계약을 체결했음을 나타냅니다. |
AUTHORIZED_SELLER_STATUS_RESELLER |
판매자가 'RESELLER'로 선언된 인벤토리를 타겟팅합니다. 이는 게시자가 다른 법인에 등록된 판매자 계정을 운영하고 광고 공간을 재판매하도록 승인했음을 나타냅니다. |
NativeInventoryType
광고 슬롯이 지원하는 광고 소재 렌더링 유형을 나타내며, 특히 네이티브 광고와 관련이 있습니다.
| 열거형 | |
|---|---|
NATIVE_INVENTORY_TYPE_UNSPECIFIED |
기본값 타겟팅 사양에 사용해서는 안 됩니다. |
NATIVE_INVENTORY_TYPE_NATIVE_ONLY |
네이티브 광고만 허용하고 렌더링하는 광고 슬롯을 타겟팅합니다. |
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER |
네이티브 광고 또는 배너 광고를 수락하고 렌더링하는 광고 슬롯을 타겟팅합니다. |
OpenMeasurementType
타겟팅할 Open Measurement Interface Definition (OMID)의 유형입니다.
| 열거형 | |
|---|---|
OPEN_MEASUREMENT_TYPE_UNSPECIFIED |
기본값 타겟팅 사양에 사용해서는 안 됩니다. |
OPEN_MEASUREMENT_TYPE_OMID_V1 |
v1 OMID (Open Measurement Interface Definition)를 지원하는 인벤토리를 타겟팅합니다. |
RestrictedCategory
정책에 따라 타겟팅이 제한되는 특정 광고 카테고리를 나타냅니다.
| 열거형 | |
|---|---|
RESTRICTED_CATEGORY_UNSPECIFIED |
기본값 타겟팅 사양에 사용해서는 안 됩니다. |
RESTRICTED_CATEGORY_ALCOHOL |
게시자가 주류 광고를 허용하는 인벤토리를 타겟팅합니다. |
RESTRICTED_CATEGORY_GAMBLING |
게시자가 도박 광고를 허용하는 인벤토리를 타겟팅합니다. |
RewardedType
광고 인벤토리가 광고를 시청한 사용자에게 리워드를 제공하는지 여부에 따라 타겟팅 기준을 정의합니다.
| 열거형 | |
|---|---|
REWARDED_TYPE_UNSPECIFIED |
기본값 타겟팅 사양에 사용해서는 안 됩니다. |
REWARDED_TYPE_NON_REWARDED |
광고를 시청하거나 광고와 상호작용하는 사용자에게 명시적인 보상을 제공하지 않는 인벤토리를 타겟팅합니다. |
REWARDED_TYPE_REWARDED |
광고를 시청하거나 광고에 참여하는 대가로 사용자에게 리워드를 제공하는 인벤토리를 타겟팅합니다. |
PackageVideoTargeting
동영상 관련 타겟팅 기준입니다.
| JSON 표현 |
|---|
{ "includedMimeTypes": [ enum ( |
| 필드 | |
|---|---|
includedMimeTypes[] |
선택사항입니다. IANA에서 게시한 MIME 유형 문자열 (https://www.iana.org/assignments/media-types/media-types.xhtml)을 사용하는 타겟팅된 동영상 MIME 유형 목록입니다. 비어 있으면 동영상 MIME 유형과 관계없이 인벤토리가 타겟팅됩니다. |
includedMaximumAdDurationTargeting |
선택사항입니다. 타겟팅된 최대 동영상 광고 재생 시간입니다. 설정하지 않으면 최대 동영상 광고 길이와 관계없이 인벤토리가 타겟팅됩니다. |
includedPositionTypes[] |
선택사항입니다. 타겟팅된 동영상 광고 게재순위 유형입니다. 비어 있으면 동영상 광고 게재순위 유형과 관계없이 인벤토리가 타겟팅됩니다. |
includedContentDeliveryMethod |
선택사항입니다. 타겟팅된 동영상 전송 방법입니다. 설정하지 않으면 동영상 전송 방법과 관계없이 인벤토리가 타겟팅됩니다. |
plcmtTargeting |
선택사항입니다. 타겟팅된 동영상 plcmt 유형입니다. 설정하지 않으면 동영상 게재위치 유형과 관계없이 인벤토리가 타겟팅됩니다. |
includedPlaybackMethods[] |
선택사항입니다. 타겟팅된 동영상 재생 방법 목록입니다. 비어 있으면 동영상 재생 방법과 관계없이 인벤토리가 타겟팅됩니다. |
minimumPredictedCompletionRatePercentage |
선택사항입니다. 타겟팅된 최소 예상 완료율입니다. 이 값은 10 이상 90 이하의 10의 배수여야 합니다. 예를 들어 10은 유효하지만 0, 15, 100은 유효하지 않습니다. 값이 10이면 완료율이 10% 이상으로 예측되는 광고 슬롯만 구성과 일치합니다. 값이 설정되지 않으면 예상 완료율과 관계없이 인벤토리가 타겟팅됩니다. |
includedPlayerSizeTargeting |
선택사항입니다. 타겟팅된 동영상 플레이어 크기입니다. 설정하지 않으면 동영상 플레이어 크기와 관계없이 인벤토리가 타겟팅됩니다. |
VideoMimeType
타겟팅할 동영상 MIME 유형입니다.
| 열거형 | |
|---|---|
VIDEO_MIME_TYPE_UNSPECIFIED |
기본값 타겟팅 사양에 사용해서는 안 됩니다. |
VIDEO_MIME_TYPE_THREEGPP |
3G 휴대전화에서 사용되는 3GPP 컨테이너 형식입니다. |
VIDEO_MIME_TYPE_APPLICATION_MPEGURL |
HLS/M3U8 |
VIDEO_MIME_TYPE_MP4 |
일반적으로 H.264 코덱이 포함된 MPEG-4 컨테이너입니다. |
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH |
DASH. |
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT |
JavaScript (VPAID 광고에 사용됨) |
VIDEO_MIME_TYPE_WEBM |
VP9 코덱을 사용하는 WebM 컨테이너 |
MaximumVideoAdDuration
타겟팅할 동영상 광고 소재의 재생 시간 상한입니다. enum 값은 버킷을 정의하며, 값을 선택하면 광고 소재의 재생 시간이 지정된 시간보다 작거나 같아야 합니다.
| 열거형 | |
|---|---|
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED |
기본값 타겟팅 사양에 사용해서는 안 됩니다. |
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS |
길이가 15초 이하인 동영상 광고에 적용됩니다 (0 < 길이 <= 15초). |
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS |
길이가 최대 20초인 동영상 광고에 적용됩니다 (0 < 길이 <= 20초). |
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS |
길이가 최대 30초인 동영상 광고에 적용됩니다 (0 < 길이 <= 30초). |
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS |
길이가 최대 60초인 동영상 광고에 적용됩니다 (0 < 길이 <= 60초). |
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS |
길이가 최대 90초인 동영상 광고에 적용됩니다 (0 < 길이 <= 90초). |
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS |
길이가 최대 120초인 동영상 광고에 적용됩니다 (0 < 길이 <= 120초). |
PositionType
동영상 내에서 타겟팅할 수 있는 광고 위치입니다.
| 열거형 | |
|---|---|
POSITION_TYPE_UNSPECIFIED |
기본값 타겟팅 사양에 사용해서는 안 됩니다. |
POSITION_TYPE_MIDROLL |
동영상 콘텐츠 중간에 광고가 재생됩니다. |
POSITION_TYPE_POSTROLL |
동영상 콘텐츠 다음에 광고가 재생됩니다. |
POSITION_TYPE_PREROLL |
동영상 콘텐츠 전에 재생되는 광고입니다. |
ContentDeliveryMethod
동영상 콘텐츠의 전송 방법을 기반으로 하는 타겟팅 기준입니다.
| 열거형 | |
|---|---|
CONTENT_DELIVERY_METHOD_UNSPECIFIED |
기본값 타겟팅 사양에 사용해서는 안 됩니다. |
CONTENT_DELIVERY_METHOD_STREAMING |
라이브로 방송되는 동영상 콘텐츠를 타겟팅합니다. |
CONTENT_DELIVERY_METHOD_PROGRESSIVE |
클라이언트의 재생 요구에 따라 점진적으로 전송되는 동영상 콘텐츠를 타겟팅합니다. |
VideoPlcmtTargeting
동영상 게재위치 유형을 기반으로 타겟팅 기준을 정의하며, IAB OpenRTB 'plcmt' 필드에 해당하는 경우가 많습니다.
| JSON 표현 |
|---|
{ "selectionType": enum ( |
| 필드 | |
|---|---|
selectionType |
필수 항목입니다. 동영상 광고 게재위치 목록의 선택 유형입니다. |
videoPlcmtTypes[] |
필수 항목입니다. 타겟팅된 동영상 게재위치 유형의 목록입니다. 비어 있으면 동영상 게재위치 유형과 관계없이 인벤토리가 타겟팅됩니다. |
SelectionType
타겟팅 측정기준에서 사용하는 가능한 선택 유형의 enum입니다.
| 열거형 | |
|---|---|
SELECTION_TYPE_UNSPECIFIED |
지정되지 않은 선택 유형입니다. 사용해서는 안 됩니다. |
SELECTION_TYPE_INCLUDE |
타겟팅 측정기준의 값이 포함됩니다. |
SELECTION_TYPE_EXCLUDE |
타겟팅 측정기준의 값이 제외됩니다. |
VideoPlcmtType
OpenRTB 표준에 따라 동영상 게재위치 유형을 나타냅니다.
| 열거형 | |
|---|---|
VIDEO_PLCMT_TYPE_UNSPECIFIED |
기본값 타겟팅 사양에 사용해서는 안 됩니다. |
INSTREAM |
소비자가 요청한 스트리밍 동영상 콘텐츠의 전후 또는 중간에 재생되는 프리롤, 미드롤, 포스트롤 광고입니다. 인스트림 광고는 플레이어 시작 시 기본적으로 '소리 켜기'로 설정되어 있거나 동영상 콘텐츠를 시청하려는 사용자의 의도가 명확해야 합니다. 플레이어 주변에 다른 콘텐츠가 있을 수 있지만 동영상 콘텐츠가 사용자 방문의 주목적이어야 합니다. 페이지의 기본 콘텐츠로 유지되어야 하며, 재생 시 오디오를 재생할 수 있는 유일한 동영상 플레이어여야 합니다. 플레이어가 플로팅/고정으로 전환되면 후속 광고 호출에서 업데이트된 플레이어 크기를 정확하게 전달해야 합니다. |
ACCOMPANYING_CONTENT |
스트리밍 동영상 콘텐츠 전후 또는 중간에 재생되는 프리롤, 미드롤, 포스트롤 광고 동영상 플레이어는 텍스트 또는 그래픽 콘텐츠의 단락 전후 또는 중간에 로드 및 재생되며 표시 영역에 들어갈 때만 재생을 시작합니다. 함께 표시되는 콘텐츠는 표시 영역에 진입할 때만 재생을 시작해야 합니다. 페이지에서 스크롤하면 플로팅/고정 플레이어로 전환될 수 있습니다. |
INTERSTITIAL |
동영상 콘텐츠 없이 재생되는 동영상 광고 재생 중에는 페이지의 주요 핵심이어야 하며 표시 영역의 대부분을 차지해야 하고 스크롤하여 보이지 않게 할 수 없습니다. 이는 인앱 동영상이나 슬라이드쇼와 같은 게재위치에 표시될 수 있습니다. |
NO_CONTENT |
스트리밍 동영상 콘텐츠 없이 재생되는 동영상 광고 슬라이드쇼, 네이티브 피드, 콘텐츠 내 또는 고정/플로팅과 같은 게재위치에 표시될 수 있습니다. |
PlaybackMethod
타겟팅할 재생 방법입니다.
| 열거형 | |
|---|---|
PLAYBACK_METHOD_UNSPECIFIED |
지정되지 않은 동영상 재생 방법입니다. 사용해서는 안 됩니다. |
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON |
페이지/콘텐츠가 로드되면 재생이 자동으로 시작됩니다. |
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF |
페이지/콘텐츠가 로드되면 재생이 자동으로 시작되지만 소리는 꺼져 있습니다. |
PLAYBACK_METHOD_CLICK_TO_PLAY |
사용자 작업 (예: 재생 버튼 클릭)에 의해 재생이 시작됩니다. |
VideoPlayerSizeTargeting
타겟팅할 수 있는 동영상 플레이어의 크기를 나타냅니다. 너비와 높이를 모두 0이 아닌 값으로 설정해야 합니다.
| JSON 표현 |
|---|
{ "minimumWidth": string, "minimumHeight": string } |
| 필드 | |
|---|---|
minimumWidth |
필수 항목입니다. 동영상 플레이어의 최소 너비(픽셀)입니다. |
minimumHeight |
필수 항목입니다. 동영상 플레이어의 최소 높이(픽셀)입니다. |
StringTargetingDimension
문자열 값을 사용한 일반 타겟팅입니다.
| JSON 표현 |
|---|
{
"selectionType": enum ( |
| 필드 | |
|---|---|
selectionType |
필수 항목입니다. 이 목록의 항목을 타겟팅하는 방법입니다. |
values[] |
필수 항목입니다. 지정된 값입니다. |
AdSize
단일 광고 슬롯 또는 광고 소재의 크기를 나타냅니다.
| JSON 표현 |
|---|
{
"width": string,
"height": string,
"type": enum ( |
| 필드 | |
|---|---|
width |
광고 슬롯의 너비(픽셀)입니다. 이 필드는 크기 유형이 |
height |
광고 슬롯의 높이(픽셀)입니다. 이 필드는 크기 유형이 |
type |
광고 슬롯 크기의 유형입니다. |
유형
다양한 유형의 광고 슬롯/광고 크기를 나타냅니다.
| 열거형 | |
|---|---|
TYPE_UNSPECIFIED |
정의되지 않은 사이즈 유형의 플레이스홀더입니다. |
PIXEL |
픽셀 단위의 높이와 너비로 지정된 크기의 광고 슬롯입니다. |
INTERSTITIAL |
전면 광고 슬롯을 설명하는 특수 크기입니다. |
NATIVE |
게시자가 렌더링한 네이티브 (모바일) 광고입니다. |
FLUID |
유동적 크기 (반응형 크기)는 외부 환경의 변화에 따라 자동으로 크기가 조절될 수 있습니다. |
CriteriaTargeting
포함 및 제외된 숫자 ID 목록이 포함된 타겟팅 측정기준에 사용되는 일반 타겟팅입니다. 목록 필터 문법을 사용하여 필터링할 수 없습니다.
| JSON 표현 |
|---|
{ "targetedCriteriaIds": [ string ], "excludedCriteriaIds": [ string ] } |
| 필드 | |
|---|---|
targetedCriteriaIds[] |
포함할 숫자 ID 목록입니다. |
excludedCriteriaIds[] |
제외할 숫자 ID 목록입니다. |
PackagePlacementTargeting
특정 사이트 또는 모바일 애플리케이션과 같이 광고가 게재될 수 있는 위치에 대한 타겟팅을 나타냅니다. 서로 다른 게재위치 타겟팅 유형은 논리적 OR로 연결됩니다.
| JSON 표현 |
|---|
{ "uriTargeting": { object ( |
| 필드 | |
|---|---|
uriTargeting |
선택사항입니다. 타겟팅되거나 제외된 URL 목록입니다. 도메인에는 http/https가 제거되어야 하며 (예: google.com) URL당 최대 5개의 경로를 포함할 수 있습니다. |
mobileAppTargeting |
선택사항입니다. 게시자가 소유한 타겟팅되거나 제외된 모바일 애플리케이션 ID 목록입니다. 현재는 Android 및 Apple 앱만 지원됩니다. Android 앱 ID(예: com.google.android.apps.maps)는 Google Play 스토어 URL에서 확인할 수 있습니다. iOS 앱 ID(숫자)는 iTunes 스토어 URL 끝에서 확인할 수 있습니다. 퍼스트 파티 모바일 애플리케이션이 포함되거나 제외됩니다. |
includedMobileAppCategoryTargeting[] |
선택사항입니다. 타겟팅된 모바일 앱 카테고리의 목록입니다. |
PackagePublisherProvidedSignalsTargeting
게시자 제공 신호에 대한 타겟팅을 나타냅니다. 서로 다른 게시자 제공 신호 유형은 논리적 OR로 연결됩니다.
| JSON 표현 |
|---|
{ "audienceTargeting": { object ( |
| 필드 | |
|---|---|
audienceTargeting |
선택사항입니다. 타겟팅되거나 제외된 잠재고객 ID 목록입니다. IAB 잠재고객 분류 버전 1.1 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv)을 기반으로 합니다. |
contentTargeting |
선택사항입니다. 타겟팅되거나 제외된 콘텐츠 ID 목록입니다. IAB 콘텐츠 분류 버전 2.2 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv)를 기반으로 합니다. |
videoAndAudioSignalsTargeting |
선택사항입니다. 타겟팅 및 제외된 동영상 및 오디오 신호 ID 목록입니다. 게시자 제공 신호에서 지원하는 추가 신호입니다. |
TaxonomyTargeting
IAB 잠재고객 및 콘텐츠 분류 ID 공간을 처리하기 위한 타겟팅 기준을 정의합니다.
| JSON 표현 |
|---|
{ "targetedTaxonomyIds": [ string ], "excludedTaxonomyIds": [ string ] } |
| 필드 | |
|---|---|
targetedTaxonomyIds[] |
선택사항입니다. 타겟팅된 콘텐츠 분류 ID의 목록입니다. |
excludedTaxonomyIds[] |
선택사항입니다. 제외된 콘텐츠 분류 ID 목록입니다. |
CurationFeeVisibility
결합된 큐레이션 패키지 수수료와 데이터 세그먼트 수수료 (총 큐레이션 수수료)의 표시 여부 수수료는 항상 패키지 크리에이터에게 표시됩니다.
| 열거형 | |
|---|---|
CURATION_FEE_VISIBILITY_UNSPECIFIED |
총 큐레이션 수수료 공개 상태가 지정되지 않았습니다. |
DISCLOSED |
총 선별 수수료는 모든 구매자에게 표시됩니다. 설정하지 않으면 이 값이 기본값입니다. |
NON_DISCLOSED |
총 선별 수수료는 일부 구매자에게 표시되지 않습니다. |
메서드 |
|
|---|---|
|
기존 선별된 패키지를 활성화합니다. |
|
선별된 새 패키지를 만듭니다. |
|
기존 선별된 패키지를 비활성화합니다. |
|
리소스 이름이 지정된 선별된 패키지를 가져옵니다. |
|
지정된 큐레이터가 소유한 선별된 패키지를 나열합니다. |
|
기존 선별된 패키지를 업데이트합니다. |