REST Resource: curators.curatedPackages

리소스: CuratedPackage

큐레이터가 만들고 관리하는 선별된 인벤토리 패키지를 나타냅니다.

JSON 표현
{
  "name": string,
  "displayName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "floorPriceCpm": {
    object (Money)
  },
  "state": enum (State),
  "accessSettings": {
    object (AccessControlSettings)
  },
  "targeting": {
    object (PackageTargeting)
  },
  "curationFeeVisibility": enum (CurationFeeVisibility),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "feeCpm": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
}
필드
name

string

식별자. 선별된 패키지의 고유 리소스 이름입니다. 형식: curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

필수 항목입니다. 큐레이터가 선별된 패키지에 할당한 표시 이름입니다. curatedPackages.list 메서드의 응답을 필터링하는 데 사용할 수 있습니다.

description

string

선택사항입니다. 큐레이터가 제공하는 큐레이션된 패키지에 대한 설명입니다.

createTime

string (Timestamp format)

출력 전용입니다. 선별된 패키지가 생성된 타임스탬프입니다. curatedPackages.list 메서드의 응답을 필터링하는 데 사용할 수 있습니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

updateTime

string (Timestamp format)

출력 전용입니다. 선별된 패키지가 마지막으로 업데이트된 타임스탬프입니다. curatedPackages.list 메서드의 응답을 필터링하는 데 사용할 수 있습니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

floorPriceCpm

object (Money)

선택사항입니다. 이 큐레이션된 패키지의 인벤토리 입찰에 참여하기 위해 구매자가 입찰해야 하는 최소 CPM입니다. curatedPackages.list 메서드의 응답을 필터링하는 데 사용할 수 있습니다.

state

enum (State)

출력 전용입니다. 선별된 패키지의 상태입니다. curatedPackages.list 메서드의 응답을 필터링하는 데 사용할 수 있습니다.

accessSettings

object (AccessControlSettings)

필수 항목입니다. 선별된 패키지에 대한 액세스를 제어하는 설정입니다.

이 선별된 패키지에 대한 액세스는 허용 목록에 추가된 미디어 기획자와 크리에이터로 제한됩니다. 구매자와 입찰자는 이 리소스에 대해 허용 목록에 추가되거나 직접 액세스할 수 없습니다.

targeting

object (PackageTargeting)

선택사항입니다. 선별된 패키지의 타겟팅 기준입니다.

curationFeeVisibility

enum (CurationFeeVisibility)

선택사항입니다. 변경할 수 없습니다. 결합된 큐레이션 패키지 수수료와 데이터 세그먼트 수수료 (총 큐레이션 수수료)의 표시 여부

이 패키지에 대해 큐레이터에게 지급되는 수수료입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
feeCpm

object (Money)

선택사항입니다. 큐레이터가 이 선별된 패키지를 사용하는 구매자에게 청구하는 CPM 수수료입니다. curatedPackages.list 메서드의 응답을 필터링하는 데 사용할 수 있습니다.

millipercentOfMediaFee

string (int64 format)

선택사항입니다. 수수료는 노출 비용의 백분율로 청구되며, 밀리퍼센트로 표시됩니다. 예를 들어 1% 는 1000으로 표시됩니다.

상호 배타적 필드의 끝입니다.

주

선별된 패키지의 상태입니다.

열거형
STATE_UNSPECIFIED 기본값
ACTIVE 선별된 패키지가 활성 상태입니다.
INACTIVE 선별된 패키지가 비활성 상태입니다.

AccessControlSettings

선별된 패키지에 대한 액세스를 제어하는 설정입니다.

JSON 표현
{
  "allowlistedMediaPlanners": [
    string
  ]
}
필드
allowlistedMediaPlanners[]

string

필수 항목. 변경할 수 없습니다. 선별된 패키지에 대한 액세스 권한이 명시적으로 부여된 미디어 기획자 목록입니다. 사용 가능한 미디어 기획자는 mediaPlanners.list 메서드에서 확인할 수 있습니다. 현재 미디어 기획자는 한 명만 허용 목록에 추가할 수 있습니다.

