항목 읽기 파일 형식 - V2

공유된 유형

이러한 유형은 일부 표에서 중첩된 필드를 정의합니다. 이러한 필드에는 자체 표가 없습니다.

Numeric Id 유형

스칼라설명
integer항목의 식별자로 사용되는 숫자 ID 번호입니다. ID는 전체적으로 고유한 것으로 취급해서는 안 됩니다. 예를 들어 픽셀에도 사용되는 캠페인에 동일한 ID 값이 사용될 수 있습니다.

Enum 유형

스칼라설명
integer가능한 여러 옵션을 열거합니다. 다양한 옵션은 상위 유형에 자세히 설명되어 있습니다.

Time 유형

스칼라설명
integer마이크로초 (1/1,000,000초) 단위의 Unix 시간입니다. 예를 들어 1330403779608570은 2012년 2월 28일 화요일 04:36:19.608570을 나타냅니다.

Currency Micro 유형

스칼라설명
integer통화별 금액 (통화 단위의 1/1,000,000)입니다. 예를 들어 통화가 유로인 경우 75000000은 75유로를 의미하고, 통화가 미국 달러인 경우 250000은 0.25달러를 의미합니다. 달러 금액으로 전환하거나 달러 금액에서 전환할 수는 없습니다.

Percentage Milli 유형

스칼라설명
integer백분율 (1/1,000)을 밀리로 표시합니다. 예를 들어 100은 0.1%를 의미합니다.

FileSummary 유형

필드 이름유형설명
namestring파일의 파일 이름 (버킷 또는 디렉터리 이름 제외)입니다.
num_recordsinteger파일의 항목 수입니다.
versioninteger파일의 주 버전 번호입니다. 향후 새 버전의 항목 데이터 형식이 생성되면 이 숫자가 변경될 수 있습니다.

EntityCommonData 유형

필드 이름유형설명
idNumeric Id각 항목 유형 내의 고유 ID입니다. 예를 들어 파트너 항목의 경우 이 ID는 파트너 ID가 되고 광고주의 경우 광고주 ID가 됩니다.
namestringUI에 표시되는 항목의 이름입니다.
activeboolean사용자가 설정한 상태입니다. 예를 들어 예산이 소진되었거나, 게재가 중단되었거나, 기타 이유로 인해 항목이 게재되지 않을 수 있습니다.
integration_codestring사용자가 설정한 통합 코드

ExchangeSettings 유형

필드 이름유형설명
exchange_idNumeric Id거래소의 ID입니다. SupportedExchange.id로 조인 가능
seat_idstring교환의 좌석 ID
seat_user_namestring이 자리와 관련된 사용자 이름입니다 (Right Media RTB 외 자리에만 해당).

ApprovalStatus 유형

필드 이름유형설명
auditorEnum0=DOUBLECLICK_BID_MANAGER
1=DOUBLECLICK_AD_EXCHANGE
2=APPNEXUS
3=APPNEXUS_MICROSOFT
4=RIGHT_MEDIA_NON_RTB
statusEnum0=APPROVED
1=REJECTED
2=PENDING
3=NO_AUDIT
4=UN_AUDITABLE
5=UNKNOWN
6=IN_AUDIT
feedbackstring거부 이유와 같은 추가 정보가 포함될 수 있는 감사자의 의견 양식입니다.
sync_timeTime항목이 auditor와 마지막으로 동기화된 시간입니다.
external_idNumeric IdauditorAPPNEXUS, APPNEXUS_MICROSOFT 또는 RIGHT_MEDIA_NON_RTB인 경우에만 채워집니다. 감사자 공간에 있는 엔티티의 ID입니다.

Budget 유형

필드 이름유형설명
start_time_usecTime예산 기간의 시작 시간입니다.
end_time_usecTime예산 기간의 종료 시간입니다.
max_impressionsinteger이 예산의 최대 노출수입니다. 이 필드가 누락된 경우 노출수 제한 없는 예산입니다.
max_spend_advertiser_microsinteger이 예산의 최대 지출액 (광고주 통화 기준)입니다. 이 필드가 누락된 경우 지출 한도가 없는 예산입니다.
pacing_typeEnum0=FLIGHT
1=DAILY
pacing_max_impressionsintegerpacing_type에서 설정한 속도 간격당 최대 노출수입니다. 이 필드가 없으면 노출에 제한이 없습니다.
pacing_max_spend_advertiser_microsintegerpacing_type에 의해 설정된 게재 간격 간격당 최대 비용 (광고주 통화 마이크로 단위)입니다. 이 필드가 누락된 경우 지출에 제한이 없습니다.
pacing_distributionEnum0=ASAP
1=EVEN
2=AHEAD

