- 리소스: InventorySource
- BuyerStatus
- SellerStatus
- InventorySourceVolumeForecast
- DailyVolume
- DayOfWeek
- CreativeApprovalConfig
- PublisherConfig
- 메서드
리소스: InventorySource
DV360 인벤토리 소스의 실행 모델입니다.
JSON 표현 |
---|
{ "name": string, "buyerStatus": enum ( |
필드 | |
---|---|
name |
출력 전용입니다. 순서의 상대 리소스 이름입니다. 서버에서 생성합니다. 예: 'exchanges/1234/inventorySources/5678' |
buyerStatus |
출력 전용입니다. 구매자 상태입니다. |
sellerStatus |
판매자 상태입니다. |
transactionType |
출력 전용입니다. 제품 거래 유형입니다. |
pricingType |
출력 전용입니다. 제품의 가격 유형입니다. |
rateDetails |
출력 전용입니다. 요금 세부정보 |
startTime |
출력 전용입니다. 이 제품이 활성화되는 시간입니다. endTime보다 작아야 합니다. 시작 시간은 1년 이상 미래일 수 없습니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
endTime |
출력 전용입니다. 이 제품이 비활성화된 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
exchangeVolumeForecast |
거래소에서 일일 거래량 예측을 제공했습니다. 속도를 결정하고 구매자 선택을 사용 설정하는 데 사용됩니다. 이 필드는 지원 중단되었습니다. |
audienceMatchRate |
출력 전용입니다. 거래소에서 추가로 전송해야 할 요청 수를 결정하는 데 사용하는 잠재고객 타겟팅이 적용된 보장 프로그래매틱 거래의 잠재고객 일치율 예측입니다. 0과 1 사이의 십진수이며, 그 역수를 노출수의 배율로 사용해야 합니다. 0은 필드가 설정되지 않았음을 나타내므로 잠재고객 타겟팅이 없습니다. 예: '0.125' 이는 요청의 12.5% 가 잠재고객 타겟팅과 일치하며 전송된 요청 수는 협상된 노출수의 8배여야 함을 나타냅니다. |
makegoodRequested |
출력 전용입니다. 구매자에게 보상 게재가 요청되었는지 여부를 나타냅니다. |
makegoodRequestedReason |
출력 전용입니다. 구매자가 제공한 보상 게재 요청 사유입니다. |
percentFrequencyCapExcludedTraffic |
보장 프로그래매틱 거래의 최대 게재빈도에서 제외된 트래픽의 비율입니다. 0과 100 사이의 정수입니다. 값 0 (기본값)은 제외가 없음을 나타내므로 모든 트래픽에 최대 게재빈도가 적용될 수 있습니다. 100은 완전한 제외를 나타내므로 최대 게재빈도가 적용되지 않습니다. 0과 100 사이의 값을 사용하면 부분적으로 제외됩니다. 예를 들어 값이 20이면 트래픽의 20% 가 게재빈도 설정에서 제외됩니다. |
dv360WseatId[] |
출력 전용입니다. 현재 인벤토리 소스에 대한 권한이 있는 wseat입니다. |
lastModifiedTime |
출력 전용입니다. 인벤토리 소스가 마지막으로 업데이트된 시간입니다. 일부 DV3 내부 업데이트는 마지막으로 수정한 시간을 변경합니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
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 ( |
필드 | |
---|---|
dailyVolumes[] |
일일 예측 볼륨입니다. |
timeZoneId |
일일 볼륨에 사용되는 IANA 시간대 데이터베이스 시간대입니다(예: 'America/New_York'). |
DailyVolume
특정 날짜의 인벤토리 소스 요청 볼륨입니다.
JSON 표현 |
---|
{
"day": enum ( |
필드 | |
---|---|
day |
요청 수가 적용되는 요일입니다. |
volume |
지정된 요일의 예상 요청 건수입니다. |
DayOfWeek
요일을 나타냅니다.
열거형 | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
요일이 지정되지 않습니다. |
MONDAY |
월요일 |
TUESDAY |
화요일 |
WEDNESDAY |
수요일 |
THURSDAY |
목요일 |
FRIDAY |
금요일 |
SATURDAY |
토요일 |
SUNDAY |
일요일 |
CreativeApprovalConfig
광고 소재 승인을 위한 구성입니다.
JSON 표현 |
---|
{
"requiresExchangeApproval": boolean,
"publisherConfigs": [
{
object ( |
필드 | |
---|---|
requiresExchangeApproval |
필수 항목입니다. 광고 소재에 교환 수준의 사전 처리 승인이 필요한지 여부를 나타냅니다. |
publisherConfigs[] |
선택사항입니다. 게시자의 구성입니다. |
PublisherConfig
게시자의 구성 (publisher_config)입니다. publisher_config가 설정된 경우 광고 소재에 게시자 수준의 사전 처리 승인이 필요합니다.
JSON 표현 |
---|
{ "publisherId": string, "publisherDisplayName": string } |
필드 | |
---|---|
publisherId |
필수 항목입니다. 게시자 ID입니다. |
publisherDisplayName |
필수 항목입니다. 게시자 이름입니다. |
메서드 |
|
---|---|
|
인벤토리 소스를 가져옵니다. |
|
인벤토리 소스를 나열합니다. |
|
인벤토리 소스를 업데이트합니다. |