형식: mediaPlanners/{mediaPlannerAccountId}

PackageTargeting

선별 패키지 및 입찰 패키지의 타겟팅 기준입니다.

JSON 표현
{
  "includedDeviceTypes": [
    enum (DeviceType)
  ],
  "includedEnvironment": enum (Environment),
  "includedCreativeFormat": enum (CreativeFormat),
  "includedAcceleratedMobilePageType": enum (AcceleratedMobilePageType),
  "includedAuthorizedSellerStatuses": [
    enum (AuthorizedSellerStatus)
  ],
  "includedNativeInventoryTypes": [
    enum (NativeInventoryType)
  ],
  "includedOpenMeasurementTypes": [
    enum (OpenMeasurementType)
  ],
  "includedRestrictedCategories": [
    enum (RestrictedCategory)
  ],
  "includedRewardedType": enum (RewardedType),
  "videoTargeting": {
    object (PackageVideoTargeting)
  },
  "minimumPredictedViewabilityPercentage": string,
  "languageTargeting": {
    object (StringTargetingDimension)
  },
  "includedAdSizes": [
    {
      object (AdSize)
    }
  ],
  "publisherTargeting": {
    object (StringTargetingDimension)
  },
  "minimumPredictedClickThroughRatePercentageMillis": string,
  "verticalTargeting": {
    object (CriteriaTargeting)
  },
  "geoTargeting": {
    object (CriteriaTargeting)
  },
  "includedDataSegments": [
    string
  ],
  "placementTargeting": {
    object (PackagePlacementTargeting)
  },
  "publisherProvidedSignalsTargeting": {
    object (PackagePublisherProvidedSignalsTargeting)
  }
}
필드
includedDeviceTypes[]

enum (DeviceType)

선택사항입니다. 타겟팅할 포함된 기기 유형 목록입니다. 비어 있으면 모든 기기 유형이 타겟팅됩니다.

includedEnvironment

enum (Environment)

선택사항입니다. 타겟팅할 환경입니다. 지정하지 않으면 모든 환경이 타겟팅됩니다.

includedCreativeFormat

enum (CreativeFormat)

선택사항입니다. 타겟팅할 광고 소재 형식입니다. 설정하지 않으면 모든 광고 소재 마크업 유형이 타겟팅됩니다.

includedAcceleratedMobilePageType

enum (AcceleratedMobilePageType)

선택사항입니다. 타겟팅된 Accelerated Mobile Pages 유형입니다. 설정하지 않으면 AMP 상태와 관계없이 인벤토리가 타겟팅됩니다.

includedAuthorizedSellerStatuses[]

enum (AuthorizedSellerStatus)

선택사항입니다. 타겟팅된 공식 판매자 상태의 포함된 목록입니다. 비어 있으면 판매자 상태와 관계없이 인벤토리가 타겟팅됩니다.

includedNativeInventoryTypes[]

enum (NativeInventoryType)

선택사항입니다. 타겟팅된 네이티브 인벤토리 유형입니다. 비어 있으면 네이티브 인벤토리 유형과 관계없이 인벤토리가 타겟팅됩니다.

includedOpenMeasurementTypes[]

enum (OpenMeasurementType)

선택사항입니다. 타겟팅된 Open Measurement 유형의 목록입니다. 비어 있으면 Open Measurement 지원 여부와 관계없이 인벤토리가 타겟팅됩니다.

includedRestrictedCategories[]

enum (RestrictedCategory)

선택사항입니다. 타겟팅된 제한된 카테고리의 목록입니다. 비어 있으면 제한된 카테고리와 관계없이 인벤토리가 타겟팅됩니다.

includedRewardedType

enum (RewardedType)

선택사항입니다. 타겟팅된 보상 유형입니다. 설정하지 않으면 보상 유형과 관계없이 인벤토리가 타겟팅됩니다.

videoTargeting

object (PackageVideoTargeting)

선택사항입니다. 동영상별 타겟팅 기준입니다.

minimumPredictedViewabilityPercentage

string (int64 format)

선택사항입니다. 타겟팅된 최소 예상 조회가능성 비율입니다.