FrequencyCap 유형

필드 이름유형설명
max_impressionsinteger각 최대 게재빈도 간격의 최대 노출수입니다.
time_unitEnum시간 단위:
0=MINUTE
1=HOUR
2=DAY
3=WEEK
4=MONTH
5=LIFE_TIME
time_rangeintegertime_units 수입니다. 예를 들어 time_unit1인 경우 time_range의 값 6은 6시간입니다.

PartnerCosts 유형

필드 이름유형설명
cpm_fee_1_advertiser_microsinteger광고주 통화 마이크로 단위의 CPM 1 수수료입니다.
cpm_fee_2_advertiser_microsinteger광고주 통화 마이크로 단위의 CPM 2 수수료입니다.
cpm_fee_3_advertiser_microsinteger광고주 통화 마이크로 단위의 CPM 3 수수료입니다.
cpm_fee_4_advertiser_microsinteger광고주 통화 마이크로 단위의 CPM 4 수수료입니다.
cpm_fee_5_advertiser_microsinteger광고주 통화 마이크로 단위의 CPM 5 수수료입니다.
media_fee_percent_1_millisintegerPercentage Milli의 미디어 수수료 1
media_fee_percent_2_millisintegerPercentage Milli의 미디어 수수료 2
media_fee_percent_3_millisintegerPercentage Milli의 미디어 수수료 3
media_fee_percent_4_millisintegerPercentage Milli의 미디어 수수료 4
media_fee_percent_5_millisintegerPercentage Milli의 미디어 수수료 5
cpm_fee_1_cost_typeEnum0=DEFAULT_COST_TYPE
1=BID_MANAGER_FEE
2=THIRDPARTY_AD_SERVER
3=DOUBLE_VERIFY
4=ADSAFE
5=ADXPOSE
6=VIZU
7=AGGREGATE_KNOWLEDGE
8=TERACENT
9=EVIDON
10=ATD_FEE
11=DMP_FEE
12=INTEGRAL_AD_SCIENCE_PREBID
13=DOUBLE_VERIFY_PREBID
14=SHOP_LOCAL
15=TRUST_METRICS
16=MEDIACOST_DATA
17=INTEGRAL_AD_SCIENCE_VIDEO
18=MOAT_VIDEO
19=NIELSON_OCR
20=COMSCORE_VCE
21=ADLOOX
22=ADLOOX_PREBID
23=EXTRA_XBID_FEE
24=ADLINGO_FEE
25=CUSTOM_FEE_1
26=CUSTOM_FEE_2
27=CUSTOM_FEE_3
28=CUSTOM_FEE_4
29=CUSTOM_FEE_5

ATD_FEE는 Agency Trading Desk 수수료를 나타냅니다.
cpm_fee_2_cost_typeEnumcpm_fee_1_cost_type와 동일합니다.
cpm_fee_3_cost_typeEnumcpm_fee_1_cost_type와 동일합니다.
cpm_fee_4_cost_typeEnumcpm_fee_1_cost_type와 동일합니다.
cpm_fee_5_cost_typeEnumcpm_fee_1_cost_type와 동일합니다.
media_fee_percent_1_cost_typeEnumcpm_fee_1_cost_type와 동일합니다.
media_fee_percent_2_cost_typeEnumcpm_fee_1_cost_type와 동일합니다.
media_fee_percent_3_cost_typeEnumcpm_fee_1_cost_type와 동일합니다.
media_fee_percent_4_cost_typeEnumcpm_fee_1_cost_type와 동일합니다.
media_fee_percent_5_cost_typeEnumcpm_fee_1_cost_type와 동일합니다.
cpm_fee_1_bill_to_typeEnum0=DEFAULT_BILL_TO_TYPE
1=INVITE_MEDIA
2=PARTNER
cpm_fee_2_bill_to_typeEnumcpm_fee_1_bill_to_type와 동일합니다.
cpm_fee_3_bill_to_typeEnumcpm_fee_1_bill_to_type와 동일합니다.
cpm_fee_4_bill_to_typeEnumcpm_fee_1_bill_to_type와 동일합니다.
cpm_fee_5_bill_to_typeEnumcpm_fee_1_bill_to_type와 동일합니다.
media_fee_percent_1_bill_to_typeEnumcpm_fee_1_bill_to_type와 동일합니다.
media_fee_percent_2_bill_to_typeEnumcpm_fee_1_bill_to_type와 동일합니다.
media_fee_percent_3_bill_to_typeEnumcpm_fee_1_bill_to_type와 동일합니다.
media_fee_percent_4_bill_to_typeEnumcpm_fee_1_bill_to_type와 동일합니다.
media_fee_percent_5_bill_to_typeEnumcpm_fee_1_bill_to_type와 동일합니다.

