구조화된 데이터 - v3.1 - 게재 신청서

형식에 관한 설명은 개요를 참고하세요.

필드필수유형쓰기 가능설명
Io ID기존 게재 신청서를 수정할 때만 필요합니다.정수아니요게재 신청서의 숫자 ID 값입니다. 비워 두면 새 게재 신청서 ID가 생성되고 고유 ID가 할당됩니다. 원하는 경우 새 게재 신청서를 만들 때 새 게재 신청서에 광고 항목을 할당하기 위해 맞춤 식별자를 사용할 수 있습니다. 맞춤 식별자의 형식은 'ext[맞춤 식별자]'입니다(예: ext123). 파일이 업로드되고 처리되면 모든 맞춤 식별자는 DBM에서 할당된 ID로 대체되고, 해당 객체는 맞춤 식별자를 기반으로 연결됩니다 (예: 광고 항목과 게재 신청서 연결).
캠페인 ID아니요정수아니요캠페인의 숫자 ID 값입니다. 이 게재 신청서와 동시에 생성 중인 캠페인에 맞춤 식별자를 지정할 수 있습니다 (예: 'ext[맞춤 캠페인 식별자]').
이름문자열항목의 이름입니다.
타임스탬프기존 항목을 수정할 때 필요합니다.정수아니요항목의 타임스탬프입니다. 시스템에서 다운로드와 업로드 사이에 항목이 변경되지 않았는지 확인하는 데 사용됩니다.
상태문자열항목의 상태 설정입니다.
  • 활성
  • 일시중지됨
  • 임시
  • 보관처리됨
  • 삭제됨
IO 유형문자열게재 신청서의 유형입니다. 생성 시만 설정할 수 있습니다.
  • 표준
요금아니요문자열, 목록 목록이 항목의 모든 수수료입니다. 목록 형식 = (수수료 카테고리; 수수료 금액; 수수료 유형; 인보이스 발행 여부).
  • 수수료 카테고리
    • CPM
    • 미디어
  • 수수료 금액
    • 부동 소수점 수
    • Pct(부동 소수점 수)
  • 수수료 유형
    • (문자열, 수수료 표 참고)
  • 인보이스
    • 거짓
    • 내용 없음

예: '(CPM; 2; 입찰 관리자 수수료; False) ; (미디어; 13; 기본값; True);'
허용되는 값은 다음 표에 나와 있습니다.

참고: 프리미엄 수수료 CPM 수수료는 시스템에서 예약하며 변경할 수 없습니다. 필요한 경우 기본 CPM 수수료를 삽입하여 프리미엄 수수료의 카디널리티가 변형 전후에 보존됩니다.

수수료 카테고리수수료 유형인보이스 옵션
CPM/미디어기본값허용되지 않음 (비워 두기)
CPM/미디어외부 애드 서버허용되지 않음 (비워 두기)
CPM/미디어DoubleVerify허용됨 (참/거짓)
CPM/미디어Adsafe허용되지 않음 (비워 두기)
CPM/미디어Adxpose허용되지 않음 (비워 두기)
CPM/미디어Vizu허용되지 않음 (비워 두기)
CPM/미디어Aggregate Knowledge허용되지 않음 (비워 두기)
CPM/미디어Teracent허용되지 않음 (비워 두기)
CPM/미디어Evidon허용되지 않음 (비워 두기)
CPM/미디어Agency Trading Desk 수수료허용되지 않음 (비워 두기)
CPM/미디어Adloox허용됨 (참/거짓)
CPMShopLocal필수 (True)
CPMTrustMetrics허용되지 않음 (비워 두기)
CPMIntegral Ad Science 동영상허용됨 (참/거짓)
CPMMOAT 동영상허용되지 않음 (비워 두기)
미디어Bid Manager 수수료필수 (True)
미디어미디어 비용 데이터허용되지 않음 (비워 두기)
CPM프리미엄 수수료허용되지 않음 (비워 두기)
통합 코드아니요문자열추적을 위한 선택적 코드입니다.
세부정보아니요문자열문자열 형식의 항목 세부정보입니다.
예산 소진 속도문자열지출 속도 금액을 지출하는 데 사용되는 기간입니다.
  • 매일
  • 매월
  • 항공편
