항목 읽기 파일 형식 - V2

공유된 유형

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

Numeric Id 유형

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

Enum 유형

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

Time 유형

스칼라설명
integer마이크로초 단위의 Unix 시간(1/1,000,000초)(예: 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 Idauditor가 APPNEXUS, 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_unit가 1이면 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_microsintegerCPM 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는 대행사 트레이딩 데스크 수수료를 나타냅니다.
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_id는 InventorySource.id와 조인할 수 있고 Target.parameter는 정의되지 않습니다.
geo_locations [Target] 지리적 위치의 Target 유형 배열입니다. Target.criteria_id는 GeoLocation.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 (범용 모바일 통신 시스템 (3G)) 384kbps 이상).
6=DSL (디지털 구독자 회선. 768kbps 이상)
7=HSDPA (고속 다운링크 패킷 액세스 (3.5G)). 1.8Mbps 이상).

Target.parameter가 정의되지 않았습니다.
browsers TargetUnion TargetUnion 유형입니다. Target.criteria_id는 Browser.id와 조인할 수 있으며 Target.parameter는 정의되지 않습니다.
device_criteria [Target]기기 기준의 Array of Target 유형입니다. Target.criteria_id는 DeviceCriteria.id와 조인할 수 있으며 Target.parameter는 정의되지 않았습니다.
languages TargetUnionTargetUnion 언어 유형입니다. Target.criteria_id는 Language.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입니다.

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_id는 UserList.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_id는 UniversalChannel.id와 조인할 수 있으며 Target.parameter는 정의되지 않습니다.
sites[Target] 사이트의 Target 유형 배열입니다. Target.criteria_id는 UniversalSite.id와 조인할 수 있거나 사이트가 UniversalSite에 없는 경우 설정되지 않습니다. Target.parameter는 google.com와 같은 사이트이지만 반드시 UniversalSite에 있는 것은 아닙니다.
ispsTargetUnion인터넷 서비스 제공업체의 TargetUnion 유형입니다. Target.criteria_id는 ISP.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_codestringISO 4217의 세 글자 통화 코드입니다(예: 미국 달러의 경우 USD).
timezone_codestring표준 시간대 코드입니다(예: 'America/Los_Angeles'). dfa_configuration가 NORMAL 또는 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_configuration이 NONE로 설정된 경우 이 값이 누락됩니다.
dcm_advertiser_idNumeric IdCM360 광고주의 ID입니다. dcm_configuration이 NONE로 설정된 경우 이 값이 누락됩니다.
dcm_floodlight_group_idNumeric Iddcm_configuration이 NONE로 설정된 경우 이 값이 누락됩니다.
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_goal이 NONE로 설정된 경우 이 값이 누락됩니다.
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_configuration가 NONE로 설정된 경우에만 표시됩니다.
is_securebooleantrue로 설정하면 이 픽셀은 HTTPS를 사용합니다. 이 값은 상위 광고주의 dfa_configuration가 NONE로 설정된 경우에만 표시됩니다.

테이블 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]이 채널을 사용할 권한이 있으며 Advertiser.common_data.id와 조인할 수 있는 광고주 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_mobileboolean이 기준이 true이면 휴대기기에만 적용됩니다. false인 경우 이 항목은 이름 (예: '기타')는 그렇지 않습니다.
namestring기기 기준의 익숙한 이름입니다.
criteria_typeEnum0=OPERATING_SYSTEM
1=MOBILE_MAKE_MODEL
2=DEVICE_TYPE
operating_system_idNumeric Id운영체제를 식별합니다. 이 필드는 criteria_type가 0인 경우에만 채워집니다.
mobile_brand_namestring기기의 브랜드 이름입니다. 이 필드는 criteria_type가 1인 경우에만 채워집니다.
mobile_model_namestring기기의 모델 이름입니다. 이 필드는 criteria_type가 1인 경우에만 채워집니다. 선택사항입니다.
mobile_make_model_idNumeric Id기기의 모델 번호를 식별합니다. 이 필드는 criteria_type가 1인 경우에만 채워집니다. 선택사항입니다.
device_typeEnum기기 유형을 나타냅니다. 이 필드는 criteria_type가 2인 경우에만 채워집니다.

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). 전체 사용자 에이전트 문자열은 포함되지 않습니다.

테이블 Isp개

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

테이블 AppCollection개

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