PartnerRevenueModel 유형

필드 이름유형설명
typeEnum0=CPM
1=MEDIA_COST_MARKUP
2=TOTAL_MEDIA_COST_MARKUP
amount_advertiser_microsinteger광고주의 현재 마이크로 단위로 표시된 수익 금액입니다. 이 값은 유형이 CPM인 경우에만 설정됩니다.
media_cost_markup_percent_millisintegerPercentage Milli의 수익 비율 마크업입니다. 이 값은 유형이 MEDIA_COST_MARKUP 또는 TOTAL_MEDIA_COST_MARKUP인 경우에만 설정됩니다.
post_view_conversion_tracking_fractionfloat전환 추적에 반영할 조회 후 전환의 비율입니다. 이 값이 0이면 클릭 후 전환만 집계되고, 1.0이면 모든 전환이 추적됩니다.

CostTrackingPixel 유형

필드 이름유형설명
pixel_idNumeric Id추적 픽셀의 ID입니다. 두 CostTrackingPixel는 동일한 pixel_id을 공유하지만 조회 또는 클릭 기간 값이 다를 수 있습니다.

이 값은 Pixel.common_data.id과 결합할 수 있습니다.
view_window_minutesinteger조회 후 전환을 확인할 시간(분)입니다.
click_window_minutesinteger클릭 후 전환을 확인할 기간(분)입니다.
floodlight_activity_id숫자 IDCM 플러드라이트 활동 ID 이 값은 Pixel.dcm_floodlight_id와 조인할 수 있습니다.

Target 유형

필드 이름유형설명
criteria_idNumeric IdTargetList에 정의된 유형에 따라 다른 테이블과 조인할 수 있습니다. 이 값은 누락될 수 있습니다.
parameterstring정의가 TargetList에 정의된 유형에 따라 달라지는 추가 매개변수입니다. 이 값은 누락될 수 있습니다.
excludedbooleantrue인 경우 타겟이 제외됨을 의미합니다. 누락된 값은 false입니다.

TargetUnion 유형

필드 이름유형설명
union[Target]타겟의 합집합을 나타내는 Target 유형의 배열입니다.
excludedbooleantrue인 경우 타겟 합집합이 제외됨을 의미합니다. 누락된 값은 false을 의미합니다.

TargetList 유형

필드 이름유형설명
inventory_sources [Target]인벤토리 소스의 Target 유형 배열입니다. Target.criteria_idInventorySource.id와 조인할 수 있고 Target.parameter는 정의되지 않습니다.
geo_locations [Target] 지리적 위치의 Target 유형 배열입니다. Target.criteria_idGeoLocation.id와 결합할 수 있고 Target.parameter는 정의되지 않습니다.
ad_position Target 게시자 페이지에서 광고의 위치를 나타내는 Target입니다. Target.criteria_id 값은
0=ALL_POSITIONS
1=ABOVE_THE_FOLD
2=BELOW_THE_FOLD
3=UNKNOWN_POSITION

Target.parameter 정의되지 않습니다.
net_speed Target 네트워크 속도를 나타내는 Target입니다.
Target.criteria_id 값은 다음과 같습니다.
0=ALL_CONNECTION_SPEEDS
1=BROADBAND (2.0mbps 이상).
2=DIALUP (56kbps 이하)
3=UNKNOWN_CONNECTION_SPEED
4=EDGE (GSM Evolution용 향상된 데이터 (2G). 57kbps 이상).
5=UMT (범용 모바일 통신 시스템 (3G)) 384kbps 이상)
6=DSL (디지털 가입자 회선) 768kbps 이상)
7=HSDPA (고속 다운링크 패킷 액세스 (3.5G)) 1.8mpbs 이상).

Target.parameter가 정의되지 않았습니다.
browsers TargetUnion 브라우저용 TargetUnion 유형 Target.criteria_idBrowser.id와 조인할 수 있으며 Target.parameter는 정의되지 않습니다.
device_criteria [Target]기기 기준의 Array of Target 유형입니다. Target.criteria_idDeviceCriteria.id와 조인할 수 있으며 Target.parameter는 정의되지 않습니다.
languages TargetUnionTargetUnion 언어 유형입니다. Target.criteria_idLanguage.id와 조인할 수 있으며 Target.parameter는 정의되지 않습니다.
day_parting TargetUnion일별 파티션의 TargetUnion 유형 Target.criteria_id는 6자리입니다. (TimeZone)(DayOfWeek)(StartTime)(EndTime)