예산 소진 속도문자열이 항목의 속도입니다.
  • 최대한 빨리
  • 균등
  • 선행
예산 지출 금액float속도 유형에 따라 설정된 기간당 지출할 금액입니다.
빈도 사용 설정 여부문자열게재 신청서에서 노출 기반 최대 게재빈도 설정을 사용 설정/사용 중지합니다.
  • TRUE
  • FALSE
게재빈도 노출수'게재빈도 사용'이 'TRUE'인 경우 필수사항정수지정된 게재빈도 금액의 노출수에 대한 양수 정수 금액입니다(예: 'y 기간 동안 x 노출수 표시'의 x).
게재빈도 기간'게재빈도 사용'이 'TRUE'인 경우 필수사항문자열최대 게재빈도의 기간 단위를 지정합니다.
  • 시간
  • 며칠
  • 몇 주
  • 전체 기간
빈도 수'게재빈도 사용'이 'TRUE'인 경우 필수사항정수게재빈도 기간 유형의 시간 길이에 대한 양의 정수 값입니다. 즉, 'y 기간 동안 x 노출수 표시'의 y입니다.
실적 목표 유형문자열게재 신청서의 목표 단위
  • CPM
  • CPA
  • CPC
  • CPV
  • CPIAVC
  • CTR
  • 조회가능성(%)
  • 없음
  • 기타
실적 목표 값문자열통화 (CPM, CPA, CPC, CPV, CPIAVC), 비율(조회가능성, CTR) 또는 문자열 (기타)로 표시된 목표 값입니다.
DAR 측정문자열Nielsen Digital Ad Ratings를 사용하여 잠재고객 측정을 사용 설정/사용 중지합니다.
  • TRUE
  • FALSE
DAR 채널 측정'DAR 측정'이 'TRUE'인 경우 필요정수Nielsen Digital Ad Ratings로 측정할 채널입니다. 형식 = UniversalChannel.id
예산 유형문자열지출할 '수익' 금액 (금액) 또는 구매할 노출수 (노출수) 측면에서 예산 유형을 지정합니다.
  • 금액
  • 노출수
예산 세그먼트문자열, 목록 목록특정 예산 세그먼트를 지정합니다. 목록 형식 = (예산, 시작일, 종료일). 예산은 통화 부동 소수점 형식입니다. 날짜는 MM/DD/YYYY 형식입니다. 예: '(100.50;2016년 1월 1일;2016년 3월 31일;);(200.00;2016년 4월 1일;2016년 6월 30일;);'
자동 예산 할당문자열자동 예산 할당 사용 설정/중지
  • TRUE
  • FALSE
지역 타겟팅 - 포함아니요문자열, 목록타겟팅에 포함할 지역 목록입니다. 목록 형식 = (GeoLocation.id; GeoLocation.id;etc.)
지역 타겟팅 - 제외아니요문자열, 목록타겟팅에서 제외할 지역 목록입니다. 목록 형식 = (GeoLocation.id;GeoLocation.id; 등).
언어 타겟팅 - 포함아니요문자열, 목록타겟팅에 포함할 언어 목록입니다. 목록 형식 = (Language.id;Language.id;etc.)
언어 타겟팅 - 제외아니요문자열, 목록타겟팅에서 제외할 언어 목록입니다. 목록 형식 = (Language.id;Language.id;etc.)
기기 타겟팅 - 포함아니요문자열, 목록타겟팅에 포함할 기기 목록입니다. 목록 형식 = (DeviceCriteria.id;DeviceCriteria.id;etc.).
기기 타겟팅 - 제외아니요문자열, 목록타겟팅에서 제외할 기기 목록입니다. 목록 형식 = (DeviceCriteria.id;DeviceCriteria.id;etc.).
브라우저 타겟팅 - 포함아니요문자열, 목록타겟팅에 포함할 브라우저 목록입니다. 목록 형식 = (Browser.id;Browser.id;etc.)
브라우저 타겟팅 - 제외아니요문자열, 목록타겟팅에서 제외할 브라우저 목록입니다. 목록 형식 = (Browser.id;Browser.id;etc.)
브랜드 안전성 라벨아니요문자열, 목록타겟팅할 디지털 콘텐츠 라벨 목록입니다. 목록 형식 = (G, PG 등).
  • G
  • PG
  • T
  • MA
  • ?