이 값은 10 이상 90 이하의 10의 배수여야 합니다. 예를 들어 10은 유효하지만 0, 15, 100은 유효하지 않습니다. 값이 10이면 조회가능성이 10% 이상으로 예측되는 광고 슬롯만 구성과 일치합니다.

값이 설정되지 않으면 예상 조회가능성과 관계없이 인벤토리가 타겟팅됩니다.

languageTargeting

object (StringTargetingDimension)

선택사항입니다. 타겟팅할 언어입니다. 설정하지 않으면 언어와 관계없이 인벤토리가 타겟팅됩니다. 지원되는 언어 코드 목록은 https://developers.google.com/google-ads/api/data/codes-formats#languages를 참고하세요.

includedAdSizes[]

object (AdSize)

선택사항입니다. 타겟팅할 광고 크기 목록입니다. 설정하지 않으면 광고 크기와 관계없이 인벤토리가 타겟팅됩니다.

선별된 패키지는 PIXEL 및 INTERSTITIAL 광고 크기를 지원합니다.

publisherTargeting

object (StringTargetingDimension)

선택사항입니다. 타겟팅된 게시자입니다. 설정하지 않으면 게시자와 관계없이 인벤토리가 타겟팅됩니다. 게시자는 ads.txt/app-ads.txt의 게시자 ID로 식별됩니다. 자세한 내용은 https://iabtechlab.com/ads-txt/ 및 https://iabtechlab.com/app-ads-txt/를 참고하세요.

minimumPredictedClickThroughRatePercentageMillis

string (int64 format)

선택사항입니다. 타겟팅된 최소 예상 클릭률로, 값 범위는 [10, 10000] (0.01%~10%)입니다. 값이 50이면 클릭률이 0.05% 이상으로 예측되는 광고 슬롯만 구성과 일치합니다.

값이 설정되지 않으면 예상 클릭률과 관계없이 인벤토리가 타겟팅됩니다.

verticalTargeting

object (CriteriaTargeting)

선택사항입니다. https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals에 정의된 대로 포함되거나 제외된 카테고리입니다. 설정하지 않으면 카테고리와 관계없이 인벤토리가 타겟팅됩니다.

geoTargeting

object (CriteriaTargeting)

선택사항입니다. https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv에 정의된 대로 포함하거나 제외할 지역 기준 ID입니다. 설정하지 않으면 지역에 관계없이 인벤토리가 타겟팅됩니다.

includedDataSegments[]

string

선택사항입니다. 타겟팅할 활성 데이터 세그먼트입니다. 설정하지 않으면 데이터 세그먼트와 관계없이 인벤토리가 타겟팅됩니다. 형식: curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

선택사항입니다. 게재위치 타겟팅 정보(예: URL, 모바일 애플리케이션)

publisherProvidedSignalsTargeting

object (PackagePublisherProvidedSignalsTargeting)