TimeZone:
0=USER
1=EASTERN
2=PACIFIC
3=LONDON
4=COPENHAGEN
5=SYDNEY
6=AUCKLAND
7=HONG_KONG
8=TOKYO
9=CALCUTTA
10=ADVERTISER


DayOfWeek:
0=MONDAY
1=TUESDAY
2=WEDNESDAY
3=THURSDAY
4=FRIDAY
5=SATURDAY
6=SUNDAY


StartTime:
자정부터 경과한 분을 15로 나눈 값입니다. 범위는 0~95입니다.

EndTime:
자정부터 경과된 분을 15로 나눈 값입니다. 범위는 1~96입니다.

예를 들어 값이 200380이면 태평양 표준시 기준 월요일 00:45~20:00을 의미합니다.

Target.parameter은 정의되지 않습니다.
audience_intersect [TargetUnion]잠재고객의 교집합에 관한 TargetUnion 유형의 배열입니다. 예를 들어
[{“union”: [A, B]},
 {“union”: [C, D]},
 {“union”: [E, F],
 “excluded”: true}]
'(A OR B) AND (C OR D) AND NOT (E OR F)'를 의미합니다.

Target.criteria_idUserList.id와 조인할 수 있으며 Target.parameter는 마이크로초 단위의 픽셀 최근성 값입니다. 이 값이 누락되면 모든 잠재고객을 타겟팅하는 것입니다.
keywords[Target]키워드의 Target 유형 배열입니다. Target.criteria_id는 정의되지 않으며 Target.parameter는 단일 키워드입니다.
kct_include_uncrawled_sitesboolean색인이 생성되지 않은 웹사이트를 KCT에 포함해야 하는지 여부를 나타내는 플래그입니다.
page_categories[Target]AdExchange 페이지 카테고리Target 유형 배열입니다. Target.criteria_id는 카테고리의 숫자 ID이고 Target.parameter는 정의되지 않습니다.
universal_channels[Target]채널의 Target 유형 배열입니다. Target.criteria_idUniversalChannel.id와 조인할 수 있으며 Target.parameter는 정의되지 않습니다.
sites[Target] 사이트의 Target 유형 배열입니다. Target.criteria_idUniversalSite.id와 결합할 수 있거나 사이트가 UniversalSite에 없는 경우 설정되지 않습니다. Target.parametergoogle.com와 같은 사이트이지만 UniversalSite에서 반드시 찾을 수 있는 것은 아닙니다.
ispsTargetUnion인터넷 서비스 제공업체의 TargetUnion 유형입니다. Target.criteria_idISP.id와 조인할 수 있으며 Target.parameter는 정의되지 않습니다.

SummaryFile 유형

필드 이름유형설명
file[FileSummary]0개 이상의 FileSummary 항목의 배열. 이 배열이 비어 있으면 해당 날짜에 생성된 데이터가 없음을 의미합니다.

UserListAdvertiserPricing 유형

필드 이름유형설명
pricingUserListPricing
advertiser_idNumeric Id

UserListPricing 유형

필드 이름유형설명
cost_typestring
currency_codestringISO 4217의 세 글자 통화 코드입니다(예: 미국 달러의 경우 USD).
cost_microsCurrency Micro

비공개 테이블

테이블 Partner

필드 이름유형설명
common_dataEntityCommonData이름, ID와 같은 이 파트너에 관한 일반적인 데이터가 포함됩니다.
currency_codestringISO 4217의 세 글자 통화 코드입니다(예: 미국 달러의 경우 USD).
exchange_settings[ExchangeSettings]좌석 ID와 같은 정보를 포함하는 ExchangeSettings 유형의 배열입니다. 사용 설정된 거래소만 표시됩니다.
default_partner_costsPartnerCosts이 파트너의 기본 비용에 관한 정보를 포함합니다.
default_partner_revenue_modelPartnerRevenueModel이 파트너의 기본 수익 모델에 관한 정보를 포함합니다.
default_target_listTargetList파트너의 기본 타겟팅 옵션을 포함합니다. 현재 기본 지역 타겟팅만 지원됩니다.

테이블 Advertiser