브랜드 안전 민감도 설정아니요문자열주변 콘텐츠의 주제에 따라 인벤토리를 차단할 민감도 설정을 선택합니다.
  • 차단하지 않음
  • DoubleClick 인증 사용
  • 맞춤 사용
브랜드 안전 맞춤 설정'브랜드 안전 맞춤 설정'이 '맞춤 사용'인 경우 필요합니다.문자열, 목록브랜드 안전 민감도 설정이 '맞춤 사용'인 경우 표준 콘텐츠 분류 기준 목록을 지정합니다. 예: (성인;주류;담배;등).
  • 성인
  • 혐오
  • 다운로드 및 공유
  • 무기
  • 도박
  • 폭력
  • 외설
  • 욕설
  • 주류
  • 마약
  • 담배
  • 정치
  • 종교
  • 비극
  • 교통사고
  • 민감한 사회 문제
  • 충격적
서드 파티 인증 서비스아니요문자열서드 파티 인증 서비스 제공업체
  • 없음
  • Integral Ad Science
  • DoubleVerify
  • Adloox
서드 파티 인증 라벨아니요문자열, 목록서드 파티 인증 서비스가 '없음'이 아닌 경우 선택한 제공업체에서 지원하는 라벨 목록을 지정합니다.
채널 타겟팅 - 포함아니요문자열, 목록타겟팅에 포함할 채널 목록입니다. 목록 형식 = (UniversalChannel.id;UniversalChannel.id; 등)
채널 타겟팅 - 제외아니요문자열, 목록타겟팅에 포함할 채널 목록입니다. 목록 형식 = (UniversalChannel.id;UniversalChannel.id; 등)
사이트 타겟팅 - 포함아니요문자열, 목록타겟팅에 포함할 사이트 목록입니다. 목록에는 범용 사이트 표에 없는 경우 사이트 ID 또는 URL 문자열이 포함될 수 있습니다. 목록 형식 = (UniversalSite.Id;'http://someurl.com';etc.).
사이트 타겟팅 - 제외아니요문자열, 목록타겟팅에서 제외할 사이트 목록입니다. 목록에는 범용 사이트 표에 없는 경우 사이트 ID 또는 URL 문자열이 포함될 수 있습니다. 목록 형식 = (UniversalSite.Id;'http://someurl.com';etc.).
앱 타겟팅 - 포함아니요문자열, 목록타겟팅에 포함할 앱 목록입니다. 목록에는 범용 사이트 표에 없는 경우 UniversalSite ID 또는 앱 패키지 문자열이 포함될 수 있습니다. 목록 형식 = (UniversalSite.Id; 'some.app.package';etc.).
앱 타겟팅 - 제외아니요문자열, 목록타겟팅에서 제외할 앱 목록입니다. 목록에는 범용 사이트 표에 없는 경우 UniversalSite ID 또는 앱 패키지 문자열이 포함될 수 있습니다. 목록 형식 = (UniversalSite.Id; 'some.app.package';etc.).
카테고리 타겟팅 - 포함아니요문자열, 목록AdX 카테고리 ID에서 타겟팅에 포함할 카테고리 목록입니다. 목록 형식 = (Verticals.Id;Verticals.Id;etc.)
카테고리 타겟팅 - 제외아니요문자열, 목록AdX 카테고리 ID에서 타겟팅 시 제외할 카테고리의 목록입니다. 목록 형식 = (Verticals.Id;Verticals.Id;etc.)
키워드 타겟팅 - 포함아니요문자열, 목록타겟팅에 포함할 키워드 문자열 목록입니다.
키워드 타겟팅 - 제외아니요문자열, 목록타겟팅에서 제외할 키워드 문자열 목록입니다.
잠재고객 타겟팅 - 유사 잠재고객'유형'이 '디스플레이', '동영상' 또는 '오디오'인 경우 필요합니다.문자열 양성적으로 타겟팅된 퍼스트 파티 목록에 유사 잠재고객을 사용 설정합니다.
  • TRUE
  • FALSE
