REST Resource: exchanges.inventorySources

리소스: InventorySource

DV360 인벤토리 소스의 실행 모델입니다.

JSON 표현
{
  "name": string,
  "buyerStatus": enum (BuyerStatus),
  "sellerStatus": enum (SellerStatus),
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "rateDetails": {
    object (RateDetails)
  },
  "startTime": string,
  "endTime": string,
  "exchangeVolumeForecast": {
    object (InventorySourceVolumeForecast)
  },
  "audienceMatchRate": number,
  "makegoodRequested": boolean,
  "makegoodRequestedReason": string,
  "percentFrequencyCapExcludedTraffic": string,
  "dv360WseatId": [
    string
  ],
  "lastModifiedTime": string,
  "creativeApprovalConfig": {
    object (CreativeApprovalConfig)
  }
}
필드
name

string

출력 전용입니다. 순서의 상대 리소스 이름입니다. 서버에서 생성합니다. 예: 'exchanges/1234/inventorySources/5678'

buyerStatus

enum (BuyerStatus)

출력 전용입니다. 구매자 상태입니다.

sellerStatus

enum (SellerStatus)

판매자 상태입니다.

transactionType

enum (TransactionType)

출력 전용입니다. 제품 거래 유형입니다.

pricingType

enum (PricingType)

출력 전용입니다. 제품의 가격 유형입니다.

rateDetails

object (RateDetails)

출력 전용입니다. 요금 세부정보

startTime

string (Timestamp format)

출력 전용입니다. 이 제품이 활성화되는 시간입니다. endTime보다 작아야 합니다. 시작 시간은 1년 이상 미래일 수 없습니다.

생성된 출력은 항상 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"입니다.

endTime

string (Timestamp format)

출력 전용입니다. 이 제품이 비활성화된 시간입니다.

생성된 출력은 항상 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"입니다.

exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

거래소에서 일일 거래량 예측을 제공했습니다. 속도를 결정하고 구매자 선택을 사용 설정하는 데 사용됩니다. 이 필드는 지원 중단되었습니다.

audienceMatchRate

number

출력 전용입니다. 거래소에서 추가로 전송해야 할 요청 수를 결정하는 데 사용하는 잠재고객 타겟팅이 적용된 보장 프로그래매틱 거래의 잠재고객 일치율 예측입니다. 0과 1 사이의 십진수이며, 그 역수를 노출수의 배율로 사용해야 합니다. 0은 필드가 설정되지 않았음을 나타내므로 잠재고객 타겟팅이 없습니다. 예: '0.125' 이는 요청의 12.5% 가 잠재고객 타겟팅과 일치하며 전송된 요청 수는 협상된 노출수의 8배여야 함을 나타냅니다.

makegoodRequested

boolean

출력 전용입니다. 구매자에게 보상 게재가 요청되었는지 여부를 나타냅니다.

makegoodRequestedReason

string

출력 전용입니다. 구매자가 제공한 보상 게재 요청 사유입니다.

percentFrequencyCapExcludedTraffic

string (int64 format)

보장 프로그래매틱 거래의 최대 게재빈도에서 제외된 트래픽의 비율입니다. 0과 100 사이의 정수입니다. 값 0 (기본값)은 제외가 없음을 나타내므로 모든 트래픽에 최대 게재빈도가 적용될 수 있습니다. 100은 완전한 제외를 나타내므로 최대 게재빈도가 적용되지 않습니다. 0과 100 사이의 값을 사용하면 부분적으로 제외됩니다. 예를 들어 값이 20이면 트래픽의 20% 가 게재빈도 설정에서 제외됩니다.

dv360WseatId[]

string (int64 format)

출력 전용입니다. 현재 인벤토리 소스에 대한 권한이 있는 wseat입니다.

lastModifiedTime

string (Timestamp format)

출력 전용입니다. 인벤토리 소스가 마지막으로 업데이트된 시간입니다. 일부 DV3 내부 업데이트는 마지막으로 수정한 시간을 변경합니다.

생성된 출력은 항상 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"입니다.

creativeApprovalConfig

object (CreativeApprovalConfig)

선택사항입니다. 광고 소재 승인을 위한 구성입니다. 거래소 수준 또는 게시자 수준에서 승인이 필요할 수 있습니다.

BuyerStatus

구매자 상태입니다.

열거형
BUYER_STATUS_UNSPECIFIED 구매자 상태가 지정되지 않았습니다. 입력값이 잘못되었습니다.
BUYER_STATUS_ACTIVE 구매자 상태가 활성 상태입니다. 광고 항목이 할당되고 유효한 광고 소재가 할당되었습니다.
BUYER_STATUS_PENDING 구매자 상태가 대기 중입니다. 이 상태는 거래가 활성 상태가 아니며 구매자가 취해야 할 특정 조치가 있음을 의미합니다.
BUYER_STATUS_PAUSED 구매자가 일시중지한 구매자 상태입니다.

SellerStatus

판매자 상태입니다.

열거형
SELLER_STATUS_UNSPECIFIED 판매자 상태가 지정되지 않았습니다. 예상치 못한 경우로, 협상 상태를 알 수 없음을 나타냅니다. 입력값이 잘못되었습니다.
SELLER_STATUS_ACTIVE 판매자 상태가 활성 상태입니다. 인벤토리 소스가 거래소 측에서 활성 상태입니다.
SELLER_STATUS_PAUSED 판매자 상태가 일시중지되었습니다.

InventorySourceVolumeForecast

인벤토리 소스의 일일 요청 수 예측입니다. 다음 유효성 검사 규칙이 적용됩니다. - 요일별로 항목을 입력해야 합니다. - 볼륨은 0보다 커야 합니다. - timeZoneId는 필수 항목이며 유효해야 합니다.

JSON 표현
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
필드
dailyVolumes[]

object (DailyVolume)

일일 예측 볼륨입니다.

timeZoneId

string

일일 볼륨에 사용되는 IANA 시간대 데이터베이스 시간대입니다(예: 'America/New_York').

DailyVolume

특정 날짜의 인벤토리 소스 요청 볼륨입니다.

JSON 표현
{
  "day": enum (DayOfWeek),
  "volume": string
}
필드
day

enum (DayOfWeek)

요청 수가 적용되는 요일입니다.

volume

string (int64 format)

지정된 요일의 예상 요청 건수입니다.

DayOfWeek

요일을 나타냅니다.

열거형
DAY_OF_WEEK_UNSPECIFIED 요일이 지정되지 않습니다.
MONDAY 월요일
TUESDAY 화요일
WEDNESDAY 수요일
THURSDAY 목요일
FRIDAY 금요일
SATURDAY 토요일
SUNDAY 일요일

CreativeApprovalConfig

광고 소재 승인을 위한 구성입니다.

JSON 표현
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
필드
requiresExchangeApproval

boolean

필수 항목입니다. 광고 소재에 교환 수준의 사전 처리 승인이 필요한지 여부를 나타냅니다.

publisherConfigs[]

object (PublisherConfig)

선택사항입니다. 게시자의 구성입니다.

PublisherConfig

게시자의 구성 (publisher_config)입니다. publisher_config가 설정된 경우 광고 소재에 게시자 수준의 사전 처리 승인이 필요합니다.

JSON 표현
{
  "publisherId": string,
  "publisherDisplayName": string
}
필드
publisherId

string

필수 항목입니다. 게시자 ID입니다.

publisherDisplayName

string

필수 항목입니다. 게시자 이름입니다.

메서드

get

인벤토리 소스를 가져옵니다.

list

인벤토리 소스를 나열합니다.

patch

인벤토리 소스를 업데이트합니다.