필드 이름유형설명
common_dataEntityCommonData이름, ID와 같은 이 광고주에 관한 일반적인 데이터를 포함합니다.
partner_idNumeric Id상위 파트너 객체의 ID입니다. Partner.common_data.id로 조인할 수 있습니다.
currency_codestring3자리 ISO 4217 통화 코드입니다(예: 미국 달러의 경우 USD).
timezone_codestring정규 시간대 코드입니다(예: 'America/Los_Angeles'). dfa_configurationNORMAL 또는 HYBRID로 설정된 경우 이 값은 연결된 DFA 광고주의 시간대와 동일합니다.
landing_page_urlstring기본 방문 페이지 URL입니다.
available_channel_ids[integer]이 광고주와 연결된 사용 가능한 채널이 포함된 정수의 배열입니다. UniversalChannel.id로 조인할 수 있습니다.
blacklist_channel_id[integer]이 광고주의 블랙리스트 채널이 포함된 정수 배열입니다. UniversalChannel.id로 조인할 수 있습니다.
dcm_configurationEnum0=NONE
1=NORMAL
2=HYBRID
dcm_network_idNumeric IdCM360 네트워크의 ID입니다. dcm_configurationNONE로 설정된 경우 이 값이 누락됩니다.
dcm_advertiser_idNumeric IdCM360 광고주의 ID입니다. dcm_configurationNONE로 설정된 경우 이 값이 누락됩니다.
dcm_floodlight_group_idNumeric Iddcm_configurationNONE로 설정된 경우 이 값이 누락됩니다.
dcm_syncable_site_ids[Numeric Id]이 광고주의 동기화 가능한 각 사이트에 대한 Numeric Id 유형의 배열입니다.
enable_oba_tagsboolean이 값이 true로 설정되면 OBA 태그가 사용 설정됩니다.

테이블 Campaign

필드 이름유형설명
common_dataEntityCommonData이 캠페인에 관한 공통 데이터(예: 이름, ID)를 포함합니다.
advertiser_idNumeric Id상위 광고주 객체의 ID입니다. Advertiser.common_data.id와(과) 참여 가능
budgetBudget이 캠페인의 계획된 예산입니다. 시작 시간과 종료 시간이 포함됩니다.
frequency_capFrequencyCap이 캠페인에 적용되는 최대 게재빈도입니다. 최대 게재빈도가 설정되지 않은 경우 이 값이 누락됩니다.
default_target_listTargetList이 캠페인에 적용되는 타겟팅에 관한 정보를 포함합니다.
uses_video_creativesbooleantrue로 설정하면 동영상 게재 신청서가 권장됩니다.
uses_display_creativesbooleantrue로 설정하면 디스플레이 게재 신청서가 권장됩니다.
uses_audio_creativesbooleantrue로 설정하면 오디오 게재 신청서가 권장됩니다.
objectiveEnum 값:
1 = BRAND_AWARENESS
2 = ONLINE_ACTION
3 = OFFLINE_ACTION
4 = APP_INSTALL
metricEnum 핵심성과지표 이 입력란을 사용하여 캠페인의 성공 여부를 평가하는 데 사용할 기본 측정항목을 추적합니다. 가능한 값은 다음과 같습니다.
1 = IMPRESSIONS
2 = VIEWABLE_IMPRESSIONS
3 = CPM
4 = CPV
5 = UNIQUES
6 = GRP
7 = TRP
8 = VCR
9 = CPA
10 = ROAS
11 = CTR
12 = CPC
13 = CVR
14 = CPI
15 = VIEWABLE_PERCENT
16 = CPIAVC
17 = OTHER
objective_descriptionString측정항목이 OTHER인 경우 측정항목에 대한 간략한 설명입니다.
metric_amount_microsinteger측정항목의 목표 금액(마이크로 단위)입니다.

테이블 InsertionOrder

필드 이름유형설명
common_dataEntityCommonData
advertiser_idNumeric Id상위 광고주 객체의 ID입니다. Advertiser.common_data.id로 조인할 수 있습니다.
campaign_idNumeric Id상위 캠페인 객체의 ID입니다.
overall_budgetBudget이 게재 신청서의 전체 예산입니다. 시작 시간과 종료 시간이 포함됩니다.
scheduled_segments[Budget]예약된 예산 세그먼트가 포함됩니다. 이 배열은 비어 있거나 아예 없을 수 있습니다.
frequency_capFrequencyCap이 게재 신청서에 활성화된 최대 게재빈도입니다. 최대 게재빈도가 설정되지 않은 경우 이 값이 누락됩니다.
default_partner_costsPartnerCosts
default_target_listTargetList

테이블 LineItem