선택사항입니다. 타겟팅할 게시자 제공 신호입니다. 설정하지 않으면 게시자 제공 신호와 관계없이 인벤토리가 타겟팅됩니다.

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 (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
필드
includedMimeTypes[]

enum (VideoMimeType)

선택사항입니다. IANA에서 게시한 MIME 유형 문자열 (https://www.iana.org/assignments/media-types/media-types.xhtml)을 사용하는 타겟팅된 동영상 MIME 유형 목록입니다. 비어 있으면 동영상 MIME 유형과 관계없이 인벤토리가 타겟팅됩니다.

includedMaximumAdDurationTargeting

enum (MaximumVideoAdDuration)

선택사항입니다. 타겟팅된 최대 동영상 광고 재생 시간입니다. 설정하지 않으면 최대 동영상 광고 길이와 관계없이 인벤토리가 타겟팅됩니다.

includedPositionTypes[]

enum (PositionType)

선택사항입니다. 타겟팅된 동영상 광고 게재순위 유형입니다. 비어 있으면 동영상 광고 게재순위 유형과 관계없이 인벤토리가 타겟팅됩니다.

includedContentDeliveryMethod

enum (ContentDeliveryMethod)

선택사항입니다. 타겟팅된 동영상 전송 방법입니다. 설정하지 않으면 동영상 전송 방법과 관계없이 인벤토리가 타겟팅됩니다.

plcmtTargeting

object (VideoPlcmtTargeting)

선택사항입니다. 타겟팅된 동영상 plcmt 유형입니다. 설정하지 않으면 동영상 게재위치 유형과 관계없이 인벤토리가 타겟팅됩니다.

includedPlaybackMethods[]

enum (PlaybackMethod)

선택사항입니다. 타겟팅된 동영상 재생 방법 목록입니다. 비어 있으면 동영상 재생 방법과 관계없이 인벤토리가 타겟팅됩니다.

minimumPredictedCompletionRatePercentage

string (int64 format)

선택사항입니다. 타겟팅된 최소 예상 완료율입니다.

이 값은 10 이상 90 이하의 10의 배수여야 합니다. 예를 들어 10은 유효하지만 0, 15, 100은 유효하지 않습니다. 값이 10이면 완료율이 10% 이상으로 예측되는 광고 슬롯만 구성과 일치합니다.

값이 설정되지 않으면 예상 완료율과 관계없이 인벤토리가 타겟팅됩니다.

includedPlayerSizeTargeting

object (VideoPlayerSizeTargeting)

선택사항입니다. 타겟팅된 동영상 플레이어 크기입니다. 설정하지 않으면 동영상 플레이어 크기와 관계없이 인벤토리가 타겟팅됩니다.

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": [
    enum (VideoPlcmtType)
  ]
}
필드
selectionType

enum (SelectionType)

필수 항목입니다. 동영상 광고 게재위치 목록의 선택 유형입니다.

videoPlcmtTypes[]

enum (VideoPlcmtType)

필수 항목입니다. 타겟팅된 동영상 게재위치 유형의 목록입니다. 비어 있으면 동영상 게재위치 유형과 관계없이 인벤토리가 타겟팅됩니다.

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

string (int64 format)

필수 항목입니다. 동영상 플레이어의 최소 너비(픽셀)입니다.

minimumHeight

string (int64 format)

필수 항목입니다. 동영상 플레이어의 최소 높이(픽셀)입니다.

StringTargetingDimension

문자열 값을 사용한 일반 타겟팅입니다.

JSON 표현
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
필드
selectionType

enum (SelectionType)

필수 항목입니다. 이 목록의 항목을 타겟팅하는 방법입니다.

values[]

string

필수 항목입니다. 지정된 값입니다.

AdSize

단일 광고 슬롯 또는 광고 소재의 크기를 나타냅니다.

JSON 표현
{
  "width": string,
  "height": string,
  "type": enum (Type)
}
필드
width

string (int64 format)

광고 슬롯의 너비(픽셀)입니다. 이 필드는 크기 유형이 PIXEL인 경우에만 표시됩니다.

height

string (int64 format)

광고 슬롯의 높이(픽셀)입니다. 이 필드는 크기 유형이 PIXEL인 경우에만 표시됩니다.

type

enum (Type)

광고 슬롯 크기의 유형입니다.

유형

다양한 유형의 광고 슬롯/광고 크기를 나타냅니다.

열거형
TYPE_UNSPECIFIED 정의되지 않은 사이즈 유형의 플레이스홀더입니다.
PIXEL 픽셀 단위의 높이와 너비로 지정된 크기의 광고 슬롯입니다.
INTERSTITIAL 전면 광고 슬롯을 설명하는 특수 크기입니다.
NATIVE 게시자가 렌더링한 네이티브 (모바일) 광고입니다.
FLUID 유동적 크기 (반응형 크기)는 외부 환경의 변화에 따라 자동으로 크기가 조절될 수 있습니다.

CriteriaTargeting

포함 및 제외된 숫자 ID 목록이 포함된 타겟팅 측정기준에 사용되는 일반 타겟팅입니다. 목록 필터 문법을 사용하여 필터링할 수 없습니다.

JSON 표현
{
  "targetedCriteriaIds": [
    string
  ],
  "excludedCriteriaIds": [
    string
  ]
}
필드
targetedCriteriaIds[]

string (int64 format)

