- 리소스: Product
- CreativeConfig
- CreativeType
- DimensionCreativeConfig
- DurationCreativeConfig
- DurationMatchType
- SkippableMatchType
- MakegoodDetails
- CreativeSource
- AudienceTargetingConfig
- AudienceType
- TargetingCriteria
- SelectedTargetingOption
- TargetingType
- AudienceSelection
- OrGroup
- TargetingSelection
- ForecastResult
- 예측
- ForecastCategory
- CpmRange
- ForecastBreakdownData
- ForecastBreakdown
- ErrorDetails
- InstantDealErrorStatus
- FrequencyCap
- TimeUnit
- 메서드
리소스: Product
제품
| JSON 표현 |
|---|
{ "name": string, "displayName": string, "externalDealId": string, "transactionType": enum ( |
| 필드 | |
|---|---|
name |
제품의 상대적 리소스 이름입니다. 서버에서 생성됩니다. 예: 'exchanges/1234/orders/5678/products/abc' 출력 전용입니다. |
displayName |
제품의 표시 이름입니다. 최대 크기가 240바이트인 UTF-8로 인코딩되어야 합니다. 필수 항목입니다. |
externalDealId |
외부 ID 거래소 시스템의 거래 ID입니다. 영문 기준 최대 100자 허용되는 문자는 영숫자, 밑줄, 대시, 마침표입니다. 모든 제품에서 고유해야 합니다. 필수 항목입니다. |
transactionType |
제품 거래 유형입니다. 필수 항목입니다. |
pricingType |
제품의 가격 책정 유형입니다. 필수 항목입니다. |
updateTime |
제품이 마지막으로 업데이트된 타임스탬프입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
startTime |
이 제품이 활성화되는 시간입니다. endTime 이전이어야 합니다. 시작 시간은 1년 이내여야 합니다. 필수 항목입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
endTime |
이 제품이 비활성 상태가 되는 시간입니다. 2036년 이후일 수 없습니다. 필수 항목입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
rateDetails |
요금 세부정보 필수 항목입니다. |
creativeConfig[] |
제품의 광고 소재 요구사항입니다. 예약된 거래 유형 제품에 필요합니다. |
makegood |
제품이 보상 게재 제품인지 여부를 나타냅니다. |
makegoodDetails |
제품의 보상 게재 세부정보입니다. 제품이 보상 게재인 경우 필수입니다. |
creativeSource |
제품의 광고 소재 소스입니다. 선택사항이며 기본값은 CREATIVE_SOURCE_ADVERTISER입니다. 제품을 만든 후에는 변경할 수 없습니다. |
mediumType |
제품의 매체 유형입니다. 이전 버전과의 호환성을 위해 지정하지 않으면 기본적으로 DIGITAL입니다. 제품을 만든 후에는 변경할 수 없습니다. |
audienceTargetingConfig |
선택사항입니다. 거래소의 거래 수준에서 적용되는 잠재고객 타겟팅 구성입니다. |
targetingCriteria |
출력 전용입니다. 제품 타겟팅 기준 참조입니다. 즉시 거래 시나리오에만 적용됩니다. |
forecastResult |
제품 예측 결과 타겟팅 기준이 비어 있지 않고 예측이 제공되지 않는 경우에 필요합니다. 즉시 거래 시나리오에만 적용됩니다. |
errorDetails |
특정 제품 필드를 업데이트할 수 없는 경우 오류 세부정보를 지정해야 합니다. 타겟팅 기준 때문에 예측 결과를 제공할 수 없거나 제품을 업데이트할 수 없는 경우에 필요합니다. 즉시 거래 시나리오에만 적용됩니다. |
frequencyCap |
출력 전용입니다. 구매자가 선택한 최대 게재빈도입니다. 즉시 거래 시나리오에만 적용됩니다. |
program |
출력 전용입니다. 구매자가 즉시 거래를 만든 프로그램입니다. 교환의 일반적인 흐름에서는 비어 있습니다. 즉시 거래 시나리오에만 적용됩니다. |
buyerCustomParameters |
출력 전용입니다. 구매자가 즉시 거래 요청에 설정한 맞춤 키/값 매개변수입니다. 즉시 거래 시나리오에만 적용됩니다.
|
etag |
제품을 업데이트할 때 지정해야 하는 ETag입니다. etag 필드가 비어 있지 않은 경우에만 업데이트를 위해 지정해야 합니다. 즉시 거래 시나리오에만 적용됩니다. |
CreativeConfig
제품의 광고 소재 요구사항 구성입니다.
| JSON 표현 |
|---|
{ "creativeType": enum ( |
| 필드 | |
|---|---|
creativeType |
광고 소재 유형입니다. 필수 항목입니다. |
dimensionCreativeConfig |
디스플레이 광고 소재의 구성입니다. 이 필드는 네이티브 광고 소재 (CREATIVE_TYPE_NATIVE)에 지원되지 않습니다. |
durationCreativeConfig |
동영상 광고 소재의 구성입니다. |
CreativeType
가능한 광고 소재 유형입니다.
| 열거형 | |
|---|---|
CREATIVE_TYPE_UNSPECIFIED |
광고 소재 유형이 지정되지 않았습니다. 입력값이 잘못되었습니다. |
CREATIVE_TYPE_DISPLAY |
디스플레이 광고 소재 유형입니다. |
CREATIVE_TYPE_VIDEO |
동영상의 광고 소재 유형입니다. |
CREATIVE_TYPE_AUDIO |
오디오의 광고 소재 유형입니다. |
CREATIVE_TYPE_NATIVE |
네이티브 광고 소재 유형입니다. RESERVED 거래 유형 제품에는 지원되지 않습니다. |
DimensionCreativeConfig
디스플레이 광고 소재 크기(픽셀)입니다.
| JSON 표현 |
|---|
{ "width": integer, "height": integer } |
| 필드 | |
|---|---|
width |
디스플레이 광고 소재 너비입니다. 필수 항목입니다. |
height |
디스플레이 광고 소재 높이입니다. 필수 항목입니다. |
DurationCreativeConfig
광고 소재의 재생 시간 구성입니다.
| JSON 표현 |
|---|
{ "duration": string, "durationMatchType": enum ( |
| 필드 | |
|---|---|
duration |
동영상 광고 소재의 길이(초)입니다. 필수 소수점 아래가 최대 9자리까지이고 ' |
durationMatchType |
길이 일치 기준입니다. |
skippableMatchType |
동영상 광고 소재의 건너뛸 수 있는 유형입니다. |
DurationMatchType
동영상 광고 소재 재생 시간의 일치 기준입니다.
| 열거형 | |
|---|---|
DURATION_MATCH_TYPE_UNSPECIFIED |
이 버전에서는 기간 일치 기준이 지정되지 않았거나 알 수 없습니다. 입력값이 잘못되었습니다. |
DURATION_MATCH_TYPE_EQUAL_TO |
광고 소재 재생 시간은 필수 재생 시간과 동일해야 합니다. |
DURATION_MATCH_TYPE_LESS_THAN_OR_EQUAL_TO |
광고 소재 재생 시간은 필수 재생 시간과 같거나 그보다 짧아야 합니다. |
SkippableMatchType
동영상 광고 소재를 건너뛸 수 있는지 여부에 대한 일치 기준입니다.
| 열거형 | |
|---|---|
SKIPPABLE_MATCH_TYPE_UNSPECIFIED |
이 버전에서는 건너뛸 수 있는 유형이 지정되지 않았거나 알 수 없습니다. 입력값이 잘못되었습니다. |
SKIPPABLE_MATCH_TYPE_SKIPPABLE |
광고 소재는 건너뛸 수 있어야 합니다. |
SKIPPABLE_MATCH_TYPE_NOT_SKIPPABLE |
광고 소재를 건너뛸 수 없어야 합니다. |
SKIPPABLE_MATCH_TYPE_ANY |
광고 소재는 건너뛸 수 있거나 건너뛸 수 없을 수 있습니다. |
MakegoodDetails
보상 게재 세부정보의 구성입니다.
| JSON 표현 |
|---|
{ "originalExternalDealId": string, "reason": string } |
| 필드 | |
|---|---|
originalExternalDealId |
보상 게재를 요청하는 기존 외부 거래 ID입니다. 영문 기준 최대 100자 허용되는 문자는 영숫자, 밑줄, 대시, 점입니다. 필수 항목입니다. |
reason |
판매자가 시작하는 보상 게재 이유입니다. 최대 250자(영문 기준) 필수 항목입니다. |
CreativeSource
광고 소재 소스: 광고 소재가 게재되는 위치입니다.
| 열거형 | |
|---|---|
CREATIVE_SOURCE_UNSPECIFIED |
이 버전에서는 광고 소재 소스가 지정되지 않았거나 알 수 없습니다. 입력값이 잘못되었습니다. |
CREATIVE_SOURCE_ADVERTISER |
광고 소재는 DV3에서 게재됩니다. |
CREATIVE_SOURCE_PUBLISHER |
광고 소재는 게시자가 게재합니다. 게시자 호스팅 광고 소재는 현재 지원되지 않습니다. 광고 소재 소스를 CREATIVE_SOURCE_PUBLISHER로 설정하려는 요청은 실패합니다. |
AudienceTargetingConfig
잠재고객 타겟팅 구성입니다.
| JSON 표현 |
|---|
{
"audienceType": enum ( |
| 필드 | |
|---|---|
audienceType |
잠재고객 유형입니다. 필수 항목입니다. |
AudienceType
잠재고객 유형
| 열거형 | |
|---|---|
AUDIENCE_TYPE_UNSPECIFIED |
지정되지 않은 잠재고객 유형입니다. 입력에 사용할 수 없습니다. |
AUDIENCE_TYPE_COMMERCE |
커머스 잠재고객 유형입니다. |
TargetingCriteria
타겟팅 기준이 지정되었습니다.
| JSON 표현 |
|---|
{
"selectedTargetingOptions": [
{
object ( |
| 필드 | |
|---|---|
selectedTargetingOptions[] |
선택한 옵션 |
SelectedTargetingOption
단일 타겟팅 유형에 대해 선택된 타겟팅 옵션입니다.
| JSON 표현 |
|---|
{ "type": enum ( |
| 필드 | |
|---|---|
type |
선택한 옵션과 연결된 타겟팅 유형입니다. |
한 가지 유형의 선택만 포함할 수 있습니다. 선택한 항목은 type 필드에 선택한 TargetingType과 일치해야 합니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다. |
|
audienceSelection |
선택한 잠재고객 |
targetingSelection |
선택한 옵션 ID의 일반 집합입니다. |
| 상호 배타적인 필드의 끝입니다. | |
TargetingType
타겟팅 유형
| 열거형 | |
|---|---|
TARGETING_TYPE_UNSPECIFIED |
타겟팅 유형이 지정되지 않았으며 입력에 유효하지 않습니다. |
TARGETING_TYPE_AUDIENCE |
타겟팅 유형 잠재고객입니다. |
TARGETING_TYPE_COUNTRY |
타겟팅 유형 국가입니다. |
TARGETING_TYPE_DMA |
타겟팅 유형 DMA입니다. |
TARGETING_TYPE_PROGRAMMER |
타겟팅 유형 프로그래머입니다. |
TARGETING_TYPE_BRAND |
타겟팅 유형 브랜드입니다. |
TARGETING_TYPE_CONTENT_GENRE |
타겟팅 유형 콘텐츠 장르입니다. |
TARGETING_TYPE_DEVICE |
타겟팅 유형 기기입니다. |
TARGETING_TYPE_OPERATING_SYSTEM |
타겟팅 유형 운영체제입니다. |
TARGETING_TYPE_RATING |
타겟팅 유형 등급입니다. |
TARGETING_TYPE_ENVIRONMENT |
타겟팅 유형 환경입니다. |
TARGETING_TYPE_LANGUAGE |
타겟팅 유형 언어입니다. |
TARGETING_TYPE_GEO |
타겟팅 유형 지역입니다. |
TARGETING_TYPE_AGE |
타겟팅 유형 연령입니다. |
TARGETING_TYPE_GENDER |
타겟팅 유형 성별입니다. |
TARGETING_TYPE_CONTEXTUAL_SEGMENT |
타겟팅 유형 문맥 세그먼트입니다. |
TARGETING_TYPE_REQUEST_FORMAT |
타겟팅 유형 요청 형식입니다. |
TARGETING_TYPE_PUBLISHER |
타겟팅 유형 게시자입니다. |
TARGETING_TYPE_INVENTORY_SIZE |
타겟팅 유형 크기입니다. |
TARGETING_TYPE_NETWORK |
타겟팅 유형 네트워크입니다. |
TARGETING_TYPE_PLATFORM |
타겟팅 유형 플랫폼입니다. |
TARGETING_TYPE_VIDEO_DELIVERY_TYPE |
타겟팅 유형 동영상 게재 유형입니다. |
TARGETING_TYPE_VIDEO_MINIMUM_PLAYER_SIZE |
타겟팅 유형 동영상 최소 플레이어 크기입니다. |
TARGETING_TYPE_VIDEO_COMPLETION |
타겟팅 유형 동영상 게재위치입니다. |
TARGETING_TYPE_VIEWABILITY |
타겟팅 유형 조회가능성 |
TARGETING_TYPE_REWARDED |
타겟팅 유형 보상형입니다. |
TARGETING_TYPE_VIDEO_AD_DURATION_THRESHOLD_SEC |
타겟팅 유형 동영상 광고 길이 기준점(초) |
TARGETING_TYPE_VIDEO_PLACEMENT |
타겟팅 유형 동영상 게재위치입니다. |
TARGETING_TYPE_VIDEO_PLAYBACK_METHOD |
타겟팅 유형 동영상 재생 방법입니다. |
TARGETING_TYPE_APP_ID |
타겟팅 유형 앱 ID입니다. |
TARGETING_TYPE_DOMAIN_URL |
타겟팅 유형 도메인 URL입니다. |
TARGETING_TYPE_CTR |
타겟팅 유형 클릭률입니다. |
TARGETING_TYPE_DEMOGRAPHICS |
타겟팅 유형 인구통계 |
TARGETING_TYPE_RESTRICTED_CATEGORY |
타겟팅 유형 제한 카테고리입니다. |
TARGETING_TYPE_AD_POSITION |
타겟팅 유형 광고 게재순위입니다. |
TARGETING_TYPE_DAY_AND_TIME |
타겟팅 유형 요일 및 시간 |
TARGETING_TYPE_RETAIL_MEDIA_AUDIENCE |
타겟팅 유형 리테일 미디어 잠재고객입니다. |
AudienceSelection
선택한 잠재고객 타겟팅 옵션
| JSON 표현 |
|---|
{
"includedOrGroups": [
{
object ( |
| 필드 | |
|---|---|
includedOrGroups[] |
포함된 옵션은 AND로 결합되며, 포함된 각 옵션은 개별 옵션이거나 OR로 결합된 옵션 그룹일 수 있습니다. |
excludedOptionIds[] |
제외된 옵션은 OR로 연결됩니다. |
OrGroup
OR로 연결된 선택된 옵션 그룹입니다.
| JSON 표현 |
|---|
{ "optionIds": [ string ] } |
| 필드 | |
|---|---|
optionIds[] |
선택한 옵션 ID입니다. |
TargetingSelection
선택 및 제외된 타겟팅 옵션으로, 대부분의 타겟팅 유형에 적용됩니다.
| JSON 표현 |
|---|
{ "optionIds": [ string ], "externalIds": [ string ], "excludedOptionIds": [ string ], "excludedExternalIds": [ string ] } |
| 필드 | |
|---|---|
optionIds[] |
출력 전용입니다. 거래소와 공유된 선택된 DV3 타겟팅 옵션 ID입니다. 두 목록이 겹치지 않는 한 |
externalIds[] |
출력 전용입니다. 거래소에서 제공하는 선택된 타겟팅 옵션 ID입니다. 두 목록이 겹치지 않는 한 |
excludedOptionIds[] |
출력 전용입니다. 거래소와 공유된 제외된 DV3 타겟팅 옵션 ID입니다. 두 목록이 겹치지 않는 한 |
excludedExternalIds[] |
출력 전용입니다. 거래소에서 제공하는 제외 타겟팅 옵션 ID입니다. 두 목록이 겹치지 않는 한 |
ForecastResult
예측 결과가 지정되었습니다.
| JSON 표현 |
|---|
{
"forecasts": [
{
object ( |
| 필드 | |
|---|---|
forecasts[] |
예측 |
예측
지정된 예측 카테고리의 예측입니다.
| JSON 표현 |
|---|
{ "forecastCategory": enum ( |
| 필드 | |
|---|---|
forecastCategory |
예측 통계가 나타내는 지정된 예측 카테고리입니다. |
한 가지 유형의 통계 데이터만 포함할 수 있습니다. 채워진 데이터는 forecastCategory 필드와 일치해야 합니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다. |
|
number |
숫자 데이터 |
percentage |
백분율 데이터입니다. |
cpmPrice |
CPM 가격 데이터 |
cpmRange |
CPM 가격 범위 데이터 |
forecastBreakdownData |
예측 분류 데이터입니다. |
| 상호 배타적인 필드의 끝입니다. | |
ForecastCategory
예측 카테고리입니다.
| 열거형 | |
|---|---|
FORECAST_CATEGORY_UNSPECIFIED |
지정되지 않은 카테고리입니다. 입력에 사용할 수 없습니다. |
FORECAST_CATEGORY_TOTAL_OPPORTUNITIES |
총 기회 수 숫자 데이터 |
FORECAST_CATEGORY_TOTAL_AUDIENCE |
전체 잠재고객 숫자 데이터 |
FORECAST_CATEGORY_DIGITAL_TRP |
디지털 타겟 평점 백분율 데이터입니다. |
FORECAST_CATEGORY_SUGGESTED_CPM |
추천 CPM 가격입니다. CPM 범위 또는 CPM 가격 데이터 |
FORECAST_CATEGORY_UNIQUE_REACH |
순 사용자 도달범위를 예측합니다. 숫자 데이터 |
FORECAST_CATEGORY_FORECAST_BREAKDOWN |
예측 분류 예측 분류 데이터입니다. |
CpmRange
CPM 범위에는 CPM의 최솟값과 최댓값이 포함됩니다.
| JSON 표현 |
|---|
{ "minCpm": { object ( |
| 필드 | |
|---|---|
minCpm |
CPM 범위의 하한값입니다. |
maxCpm |
CPM 범위의 상한값입니다. |
ForecastBreakdownData
예측 분류 데이터에는 예측 분류 목록이 포함됩니다.
| JSON 표현 |
|---|
{
"forecastBreakdowns": [
{
object ( |
| 필드 | |
|---|---|
forecastBreakdowns[] |
예측 분류 목록입니다. |
ForecastBreakdown
선택한 타겟팅 옵션의 예측 분석입니다.
| JSON 표현 |
|---|
{
"selectedTargetingOption": {
object ( |
| 필드 | |
|---|---|
selectedTargetingOption |
단일 타겟팅 유형에 대해 선택된 타겟팅 옵션입니다. |
| 한 가지 유형의 분류 데이터만 포함할 수 있습니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다. | |
impressions |
노출수를 예측합니다. |
| 상호 배타적인 필드의 끝입니다. | |
ErrorDetails
업데이트에 오류가 있을 때 지정되는 오류 세부정보입니다.
| JSON 표현 |
|---|
{
"message": string,
"instantDealErrorStatus": enum ( |
| 필드 | |
|---|---|
message |
업데이트에 오류가 있을 때 지정되는 메시지입니다. |
instantDealErrorStatus |
즉시 거래에 오류가 있는 경우 업데이트 시 지정되는 오류 상태입니다. |
InstantDealErrorStatus
즉시 거래 업데이트에 오류가 있을 때 지정되는 오류 상태입니다.
| 열거형 | |
|---|---|
INSTANT_DEAL_ERROR_STATUS_UNSPECIFIED |
지정되지 않은 오류 상태입니다. |
INSTANT_DEAL_ERROR_STATUS_INVENTORY_UNAVAILABLE |
오류 상태는 인벤토리를 사용할 수 없음을 나타냅니다. |
INSTANT_DEAL_ERROR_STATUS_FORECAST_UNAVAILABLE |
오류 상태는 예측을 사용할 수 없음을 나타냅니다. |
INSTANT_DEAL_ERROR_STATUS_INVALID_INPUT |
오류 상태는 잘못된 입력란이 있음을 나타냅니다. |
FrequencyCap
특정 기간 동안 사용자에게 동일한 광고가 표시될 수 있는 횟수입니다.
| JSON 표현 |
|---|
{
"timeUnit": enum ( |
| 필드 | |
|---|---|
timeUnit |
최대 게재빈도가 적용되는 시간 단위입니다. |
maxImpressions |
이 기간 동안 사용자에게 동일한 광고가 표시될 수 있는 최대 횟수입니다. |
TimeUnit
최대 게재빈도가 적용되는 시간 단위입니다.
| 열거형 | |
|---|---|
TIME_UNIT_UNSPECIFIED |
지정되지 않은 시간 단위입니다. |
TIME_UNIT_LIFETIME |
최대 게재빈도는 전체 기간에 적용됩니다. |
TIME_UNIT_MONTHS |
최대 게재빈도는 몇 개월 동안 적용됩니다. |
TIME_UNIT_WEEKS |
최대 게재빈도가 여러 주에 걸쳐 적용됩니다. |
TIME_UNIT_DAYS |
최대 게재빈도는 일수에 적용됩니다. |
메서드 |
|
|---|---|
|
제품을 만듭니다. |
|
제품을 가져옵니다. |
|
제품을 나열합니다. |
|
제품을 업데이트합니다. |