필드 이름유형설명
common_data EntityCommonData
line_item_typeEnum 0=RTB
1=RMX_NON_RTB
2=RTB_EXPANDABLE
3=RTB_MOBILE
4=RTB_VIDEO
5=TRUEVIEW
6=NON_RTB_EXCHANGES
7=RTB_AUDIO
8=GMAIL
9=ADWORDS_UAC
11=OUT_OF_HOME
insertion_order_id Numeric Id 상위 게재 신청서 객체의 ID입니다. InsertionOrder.common_data.id와 조인할 수 있습니다.
creative_ids[Numeric Id]이 광고 항목에 할당된 광고 소재 배열입니다. Creative.common_data.id(으)로 참여할 수 있습니다.
max_cpm_advertiser_microsinteger광고주 통화 마이크로 단위의 최대 CPM 값입니다.
performance_goalEnum0=NONE (vCPM 사용 중지됨)
1=CPC
2=CPA
3=ROI
4=CPCV
5=CPM
6=AVCPM
7=IMP_VALUE_ROAS
8=CIVA
9=IVO_TEN
10=AV_VIEWED
11=INCREMENTAL_CONVERSIONS
goal_advertiser_microsinteger광고주 통화 마이크로 단위의 vCPM 목표입니다. performance_goalNONE로 설정된 경우 이 값이 누락됩니다.
partner_revenue_modelPartnerRevenueModel이 광고 항목에 사용되는 파트너 수익 모델입니다.
cost_tracking_pixels[CostTrackingPixel]이 광고 항목을 추적하도록 할당된 CostTrackingPixel 배열입니다.
BudgetBudget이 광고 항목의 전체 예산입니다. 시작 시간과 종료 시간이 포함됩니다.
frequency_capFrequencyCap이 광고 항목에 적용되는 최대 게재빈도입니다. 최대 게재빈도가 설정되지 않은 경우 이 값이 누락됩니다.
partner_costsPartnerCosts
target_listTargetList이 광고 항목에 적용되는 타겟팅에 관한 정보를 포함합니다.

테이블 Creative

필드 이름유형설명
common_dataEntityCommonData
advertiser_idNumeric Id상위 광고주 객체의 ID입니다. Advertiser.common_data.id로 조인할 수 있습니다.
dcm_placement_idNumeric Id이 광고 소재와 연결된 CM360 게재위치 ID입니다.
width_pixelsinteger광고 소재의 너비(픽셀)입니다.
height_pixelsinteger광고 소재의 높이(픽셀)입니다.
approval_status[ApprovalStatus]광고 소재를 승인하는 거래소의 광고 소재 상태를 나타내는 ApprovalStatus 객체가 포함된 배열입니다.
expanding_directionEnum0=Not Expandable
1=Expanding Up
2=Expanding Down
3=Expanding Left
4=Expanding Right
5=Expanding Up Left
6=Expanding Up Right
7=Expanding Down Left
8=Expanding Down Right
9=Expanding Up or Down
10=Expanding Left or Right
11=Expanding Any Diagonal
creative_typeEnum 0=Image or HTML5
1=Expandable
2=Video
3=Mobile
4=Native Site
5=Facebook Exchange Page Post (News Feed) Ads
6=Templated App Install Mobile Ads (Banner)
10=Native Site Square
12=Templated App Install Mobile Ads (Interstitial/Video Interstitial)
13=Lightbox
14=Native App Install
15=Native App Install Square
16=Audio
17=Publisher Hosted
18=Native Video
22=Flipbook
23=Templated App Install Video
24=TRACKING

테이블 Pixel

필드 이름유형설명
common_dataEntityCommonData
advertiser_idNumeric Id상위 광고주 객체의 ID입니다. Advertiser.common_data.id로 조인할 수 있습니다.
partner_idNumeric Id상위 파트너 객체의 ID입니다. Partner.common_data.id로 조인할 수 있습니다.
dcm_floodlight_idNumeric Id이 픽셀과 연결된 DFA 플러드라이트 ID입니다.
allow_google_redirectboolean
allow_rm_redirectbooleantrue로 설정하면 Right Media로의 리디렉션 또는 Right Media에서의 리디렉션이 가능하도록 픽셀이 사용 설정됩니다.
remarketing_enabledbooleantrue로 설정하면 이 픽셀이 타겟팅에 사용되도록 사용 설정됩니다. 이 값은 상위 광고주의 dfa_configurationNONE로 설정된 경우에만 존재합니다.
is_securebooleantrue로 설정하면 픽셀에서 HTTPS를 사용합니다. 이 값은 상위 광고주의 dfa_configurationNONE로 설정된 경우에만 표시됩니다.

테이블 Floodlight Activity