포함할 숫자 ID 목록입니다.

excludedCriteriaIds[]

string (int64 format)

제외할 숫자 ID 목록입니다.

PackagePlacementTargeting

특정 사이트 또는 모바일 애플리케이션과 같이 광고가 게재될 수 있는 위치에 대한 타겟팅을 나타냅니다. 서로 다른 게재위치 타겟팅 유형은 논리적 OR로 연결됩니다.

JSON 표현
{
  "uriTargeting": {
    object (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
필드
uriTargeting

object (StringTargetingDimension)

선택사항입니다. 타겟팅되거나 제외된 URL 목록입니다. 도메인에는 http/https가 제거되어야 하며 (예: google.com) URL당 최대 5개의 경로를 포함할 수 있습니다.

mobileAppTargeting

object (StringTargetingDimension)

선택사항입니다. 게시자가 소유한 타겟팅되거나 제외된 모바일 애플리케이션 ID 목록입니다. 현재는 Android 및 Apple 앱만 지원됩니다.

Android 앱 ID(예: com.google.android.apps.maps)는 Google Play 스토어 URL에서 확인할 수 있습니다. iOS 앱 ID(숫자)는 iTunes 스토어 URL 끝에서 확인할 수 있습니다. 퍼스트 파티 모바일 애플리케이션이 포함되거나 제외됩니다.

includedMobileAppCategoryTargeting[]

string (int64 format)

선택사항입니다. 타겟팅된 모바일 앱 카테고리의 목록입니다.

PackagePublisherProvidedSignalsTargeting

게시자 제공 신호에 대한 타겟팅을 나타냅니다. 서로 다른 게시자 제공 신호 유형은 논리적 OR로 연결됩니다.

JSON 표현
{
  "audienceTargeting": {
    object (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
필드
audienceTargeting

object (TaxonomyTargeting)

선택사항입니다. 타겟팅되거나 제외된 잠재고객 ID 목록입니다. IAB 잠재고객 분류 버전 1.1 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv)을 기반으로 합니다.

contentTargeting

object (TaxonomyTargeting)

선택사항입니다. 타겟팅되거나 제외된 콘텐츠 ID 목록입니다. IAB 콘텐츠 분류 버전 2.2 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv)를 기반으로 합니다.

videoAndAudioSignalsTargeting

object (StringTargetingDimension)

선택사항입니다. 타겟팅 및 제외된 동영상 및 오디오 신호 ID 목록입니다. 게시자 제공 신호에서 지원하는 추가 신호입니다.

TaxonomyTargeting

IAB 잠재고객 및 콘텐츠 분류 ID 공간을 처리하기 위한 타겟팅 기준을 정의합니다.

JSON 표현
{
  "targetedTaxonomyIds": [
    string
  ],
  "excludedTaxonomyIds": [
    string
  ]
}
필드
targetedTaxonomyIds[]

string

선택사항입니다. 타겟팅된 콘텐츠 분류 ID의 목록입니다.

excludedTaxonomyIds[]

string

선택사항입니다. 제외된 콘텐츠 분류 ID 목록입니다.

CurationFeeVisibility

결합된 큐레이션 패키지 수수료와 데이터 세그먼트 수수료 (총 큐레이션 수수료)의 표시 여부 수수료는 항상 패키지 크리에이터에게 표시됩니다.

열거형
CURATION_FEE_VISIBILITY_UNSPECIFIED 총 큐레이션 수수료 공개 상태가 지정되지 않았습니다.
DISCLOSED 총 선별 수수료는 모든 구매자에게 표시됩니다. 설정하지 않으면 이 값이 기본값입니다.
NON_DISCLOSED 총 선별 수수료는 일부 구매자에게 표시되지 않습니다.

메서드

activate

기존 선별된 패키지를 활성화합니다.

create

선별된 새 패키지를 만듭니다.

deactivate

기존 선별된 패키지를 비활성화합니다.

get

리소스 이름이 지정된 선별된 패키지를 가져옵니다.

list

지정된 큐레이터가 소유한 선별된 패키지를 나열합니다.

patch

기존 선별된 패키지를 업데이트합니다.