항목 읽기 파일 형식 - V2

공유된 유형

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

Numeric Id 유형

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

Enum 유형

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

Time 유형

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

Currency Micro 유형

스칼라설명
integer마이크로 단위의 통화별 금액 (통화 단위의 1/1,000,000)입니다. 예를 들어 통화가 EUR인 경우 75000000은 75유로, 통화가 USD인 경우 250000은 $0.25를 의미합니다. 달러 금액 간에 변환이 발생하지 않습니다.

Percentage Milli 유형

스칼라설명
integer밀리초 (1/1,000퍼센트의 1%)로 표시된 백분율입니다. 예를 들어 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 비실시간 입찰 시트에만 해당).

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_microsintegerCPM 1 수수료(광고주 통화 마이크로 단위)
cpm_fee_2_advertiser_microsintegerCPM 2 수수료(광고주 통화 마이크로 단위)
cpm_fee_3_advertiser_microsintegerCPM 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에 정의된 유형에 따라 다른 테이블과 조인할 수 있습니다. 이 값이 누락되었을 수 있습니다.
parameterstringTargetList에 정의된 유형에 따라 정의가 달라지는 추가 매개변수입니다. 이 값이 누락되었을 수 있습니다.
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 (Enhanced Data for GSM Evolution (2G). 57kbps 이상).
5=UMT (Universal Mobile Telecom System (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)

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


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


시작 시간:
자정 후 경과된 분, 15로 나눈 값입니다. 범위는 0~95입니다.

종료 시간:
자정 후 경과한 분을 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색인이 생성되지 않은 웹사이트를 키워드 문맥에 포함해야 하는지 나타내는 플래그입니다.
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인터넷 서비스 제공업체(ISP)의 TargetUnion 유형입니다. Target.criteria_idISP.id와 조인할 수 있으며 Target.parameter는 정의되지 않습니다.

SummaryFile 유형

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

UserListAdvertiserPricing 유형

필드 이름유형설명
pricingUserListPricing
advertiser_idNumeric Id

UserListPricing 유형

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

비공개 테이블

테이블 Partner

필드 이름유형설명
common_dataEntityCommonData이름, ID와 같이 이 파트너에 대한 일반적인 데이터를 포함합니다.
currency_codestring3자리 ISO 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_tagsbooleantrue로 설정하면 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에서/다시 되돌아갈 수 있습니다.
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]광고주 ID의 배열로, Advertiser.common_data.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]광고주 ID의 배열로, Advertiser.common_data.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위치 및 그 상위 요소의 쉼표로 연결된 문자열입니다. 예: 'Seattle, Washington, United States'.
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_mobilebooleantrue인 경우 이 기준은 휴대기기에만 적용됩니다. 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_mobilebooleantrue인 경우 이 기준은 휴대기기에만 적용됩니다. false인 경우 이 항목은 이름 (예: '기타')는 이를 나타내지 않습니다.
namestring브라우저의 익숙한 이름입니다(예: Safari 5). 전체 사용자 에이전트 문자열은 포함되지 않습니다.

테이블 Isp

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

테이블 AppCollection

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