필드 이름유형설명
common_dataEntityCommonData
advertiser_idNumeric Id상위 광고주 객체의 ID입니다. Advertiser.common_data.id로 조인할 수 있습니다.
partner_idNumeric Id상위 광고주의 관리 파트너 객체의 ID입니다. Partner.common_data.id로 조인할 수 있습니다.
remarketing_enabledbooleantrue로 설정하면 이 활동이 타겟팅에 사용되도록 사용 설정됩니다.
ssl_requiredbooleantrue로 설정된 경우 태그가 규정을 준수해야 합니다.

테이블 InventorySource

필드 이름유형설명
idNumeric Id인벤토리 소스의 고유 키입니다.
unclassifiedbooleantrue로 설정하면 모든 분류되지 않은 인벤토리가 포함됩니다.
inventory_namestringUI에 표시되는 인벤토리 소스의 이름입니다. 이 필드는 없을 수도 있습니다. inventory_name가 없고 unclassified가 true인 경우 거래소의 분류되지 않은 인벤토리를 나타냅니다. 이 필드가 없고 unclassified가 false이면 인벤토리 소스가 거래소 수준 인벤토리입니다.
exchange_idNumeric Id이 인벤토리 소스를 사용할 수 있는 거래소의 ID입니다. SupportedExchange.id로 조인할 수 있습니다.
accessing_advertisers[Numeric Id]이 인벤토리 소스를 사용할 권한이 있으며 Advertiser.common_data.id와 조인할 수 있는 광고주 ID 배열입니다.

참고: 모든 광고주가 인벤토리 소스를 사용할 수 있는 경우 이 필드는 표시되지 않습니다.

external_idstring이 인벤토리 소스에 할당되고 거래소에서 정의한 외부 ID로, 일반적으로 거래 또는 판매자 ID라고 합니다. 이 필드는 없을 수도 있습니다.
min_cpm_microsinteger이 인벤토리 소스의 유효 하한선 가격입니다(단위: 통화 마이크로).
min_cpm_currency_codestringmin_cpm_micros에 사용되는 3자리 ISO 4217 통화 코드입니다.

테이블 UserList

필드 이름유형설명
idNumeric Id사용자 목록의 고유 키입니다.
namestringUI에 표시되는 사용자 목록의 이름입니다.
data_partner_idNumeric IdDataPartner.id로 조인할 수 있습니다. 이 필드는 서드 파티 사용자 목록에 대해서만 설정됩니다.
accessing_advertisers[Numeric Id]이 사용자 목록을 사용할 권한이 있으며 Advertiser.common_data.id와 조인할 수 있는 광고주 ID 배열입니다.

참고: 모든 광고주가 사용자 목록을 사용할 수 있는 경우 이 필드는 표시되지 않습니다.

partner_pricingUserListPricing비용 유형은 항상 CPM이고 통화 코드는 항상 USD입니다.
advertiser_pricings[UserListAdvertiserPricing]비용 유형은 항상 CPM이고 통화 코드는 항상 USD입니다.

테이블 CustomAffinity

필드 이름유형설명
id Numeric Id 맞춤 어피니티의 고유 키입니다.
name string UI에 표시되는 맞춤 관심분야의 이름입니다.
description string UI에 표시되는 맞춤 어피니티에 관한 설명입니다.
advertiser_id Numeric Id 상위 광고주 객체의 ID입니다. Advertiser.common_data.id로 조인할 수 있습니다.

테이블 UniversalChannel

필드 이름유형설명
idNumeric Id채널의 고유 키입니다.
namestringUI에 표시되는 채널 이름입니다.
site_ids [Numeric Id] 이 채널의 UniversalSite ID를 포함하는 배열입니다. UniversalSite.id로 조인할 수 있습니다.
accessing_advertisers[Numeric Id]광고주 ID의 배열로, Advertiser.common_data.id와 결합할 수 있으며, 이 채널을 사용할 권한이 있습니다.

참고: 모든 광고주가 채널을 사용할 수 있는 경우 이 입력란이 표시되지 않습니다.

is_deletedbooleantrue로 설정하면 새 광고 항목이 이 채널을 타겟팅할 수 없지만 이미 이 채널을 타겟팅하는 기존 광고 항목은 계속 타겟팅합니다.
is_brand_safe_channelbooleantrue로 설정하면 이 채널을 브랜드 안전 필터링에 사용할 수 있습니다. 현재는 4개의 내장 브랜드 안전성 등급에 대해서만 true입니다.

테이블 NegativeKeywordList

필드 이름유형설명
id Numeric Id 제외 키워드 목록의 고유 키입니다.
name string UI에 표시되는 제외 키워드 목록의 이름입니다.
advertiser_id Numeric Id 상위 광고주 객체의 ID입니다. Advertiser.common_data.id로 조인할 수 있습니다.

공개 테이블