잠재고객 타겟팅 - 포함아니요문자열, 쌍 목록 목록타겟팅에 포함할 잠재고객 목록의 목록입니다. 퍼스트 파티 잠재고객 목록의 경우 각 잠재고객이 UserList ID 및 최근성 설정 쌍으로 표시됩니다. 쌍은 (1;1d;)이며 여기서 1d는 1일 전의 최신성을 나타내는 샘플 최신성입니다. 서드 파티 잠재고객에는 최근성 정보를 사용할 수 없으므로 목록 형식은 (3;);(4;);입니다. 잠재고객 그룹을 'AND' 및 'OR'하려면 다음 예를 따르세요. 최근성 유무와 관계없는 쌍을 결합하려면 ' ((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'을 사용하세요. 즉, (최근 1일인 목록 1 또는 최근 365일인 목록 2) 및 (지정된 최근 없음 목록 3 또는 최근 5분인 목록 4 또는 모든 사용자가 포함된 목록 5)입니다.
유효한 최근 값은 다음과 같습니다.
all, 1m, 5m, 10m, 15m, 30m, 1h, 2h, 3h, 6h, 12h, 1d, 2d, 3d, 5d, 7d, 10d, 14d, 15d, 21d, 28d, 30d, 45d, 60d, 90d, 120d, 180d, 270d, 365d
잠재고객 타겟팅 - 제외아니요문자열, 쌍 목록 목록타겟팅에서 제외할 잠재고객 목록의 목록입니다. 잠재고객 목록이 퍼스트 파티 잠재고객 목록인 경우 각 잠재고객은 UserList ID 및 최근성 설정 쌍으로 표시됩니다. 쌍은 (1;1d;)이며 여기서 1d는 1일 전의 최신성을 나타내는 샘플 최신성입니다. 그러나 서드 파티 잠재고객의 경우 최신성이 지원되지 않으므로 목록 형식은 (3;);(4;);입니다. 목록 형식= (UserList.id; recency optional;); (UserList.id; recency optional;);
예: "(1;1d;);(2;);".
유효한 최근 값은 다음과 같습니다.
all, 1m, 5m, 10m, 15m, 30m, 1h, 2h, 3h, 6h, 12h, 1d, 2d, 3d, 5d, 7d, 10d, 14d, 15d, 21d, 28d, 30d, 45d, 60d, 90d, 120d, 180d, 270d, 365d
관심분야 및 구매 의도 타겟팅 - 포함아니요문자열, 목록포함할 관심분야 또는 구매 의도 잠재고객 목록 목록 형식= UserList ID; UserList ID;
관심분야 및 구매 의도 타겟팅 - 제외아니요문자열, 목록제외할 관심분야 또는 구매 의도 잠재고객 목록 목록 형식= UserList ID; UserList ID;
맞춤 관심분야 타겟팅아니요문자열, 목록타겟팅할 맞춤 목록의 목록입니다. 목록 형식= UserList ID; UserList ID;
인벤토리 소스 타겟팅 - 포함아니요문자열, 목록타겟팅에 포함할 인벤토리 목록입니다. 목록 형식 = (InventorySource.id; InventorySource.id;).
인벤토리 소스 타겟팅 - 제외아니요문자열, 목록타겟팅에서 제외할 인벤토리 목록입니다. 목록 형식 = (InventorySource.id; InventorySource.id;).
시간대 타겟팅아니요문자열, 목록ID 목록으로, 각 시간대 ID는 다음 형식으로 구성됩니다.
daypart_id = base_dayparting_id
+ days_since_monday * 10000
+ start * 100
+ end

