현재 일부 보고서 유형이 오프라인에서 빠른 보고서로 이전 중입니다. 사용자가 이전되면
queries.list
응답에 기존의 빠른 보고서가 포함됩니다. 자세한 내용은
블로그 게시물 을 참고하세요.
항목 읽기 파일 형식 - V2
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Null 스칼라와 빈 배열은 파일에서 생략됩니다.
공유된 유형
이러한 유형은 일부 테이블에 중첩된 필드를 정의합니다. 이러한 필드에는 자체 테이블이 없습니다.
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
유형
필드 이름 유형 설명
name
string
파일의 파일 이름 (버킷 또는 디렉터리 이름 제외)입니다.
num_records
integer
파일의 항목 수입니다.
version
integer
파일의 주 버전 번호입니다. 향후 새 버전의 항목 데이터 형식이 생성되면 이 숫자가 변경될 수 있습니다.
EntityCommonData
유형
필드 이름 유형 설명
id
Numeric Id
각 항목 유형 내의 고유 ID입니다. 예를 들어 파트너 항목의 경우 이 ID는 파트너 ID가 되고 광고주의 경우 광고주 ID가 됩니다.
name
string
UI에 표시되는 항목 이름입니다.
active
boolean
사용자가 설정한 상태입니다. 예산 소진, 광고 게재 기간 초과 등 다른 이유로 항목이 게재되지 않을 수 있습니다.
integration_code
string
사용자가 설정한 통합 코드
ExchangeSettings
유형
필드 이름 유형 설명
exchange_id
Numeric Id
거래소의 ID입니다. SupportedExchange .id와 결합 가능
seat_id
string
교환의 좌석 ID
seat_user_name
string
이 시트와 관련된 사용자 이름입니다 (Right Media 비 RTB 시트에만 적용됨).
ApprovalStatus
유형
필드 이름 유형 설명
auditor
Enum
0=DOUBLECLICK_BID_MANAGER 1=DOUBLECLICK_AD_EXCHANGE 2=APPNEXUS 3=APPNEXUS_MICROSOFT 4=RIGHT_MEDIA_NON_RTB
status
Enum
0=APPROVED 1=REJECTED 2=PENDING 3=NO_AUDIT 4=UN_AUDITABLE 5=UNKNOWN 6=IN_AUDIT
feedback
string
거부 이유와 같은 추가 정보가 포함될 수 있는 감사자의 의견 양식입니다.
sync_time
Time
항목이 auditor
와 마지막으로 동기화된 시간
external_id
Numeric Id
auditor
가 APPNEXUS
, APPNEXUS_MICROSOFT
또는 RIGHT_MEDIA_NON_RTB
인 경우에만 채워집니다. 감사자 스페이스의 항목 ID입니다.
Budget
유형
필드 이름 유형 설명
start_time_usec
Time
예산 기간의 시작 시간입니다.
end_time_usec
Time
예산 기간의 종료 시간입니다.
max_impressions
integer
이 예산의 최대 노출수입니다. 이 필드가 누락된 경우 노출수 제한 없는 예산입니다.
max_spend_advertiser_micros
integer
이 예산의 최대 지출액 (광고주 통화 기준)입니다. 이 필드가 누락된 경우 지출 한도가 없는 예산입니다.
pacing_type
Enum
0=FLIGHT 1=DAILY
pacing_max_impressions
integer
pacing_type
에서 설정한 게재 간격 간격당 최대 노출수입니다. 이 필드가 누락되면 노출수 제한이 없는 것입니다.
pacing_max_spend_advertiser_micros
integer
pacing_type
에서 설정한 속도 간격당 최대 지출 (광고주 통화 마이크로 단위)입니다. 이 입력란이 누락되면 지출 한도가 없는 것입니다.
pacing_distribution
Enum
0=ASAP 1=EVEN 2=AHEAD
FrequencyCap
유형
필드 이름 유형 설명
max_impressions
integer
각 상한 간격에서의 최대 노출수입니다.
time_unit
Enum
시간 단위:0=MINUTE 1=HOUR 2=DAY 3=WEEK 4=MONTH 5=LIFE_TIME
time_range
integer
time_units
의 수입니다. 예를 들어 time_unit
가 1
이면 time_range
의 값 6은 6시간입니다.
PartnerCosts
유형
필드 이름 유형 설명
cpm_fee_1_advertiser_micros
integer
광고주 통화 마이크로 단위의 CPM 1 수수료입니다.
cpm_fee_2_advertiser_micros
integer
광고주 통화 마이크로 단위의 CPM 2 수수료입니다.
cpm_fee_3_advertiser_micros
integer
광고주 통화 마이크로 단위의 CPM 3 수수료입니다.
cpm_fee_4_advertiser_micros
integer
CPM 4 수수료(광고주 통화 마이크로 단위)
cpm_fee_5_advertiser_micros
integer
광고주 통화 마이크로 단위의 CPM 5 수수료입니다.
media_fee_percent_1_millis
integer
Percentage Milli
의 미디어 수수료 1
media_fee_percent_2_millis
integer
Percentage Milli
의 미디어 수수료 2
media_fee_percent_3_millis
integer
Percentage Milli
의 미디어 수수료 3
media_fee_percent_4_millis
integer
Percentage Milli
의 미디어 수수료 4
media_fee_percent_5_millis
integer
Percentage Milli
의 미디어 수수료 5
cpm_fee_1_cost_type
Enum
0=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_type
Enum
cpm_fee_1_cost_type
와 동일합니다.
cpm_fee_3_cost_type
Enum
cpm_fee_1_cost_type
와 동일합니다.
cpm_fee_4_cost_type
Enum
cpm_fee_1_cost_type
와 동일합니다.
cpm_fee_5_cost_type
Enum
cpm_fee_1_cost_type
와 동일합니다.
media_fee_percent_1_cost_type
Enum
cpm_fee_1_cost_type
와 동일합니다.
media_fee_percent_2_cost_type
Enum
cpm_fee_1_cost_type
와 동일합니다.
media_fee_percent_3_cost_type
Enum
cpm_fee_1_cost_type
와 동일합니다.
media_fee_percent_4_cost_type
Enum
cpm_fee_1_cost_type
와 동일합니다.
media_fee_percent_5_cost_type
Enum
cpm_fee_1_cost_type
와 동일합니다.
cpm_fee_1_bill_to_type
Enum
0=DEFAULT_BILL_TO_TYPE 1=INVITE_MEDIA 2=PARTNER
cpm_fee_2_bill_to_type
Enum
cpm_fee_1_bill_to_type
와 동일합니다.
cpm_fee_3_bill_to_type
Enum
cpm_fee_1_bill_to_type
와 동일합니다.
cpm_fee_4_bill_to_type
Enum
cpm_fee_1_bill_to_type
와 동일합니다.
cpm_fee_5_bill_to_type
Enum
cpm_fee_1_bill_to_type
와 동일합니다.
media_fee_percent_1_bill_to_type
Enum
cpm_fee_1_bill_to_type
와 동일합니다.
media_fee_percent_2_bill_to_type
Enum
cpm_fee_1_bill_to_type
와 동일합니다.
media_fee_percent_3_bill_to_type
Enum
cpm_fee_1_bill_to_type
와 동일합니다.
media_fee_percent_4_bill_to_type
Enum
cpm_fee_1_bill_to_type
와 동일합니다.
media_fee_percent_5_bill_to_type
Enum
cpm_fee_1_bill_to_type
와 동일합니다.
PartnerRevenueModel
유형
필드 이름 유형 설명
type
Enum
0=CPM 1=MEDIA_COST_MARKUP 2=TOTAL_MEDIA_COST_MARKUP
amount_advertiser_micros
integer
광고주의 현재 마이크로 단위로 표시된 수익 금액입니다. 이 값은 유형이 CPM
인 경우에만 설정됩니다.
media_cost_markup_percent_millis
integer
Percentage Milli
의 수익 비율 마크업입니다. 이 값은 유형이 MEDIA_COST_MARKUP
또는 TOTAL_MEDIA_COST_MARKUP
인 경우에만 설정됩니다.
post_view_conversion_tracking_fraction
float
전환 추적에 반영할 조회 후 전환의 비율입니다. 0이면 클릭 후 전환만 집계되고 1.0이면 모든 전환이 추적됩니다.
CostTrackingPixel
유형
필드 이름 유형 설명
pixel_id
Numeric Id
추적 픽셀의 ID입니다. 두 CostTrackingPixel
는 동일한 pixel_id
을 공유하지만 조회 또는 클릭 기간 값이 다를 수 있습니다. 이 값은 Pixel .common_data.id
과 결합할 수 있습니다.
view_window_minutes
integer
조회 후 전환을 찾을 기간(분)입니다.
click_window_minutes
integer
클릭 후 전환을 확인할 기간(분)입니다.
floodlight_activity_id
숫자 ID CM 플러드라이트 활동 ID 이 값은 Pixel .dcm_floodlight_id
와 조인할 수 있습니다.
Target
유형
필드 이름 유형 설명
criteria_id
Numeric Id
TargetList
에 정의된 유형에 따라 다른 테이블과 조인할 수 있습니다. 이 값은 누락될 수 있습니다.
parameter
string
정의가 TargetList
에 정의된 유형에 종속되는 추가 매개변수입니다. 이 값이 누락되었을 수 있습니다.
excluded
boolean
true
인 경우 타겟이 제외됨을 의미합니다. 누락된 값은 false
을 의미합니다.
TargetUnion
유형
필드 이름 유형 설명
union
[Target]
타겟의 합집합을 나타내는 Target
유형의 배열.
excluded
boolean
true
인 경우 타겟 합집합이 제외됨을 의미합니다. 누락된 값은 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
TargetUnion
TargetUnion
언어 유형입니다. 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_sites
boolean
색인이 생성되지 않은 웹사이트를 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
에 있는 것은 아닙니다.
isps
TargetUnion
인터넷 서비스 제공업체의 TargetUnion
유형입니다. Target .criteria_id
는 ISP .id
와 조인할 수 있으며 Target .parameter
는 정의되지 않습니다.
SummaryFile
유형
UserListAdvertiserPricing
유형
UserListPricing
유형
필드 이름 유형 설명
cost_type
string
currency_code
string
ISO 4217의 세 글자 통화 코드입니다(예: 미국 달러의 경우 USD).
cost_micros
Currency Micro
비공개 테이블
테이블 Partner
개
테이블 Advertiser
개
필드 이름 유형 설명
common_data
EntityCommonData
이름, ID 등 이 광고주에 대한 공통 데이터를 포함합니다.
partner_id
Numeric Id
상위 파트너 객체의 ID입니다. Partner .common_data.id
로 조인할 수 있습니다.
currency_code
string
ISO 4217의 세 글자 통화 코드입니다(예: 미국 달러의 경우 USD
).
timezone_code
string
표준 시간대 코드입니다(예: 'America/Los_Angeles'). dfa_configuration
가 NORMAL
또는 HYBRID
로 설정된 경우 이 값은 연결된 DFA 광고주의 시간대와 동일합니다.
landing_page_url
string
기본 방문 페이지 URL입니다.
available_channel_ids
[integer]
이 광고주와 연결된 사용 가능한 채널이 포함된 정수 배열입니다. UniversalChannel .id
로 결합할 수 있습니다.
blacklist_channel_id
[integer]
이 광고주의 블랙리스트 채널이 포함된 정수 배열입니다. UniversalChannel .id
로 조인할 수 있습니다.
dcm_configuration
Enum
0=NONE 1=NORMAL 2=HYBRID
dcm_network_id
Numeric Id
CM360 네트워크의 ID입니다. dcm_configuration
이 NONE
로 설정된 경우 이 값이 누락됩니다.
dcm_advertiser_id
Numeric Id
CM360 광고주의 ID입니다. dcm_configuration
이 NONE
로 설정된 경우 이 값이 누락됩니다.
dcm_floodlight_group_id
Numeric Id
dcm_configuration
이 NONE
로 설정된 경우 이 값이 누락됩니다.
dcm_syncable_site_ids
[Numeric Id]
이 광고주의 동기화 가능한 각 사이트에 대한 Numeric Id
유형의 배열입니다.
enable_oba_tags
boolean
true
로 설정하면 OBA 태그가 사용 설정됩니다.
테이블 Campaign
개
필드 이름 유형 설명
common_data
EntityCommonData
이 캠페인에 관한 공통 데이터(예: 이름, ID)를 포함합니다.
advertiser_id
Numeric Id
상위 광고주 객체의 ID입니다. Advertiser .common_data.id
로 참여 가능
budget
Budget
이 캠페인에 대해 계획된 예산입니다. 시작 시간과 종료 시간이 포함됩니다.
frequency_cap
FrequencyCap
이 캠페인에 적용되는 최대 게재빈도입니다. 최대 게재빈도가 설정되지 않은 경우 이 값이 누락됩니다.
default_target_list
TargetList
이 캠페인에 적용되는 타겟팅에 관한 정보를 포함합니다.
uses_video_creatives
boolean
true로 설정하면 동영상 게재 신청서가 권장됩니다.
uses_display_creatives
boolean
true로 설정하면 디스플레이 게재 신청서가 권장됩니다.
uses_audio_creatives
boolean
true로 설정하면 오디오 게재 신청서가 권장됩니다.
objective
Enum
값은 다음과 같습니다.
1 = BRAND_AWARENESS
2 = ONLINE_ACTION
3 = OFFLINE_ACTION
4 = APP_INSTALL
metric
Enum
핵심성과지표 이 입력란을 사용하여 캠페인의 성공 여부를 평가하는 데 사용할 기본 측정항목을 추적합니다.
가능한 값은 다음과 같습니다.
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_description
String
측정항목이 OTHER
인 경우 측정항목에 대한 간단한 설명입니다.
metric_amount_micros
integer
측정항목의 목표 금액(마이크로 단위)입니다.
테이블 InsertionOrder
개
테이블 LineItem
개
필드 이름 유형 설명
common_data
EntityCommonData
line_item_type
Enum
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_micros
integer
광고주 통화(마이크로)로 표시되는 최대 CPM 값입니다.
performance_goal
Enum
0=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_micros
integer
광고주 통화 마이크로 단위의 vCPM 목표입니다. performance_goal
이 NONE
로 설정된 경우 이 값이 누락됩니다.
partner_revenue_model
PartnerRevenueModel
이 광고 항목에 사용되는 파트너 수익 모델입니다.
cost_tracking_pixels
[CostTrackingPixel]
이 광고 항목을 추적하도록 할당된 CostTrackingPixel 배열입니다.
Budget
Budget
이 광고 항목의 전체 예산입니다. 시작 시간과 종료 시간이 포함됩니다.
frequency_cap
FrequencyCap
이 광고 항목에 적용되는 최대 게재빈도입니다. 최대 게재빈도가 설정되지 않은 경우 이 값이 누락됩니다.
partner_costs
PartnerCosts
target_list
TargetList
이 광고 항목에 적용되는 타겟팅에 관한 정보를 포함합니다.
테이블 Creative
개
필드 이름 유형 설명
common_data
EntityCommonData
advertiser_id
Numeric Id
상위 광고주 객체의 ID입니다. Advertiser .common_data.id
(으)로 참여할 수 있습니다.
dcm_placement_id
Numeric Id
이 광고 소재와 연결된 CM360 게재위치 ID입니다.
width_pixels
integer
광고 소재의 너비(픽셀)입니다.
height_pixels
integer
광고 소재의 높이(픽셀)입니다.
approval_status
[ApprovalStatus]
광고 소재를 승인하는 거래소의 광고 소재 상태를 나타내는 ApprovalStatus
객체가 포함된 배열입니다.
expanding_direction
Enum
0=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_type
Enum
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_data
EntityCommonData
advertiser_id
Numeric Id
상위 광고주 객체의 ID입니다. Advertiser .common_data.id
로 결합할 수 있습니다.
partner_id
Numeric Id
상위 파트너 객체의 ID입니다. Partner .common_data.id
로 조인할 수 있습니다.
dcm_floodlight_id
Numeric Id
이 픽셀과 연결된 DFA 플러드라이트 ID입니다.
allow_google_redirect
boolean
allow_rm_redirect
boolean
true
로 설정하면 Right Media로의 리디렉션 또는 Right Media에서의 리디렉션이 가능하도록 픽셀이 사용 설정됩니다.
remarketing_enabled
boolean
true
로 설정하면 이 픽셀이 타겟팅에 사용되도록 사용 설정됩니다. 이 값은 상위 광고주의 dfa_configuration
가 NONE
로 설정된 경우에만 표시됩니다.
is_secure
boolean
true
로 설정하면 이 픽셀은 HTTPS를 사용합니다. 이 값은 상위 광고주의 dfa_configuration
가 NONE
로 설정된 경우에만 표시됩니다.
테이블 Floodlight Activity
개
필드 이름 유형 설명
common_data
EntityCommonData
advertiser_id
Numeric Id
상위 광고주 객체의 ID입니다. Advertiser .common_data.id
로 조인할 수 있습니다.
partner_id
Numeric Id
상위 광고주의 관리 파트너 객체의 ID입니다. Partner .common_data.id
(으)로 참여할 수 있습니다.
remarketing_enabled
boolean
true
로 설정하면 이 활동이 타겟팅에 사용되도록 사용 설정됩니다.
ssl_required
boolean
true
로 설정된 경우 태그가 규정을 준수해야 합니다.
테이블 InventorySource
개
필드 이름 유형 설명
id
Numeric Id
인벤토리 소스의 고유 키입니다.
unclassified
boolean
true
로 설정하면 모든 분류되지 않은 인벤토리가 포함됩니다.
inventory_name
string
UI에 표시되는 인벤토리 소스의 이름입니다. 이 필드는 없을 수도 있습니다. inventory_name
가 없고 unclassified
가 true인 경우 거래소의 분류되지 않은 인벤토리를 나타냅니다. 이 필드가 없고 unclassified
가 false이면 인벤토리 소스가 거래소 수준 인벤토리입니다.
exchange_id
Numeric Id
이 인벤토리 소스를 사용할 수 있는 거래소의 ID입니다. SupportedExchange .id
(으)로 참여할 수 있습니다.
accessing_advertisers
[Numeric Id]
이 인벤토리 소스를 사용할 권한이 있으며 Advertiser .common_data.id
와 조인할 수 있는 광고주 ID 배열입니다.참고: 모든 광고주가 인벤토리 소스를 사용할 수 있는 경우 이 필드는 표시되지 않습니다.
external_id
string
이 인벤토리 소스에 할당되고 거래소에서 정의한 외부 ID로, 일반적으로 거래 또는 판매자 ID라고 합니다. 이 필드가 없을 수도 있습니다.
min_cpm_micros
integer
이 인벤토리 소스의 유효 하한선 가격입니다(단위: 통화 마이크로).
min_cpm_currency_code
string
min_cpm_micros
에 사용되는 3자리 ISO 4217 통화 코드입니다.
테이블 UserList
개
테이블 CustomAffinity
개
필드 이름 유형 설명
id
Numeric Id
맞춤 관심분야의 고유 키입니다.
name
string
UI에 표시되는 맞춤 관심분야의 이름입니다.
description
string
UI에 표시되는 맞춤 어피니티에 관한 설명입니다.
advertiser_id
Numeric Id
상위 광고주 객체의 ID입니다. Advertiser .common_data.id
(으)로 참여할 수 있습니다.
테이블 UniversalChannel
개
필드 이름 유형 설명
id
Numeric Id
채널의 고유 키입니다.
name
string
UI에 표시되는 채널 이름입니다.
site_ids
[Numeric Id]
이 채널에 있는 UniversalSite
의 ID가 포함된 배열입니다. UniversalSite .id
로 조인할 수 있습니다.
accessing_advertisers
[Numeric Id]
이 채널을 사용할 권한이 있으며 Advertiser .common_data.id
와 조인할 수 있는 광고주 ID 배열입니다.참고: 채널이 모든 광고주가 사용할 수 있는 경우 이 필드는 표시되지 않습니다.
is_deleted
boolean
true
로 설정하면 새 광고 항목에서 이 채널을 타겟팅할 수 없지만 이미 이 채널을 타겟팅하는 기존 광고 항목은 계속 타겟팅할 수 있습니다.
is_brand_safe_channel
boolean
true
로 설정하면 이 채널을 브랜드 안전 필터링에 사용할 수 있습니다. 현재는 4개의 내장 브랜드 안전성 등급에 대해서만 true
입니다.
테이블 NegativeKeywordList
개
필드 이름 유형 설명
id
Numeric Id
제외 키워드 목록의 고유 키입니다.
name
string
UI에 표시되는 제외 키워드 목록의 이름입니다.
advertiser_id
Numeric Id
상위 광고주 객체의 ID입니다. Advertiser .common_data.id
로 조인할 수 있습니다.
공개 테이블
테이블 SupportedExchange
개
필드 이름 유형 설명
id
Numeric Id
거래의 고유 키입니다.
name
string
거래소의 이름입니다(예: Ad Exchange
).
테이블 DataPartner
개
필드 이름 유형 설명
id
Numeric Id
서드 파티 데이터 제공업체의 고유 키입니다.
name
string
서드 파티 데이터 제공업체의 이름입니다(예: BlueKai
).
테이블 UniversalSite
개
필드 이름 유형 설명
id
Numeric Id
범용 사이트의 고유 키입니다.
name
string
사이트 URL 또는 이름(예: google.com
또는 Google Unclassified
)
테이블 SiteIdToPlacementId
개
필드 이름 유형 설명
siteId
Numeric Id
범용 사이트 ID에서 웹 게재위치 ID로 매핑
placementId
Numeric Id
웹 게재위치 URL 또는 이름입니다(예: google.com
또는 Google Unclassified
).
테이블 GeoLocation
개
필드 이름 유형 설명
id
Numeric Id
지리적 위치의 고유 키입니다.
canonical_name
string
위치와 상위 요소를 쉼표로 연결한 문자열입니다. 예: 'Seattle, Washington, United States'.
geo_name
string
위치 이름입니다. 예: '시애틀'
country_code
string
이 지리적 위치의 ISO-3166 alpha-2 국가 코드입니다(예: US
).
region_code
string
이 위치의 ISO-3166-2 하위 지역 코드입니다(예: US-WA
). 이 필드가 누락되었을 수 있습니다.
city_name
string
이 지리적 위치의 도시 이름입니다(예: Seattle
). 이 필드는 누락될 수 있습니다.
postal_code
string
이 지리적 위치의 우편번호입니다(예: 98033
). 이 필드는 누락될 수 있습니다.
dma_code
integer
이 지리적 위치의 DMA 코드입니다(예: 510
). 이 필드는 누락될 수 있습니다.
테이블 Language
개
필드 이름 유형 설명
id
Numeric Id
이 언어의 고유 키입니다.
code
string
이 언어의 ISO-639-1 코드 또는 중국어 (간체)의 경우 zh_CN
, 중국어 (번체)의 경우 zh_TW
, 기타 언어의 경우 other
중 하나입니다.
테이블 DeviceCriteria
개
필드 이름 유형 설명
id
Numeric Id
이 기기 기준의 고유 키입니다.
is_mobile
boolean
이 기준이 true이면 휴대기기에만 적용됩니다. false인 경우 이 항목은 이름 (예: '기타')는 그렇지 않습니다.
name
string
기기 기준의 익숙한 이름입니다.
criteria_type
Enum
0=OPERATING_SYSTEM 1=MOBILE_MAKE_MODEL 2=DEVICE_TYPE
operating_system_id
Numeric Id
운영체제를 식별합니다. 이 필드는 criteria_type
가 0
인 경우에만 채워집니다.
mobile_brand_name
string
기기의 브랜드 이름입니다. 이 필드는 criteria_type
가 1
인 경우에만 채워집니다.
mobile_model_name
string
기기의 모델 이름입니다. 이 필드는 criteria_type
가 1
인 경우에만 채워집니다. 선택사항입니다.
mobile_make_model_id
Numeric Id
기기의 모델 번호를 식별합니다. 이 필드는 criteria_type
가 1
인 경우에만 채워집니다. 선택사항입니다.
device_type
Enum
기기 유형을 나타냅니다. 이 필드는 criteria_type
가 2
인 경우에만 채워집니다.0=COMPUTER 1=OTHER 2=SMARTPHONE 3=TABLET 4=SMARTTV 5=CONNECTEDTV 6=SET_TOP_BOX 7=CONNECTEDDEVICE
테이블 Browser
개
필드 이름 유형 설명
id
Numeric Id
이 브라우저의 고유 키입니다.
is_mobile
boolean
이 기준이 true이면 휴대기기에만 적용됩니다. false인 경우 이 항목은 이름 (예: '기타')는 이를 나타내지 않습니다.
name
string
익숙한 브라우저 이름입니다(예: Safari 5
). 전체 사용자 에이전트 문자열은 포함되지 않습니다.
테이블 Isp
개
필드 이름 유형 설명
id
Numeric Id
이 인터넷 서비스 제공업체의 고유 키입니다.
is_mobile
boolean
true인 경우 이 기준은 휴대기기에만 적용됩니다. false인 경우 이 항목은 이름 (예: '기타')와 같은 경우는 해당하지 않습니다.
name
string
이 인터넷 서비스 제공업체의 이름입니다.
secondary_criteria_id
integer
항목을 식별하는 데 사용할 수 있는 대체 ID(선택사항)입니다.
테이블 AppCollection
개
필드 이름 유형 설명
id
Numeric Id
이 앱 컬렉션의 고유 키입니다.
name
string
이 앱 모음의 이름입니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스 에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책 을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-11-15(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2024-11-15(UTC)"],[[["Entity Read Files, providing data on advertisers, campaigns, and other entities, will be sunset on October 31, 2024, requiring migration to the Display & Video 360 API."],["Shared data types like `Numeric Id`, `Enum`, `Time`, and custom types like `Budget` and `FrequencyCap` are used across various entities to represent specific attributes."],["Data is organized into tables like `Advertiser`, `Campaign`, `LineItem`, and `Creative`, each containing specific fields relevant to their respective entities."],["Tables are interconnected via joinable fields, enabling linking and analysis of data across entities, such as joining `Advertiser` and `Campaign` using `advertiser_id`."],["The `InventorySource` table provides details about ad inventory, including its source, accessibility for advertisers, and associated costs."]]],["Key data elements include numerical IDs for entities, with non-unique values across different types. Files omit null scalars and empty arrays. Time is recorded as Unix timestamps. Currency is measured in micros. Percentages are in millis. Entity files contain common data like IDs, names, and statuses. Budget settings specify timeframes, impression caps, spending, and pacing. Partner costs and revenue models define fees, markup percentages, and billing. Targeting information involves criteria, exclusions, and unions for inventory sources, geo-locations, devices, and more. Entity Read files are to be replaced by Display & Video 360 API.\n"]]