테이블 SupportedExchange

필드 이름유형설명
idNumeric Id거래소의 고유 키입니다.
namestring거래소의 이름입니다(예: Ad Exchange).

테이블 DataPartner

필드 이름유형설명
idNumeric Id서드 파티 데이터 제공업체의 고유 키입니다.
namestring서드 파티 데이터 제공업체의 이름입니다(예: BlueKai).

테이블 UniversalSite

필드 이름유형설명
idNumeric Id범용 사이트의 고유 키입니다.
namestring사이트 URL 또는 이름(예: google.com 또는 Google Unclassified)

테이블 SiteIdToPlacementId

필드 이름유형설명
siteId Numeric Id 범용 사이트 ID에서 웹 게재위치 ID로 매핑
placementId Numeric Id 웹 게재위치 URL 또는 이름(예: google.com 또는 Google Unclassified)입니다.

테이블 GeoLocation

필드 이름유형설명
idNumeric Id지역의 고유 키입니다.
canonical_namestring쉼표로 구분된 위치 문자열 및 상위 항목입니다. 예: '미국 워싱턴주 시애틀'
geo_namestring위치 이름입니다. 예: '시애틀'
country_codestring이 지리적 위치의 ISO-3166 alpha-2 국가 코드입니다(예: US).
region_codestring이 위치의 ISO-3166-2 하위 지역 코드입니다(예: US-WA). 이 필드는 누락될 수 있습니다.
city_namestring이 지리적 위치의 도시 이름입니다(예: Seattle). 이 필드는 누락될 수 있습니다.
postal_codestring이 지리적 위치의 우편번호입니다(예: 98033). 이 필드가 누락되었을 수 있습니다.
dma_codeinteger이 지리적 위치의 DMA 코드입니다(예: 510). 이 필드는 누락될 수 있습니다.

테이블 Language

필드 이름유형설명
idNumeric Id이 언어의 고유 키입니다.
codestring이 언어의 ISO-639-1 코드 또는 중국어 (간체)의 경우 zh_CN, 중국어 (번체)의 경우 zh_TW, 기타 언어의 경우 other 중 하나입니다.

테이블 DeviceCriteria

필드 이름유형설명
idNumeric Id이 기기 기준의 고유 키입니다.
is_mobileboolean이 기준이 true이면 휴대기기에만 적용됩니다. false인 경우 이름 (예: '기타')는 이를 나타내지 않습니다.
namestring기기 기준의 익숙한 이름입니다.
criteria_typeEnum0=OPERATING_SYSTEM
1=MOBILE_MAKE_MODEL
2=DEVICE_TYPE
operating_system_idNumeric Id운영체제를 식별합니다. 이 필드는 criteria_type0인 경우에만 채워집니다.
mobile_brand_namestring기기의 브랜드 이름입니다. 이 필드는 criteria_type1인 경우에만 채워집니다.
mobile_model_namestring기기의 모델 이름입니다. 이 필드는 criteria_type1인 경우에만 채워집니다. 선택사항입니다.
mobile_make_model_idNumeric Id기기의 모델 번호를 식별합니다. 이 필드는 criteria_type1인 경우에만 채워집니다. 선택사항입니다.
device_typeEnum기기 유형을 나타냅니다. 이 필드는 criteria_type2인 경우에만 채워집니다.

0=COMPUTER
1=OTHER
2=SMARTPHONE
3=TABLET
4=SMARTTV
5=CONNECTEDTV
6=SET_TOP_BOX
7=CONNECTEDDEVICE

테이블 Browser

필드 이름유형설명
idNumeric Id이 브라우저의 고유 키입니다.
is_mobileboolean이 기준이 true이면 휴대기기에만 적용됩니다. false인 경우 이 항목은 이름 (예: '기타')와 같은 경우는 해당하지 않습니다.
namestring익숙한 브라우저 이름입니다(예: Safari 5). 전체 user-agent 문자열은 포함되지 않습니다.

테이블 Isp

필드 이름유형설명
idNumeric Id이 인터넷 서비스 제공업체의 고유 키입니다.
is_mobileboolean이 기준이 true이면 휴대기기에만 적용됩니다. false인 경우 이 항목은 이름 (예: '기타')는 이를 나타내지 않습니다.
namestring이 인터넷 서비스 제공업체의 이름입니다.
secondary_criteria_idinteger 항목을 식별하는 데 사용할 수 있는 대체 ID(선택사항)입니다.

테이블 AppCollection

필드 이름유형설명
idNumeric Id이 앱 컬렉션의 고유 키입니다.
namestring이 앱 모음의 이름입니다.