base_dayparting_id = 300000
days_since_monday:0=월요일, 1=화요일, ..., 6=일요일
start: 0..95 (00: 00--23:45) 0~95 사이의 정수로 15분 슬롯을 나타냅니다.
end:1..96 (00: 15--24:00); 0~95 사이의 정수로 15분 슬롯을 나타냅니다.
start < end
새 항목의 경우 시간은 사용자의 시간대 (예: '로컬')을 선택합니다. 기존 항목의 경우 시간대는 변경되지 않습니다.
환경 타겟팅'유형'이 '디스플레이', '동영상' 또는 '오디오'인 경우 필요합니다.문자열, 목록타겟팅할 환경 목록입니다. 목록 형식 = (데스크톱 웹, 모바일 앱 등).
디스플레이 환경:
  • 데스크톱 웹
  • 모바일 웹
  • 모바일 앱
  • 모바일 앱 전면 광고
  • 모바일에서의 데스크톱 웹
동영상:
  • 데스크톱 웹 동영상
  • 데스크톱 웹 게임
  • 데스크톱 웹 인리드
  • 데스크톱 웹 인피드
  • 모바일 웹 동영상
  • 모바일 앱 동영상
  • 모바일 앱 동영상 전면 광고
오디오의 경우:
  • 데스크톱 웹 오디오
  • 모바일 웹 오디오
  • 모바일 앱 오디오
조회가능성 타겟팅 Active View아니요문자열예상 조회가능성 비율을 타겟팅합니다. 백분율은 부동 소수점 수로 표시됩니다. {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} 중 하나
조회가능성 타겟팅 광고 게재위치 - 포함아니요문자열타겟 광고 게재위치 허용되는 값 중 하나를 선택하거나 선택하지 않습니다.
  • 전체
  • ATF
  • BTF
  • 알 수 없음
조회 가능성 타겟팅 광고 게재위치 - 제외아니요문자열타겟팅에서 광고 게재순위 제외 허용되는 값 중 하나를 선택하거나 선택하지 않습니다.
  • ATF
  • BTF
  • 알 수 없음
동영상 광고 게재위치 타겟팅아니요문자열, 목록타겟팅할 동영상 광고 게재위치 목록입니다. 허용되는 값 중 하나 이상을 선택합니다.
  • 알 수 없음
  • 프리롤
  • 미드롤
  • 포스트롤
동영상 플레이어 크기 타겟팅아니요문자열, 목록타겟팅할 동영상 광고 플레이어 크기 목록입니다. 허용되는 값 중 하나 이상을 선택합니다.
  • 알 수 없음
  • 소형
  • 대형
  • HD
인구통계학적 타겟팅 - 성별아니요문자열, 목록타겟팅할 성별 목록입니다. 허용되는 값 중 하나 이상을 선택합니다.
  • 여성
  • 남성
  • 알 수 없음
인구통계학적 타겟팅 연령아니요문자열, 목록사용자 연령대를 타겟팅합니다. 시작 연령과 종료 연령을 각각 하나씩 선택하고 알 수 없는 연령을 포함할지 여부를 true/false로 지정하여 시작/종료 범위를 지정합니다. 허용되는 연령 범위 목록을 확인하세요.
예 1: 18~55세를 타겟팅하고 알 수 없는 연령을 포함하려면 {From; To ; Include unknown True/False} = 18;55;true; 형식을 지정합니다.
예 2: 35세 이상의 사용자만 타겟팅하고 알 수 없는 연령을 제외하려면 다음을 지정합니다 = 35;+;false;.
허용되는 시작 연령 값:
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

To에 허용되는 값은 다음과 같습니다.
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
연결 속도 타겟팅아니요문자열특정 연결 속도를 타겟팅합니다. 허용되는 값 중 하나를 선택합니다.
  • 전체
  • 2G
  • 3G
  • DSL
  • 4G
이동통신사 타겟팅 - 포함아니요문자열, 목록타겟팅할 ISP 또는 이동통신사 목록입니다. 목록 형식 = {ISP.id; ISP.id;}
이동통신사 타겟팅 - 제외아니요문자열, 목록제외할 ISP 또는 이동통신사 목록입니다. 목록 형식 = {ISP.id; ISP.id;}