Формат файлов чтения объектов — V2

Общие типы

Эти типы определяют вложенные поля в некоторых таблицах; эти поля не имеют собственных таблиц.

Тип Numeric Id

Скаляр Описание
integer Числовой идентификационный номер, используемый в качестве идентификатора объектов. Идентификаторы не следует рассматривать как универсально уникальные. Например, для кампании может использоваться одно и то же значение идентификатора, которое также используется для пикселя.

Тип Enum

Скаляр Описание
integer Перечисление нескольких возможных вариантов. Различные параметры более подробно описаны в родительском типе.

Тип Time

Скаляр Описание
integer Unix-время в микросекундах (1/1 000 000 секунды), например 1330403779608570, соответствует вторнику, 28 февраля 2012 г., 04:36:19.608570.

Тип Currency Micro

Скаляр Описание
integer Сумма в микромах (1/1 000 000 денежной единицы), специфичная для валюты. Например, если валютой является евро, 75000000 будет означать 75 евро, а если валютой является доллар США, 250000 будет означать 0,25 доллара США. Конверсия в долларовые суммы или обратно невозможна.

Percentage Milli

Скаляр Описание
integer Процент указывается в миллисах (1/1000 процента), например 100 означает 0,1%.

Тип FileSummary

Имя поля Тип Описание
name string Имя файла файла (не включая имя сегмента или каталога).
num_records integer Количество объектов в файле.
version integer Основной номер версии файла. Это число может измениться, если в будущем будут созданы новые версии формата данных объекта.

Тип EntityCommonData

Имя поля Тип Описание
id Numeric Id Уникальный идентификатор в каждом типе объекта. Например, для объектов-партнеров этот идентификатор будет идентификатором партнера, для рекламодателей — идентификатором рекламодателя и т. д.
name string Видимое в пользовательском интерфейсе имя сущности.
active boolean Статус, установленный пользователем: объект может не обслуживаться по другим причинам, например, из-за исчерпания бюджета, выхода из строя и т. д.
integration_code string Код интеграции, установленный пользователем

Тип ExchangeSettings

Имя поля Тип Описание
exchange_id Numeric Id Идентификатор обмена. Возможность присоединения с помощью SupportedExchange .id
seat_id string Идентификатор места для обмена
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 . Это идентификатор объекта в пространстве аудитора.

Тип 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 , то значение 6 для time_range составит 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 Комиссия за тысячу показов 5 в микро валюте рекламодателя.
media_fee_percent_1_millis integer Плата за рекламу 1 в Percentage Milli
media_fee_percent_2_millis integer Плата за рекламу 2 в Percentage Milli
media_fee_percent_3_millis integer Плата за рекламу 3 в Percentage Milli
media_fee_percent_4_millis integer Плата за рекламу 4 в Percentage Milli
media_fee_percent_5_millis integer Плата за рекламу 5 в Percentage Milli
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 Идентификатор пикселя отслеживания. Обратите внимание, что два CostTrackingPixel могут иметь один и тот же pixel_id но иметь разные значения окна просмотра или клика.

Это значение можно объединить с Pixel .common_data.id .
view_window_minutes integer Количество минут, в течение которых следует искать конверсии после просмотра.
click_window_minutes integer Количество минут, в течение которых следует искать конверсии после клика.
floodlight_activity_id Числовой идентификатор Идентификаторы действий Floodlight в CM. Это значение можно объединить с 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,0 Мбит/с и выше).
2=DIALUP (56 кбит/с и медленнее).
3=UNKNOWN_CONNECTION_SPEED
4=EDGE (Расширенные данные для эволюции GSM (2G). 57 кбит/с и быстрее).
5=UMT (Универсальная система мобильной связи (3G). 384 кбит/с и выше).
6=DSL (цифровая абонентская линия. 768 кбит/с и выше).
7=HSDPA (высокоскоростной пакетный доступ по нисходящей линии связи (3,5G). 1,8 Мбит/с и выше).

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.

Время окончания:
Минуты с полуночи, разделенные на 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] Массив типов Target для вертикалей страниц AdExchange . Target .criteria_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

Имя поля Тип Описание
file [FileSummary] Массив из нуля или более записей FileSummary . Если этот массив пуст, значит, в эту дату не было создано никаких данных.

Тип UserListAdvertiserPricing

Имя поля Тип Описание
pricing UserListPricing
advertiser_id Numeric Id

Тип UserListPricing

Имя поля Тип Описание
cost_type string
currency_code string Трехбуквенный код валюты ISO 4217, например USD для долларов США.
cost_micros Currency Micro

Частные столы

Таблица Partner

Имя поля Тип Описание
common_data EntityCommonData Содержит общие данные об этом партнере, такие как имя и идентификатор.
currency_code string Трехбуквенный код валюты ISO 4217, например USD для долларов США.
exchange_settings [ExchangeSettings] Массив типов ExchangeSettings , содержащий такую ​​информацию, как идентификаторы мест. Будут присутствовать только включенные биржи.
default_partner_costs PartnerCosts Содержит информацию о расходах по умолчанию для этого партнера.
default_partner_revenue_model PartnerRevenueModel Содержит информацию о модели дохода по умолчанию для этого партнера.
default_target_list TargetList Содержит параметры таргетинга по умолчанию для партнера. В настоящее время здесь поддерживается только геотаргетинг по умолчанию.

Таблица Advertiser

Имя поля Тип Описание
common_data EntityCommonData Содержит общие данные об этом рекламодателе, такие как имя и идентификатор.
partner_id Numeric Id Идентификатор родительского объекта-партнера. Можно присоединиться с помощью Partner .common_data.id .
currency_code string Трехбуквенный код валюты ISO 4217, например USD для долларов США.
timezone_code string Канонический код часового пояса, например «Америка/Лос-Анджелес». Если для 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. Это значение будет отсутствовать, если для dcm_configuration установлено значение NONE .
dcm_advertiser_id Numeric Id Идентификатор рекламодателя CM360. Это значение будет отсутствовать, если для 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 .

Таблица Campaign

Имя поля Тип Описание
common_data EntityCommonData Содержит общие данные об этой кампании, такие как имя и идентификатор.
advertiser_id Numeric 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

Имя поля Тип Описание
common_data EntityCommonData
advertiser_id Numeric Id Идентификатор родительского объекта рекламодателя. Можно присоединиться с помощью Advertiser .common_data.id .
campaign_id Numeric Id Идентификатор родительского объекта кампании.
overall_budget Budget Общий бюджет этого заказа на размещение. Включает время начала и время окончания.
scheduled_segments [Budget] Содержит все запланированные сегменты бюджета. Этот массив может быть пустым или вообще отсутствовать.
frequency_cap FrequencyCap Ограничение частоты показов активно для этого заказа на размещение. Это значение будет отсутствовать, если не установлено ограничение частоты показов.
default_partner_costs PartnerCosts
default_target_list TargetList

Таблица 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 Идентификатор родительского объекта заказа на размещение. Можно присоединиться с помощью InsertionOrder .common_data.id .
creative_ids [Numeric Id] Массив объявлений, назначенных этой позиции. Можно присоединиться с помощью Creative .common_data.id .
max_cpm_advertiser_micros integer Максимальное значение цены за тысячу показов в микро валюте рекламодателя.
performance_goal Enum 0=NONE (цена за тысячу показов в виртуальной реальности отключена)
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 Целевая цена за тысячу показов в видимой области экрана в микровалюте рекламодателя. Это значение будет отсутствовать, если для performance_goal установлено значение NONE .
partner_revenue_model PartnerRevenueModel Партнерская модель дохода, используемая для этой позиции.
cost_tracking_pixels [CostTrackingPixel] Массив CostTrackingPixels, назначенный для отслеживания этой позиции.
Budget Budget Общий бюджет этой позиции. Включает время начала и время окончания.
frequency_cap FrequencyCap Ограничение частоты показов активно для этой позиции. Это значение будет отсутствовать, если не установлено ограничение частоты показов.
partner_costs PartnerCosts
target_list TargetList Содержит информацию о таргетинге, действующем для этой позиции.

Creative стол

Имя поля Тип Описание
common_data EntityCommonData
advertiser_id Numeric Id Идентификатор родительского объекта рекламодателя. Можно присоединиться с помощью Advertiser .common_data.id .
dcm_placement_id Numeric Id Идентификатор места размещения CM360, связанный с этим объявлением.
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 Идентификатор родительского объекта рекламодателя. Можно присоединиться с помощью Advertiser .common_data.id .
partner_id Numeric Id Идентификатор родительского объекта-партнера. Можно присоединиться с помощью Partner .common_data.id .
dcm_floodlight_id Numeric Id Идентификатор Floodlight DFA, связанный с этим пикселем.
allow_google_redirect boolean
allow_rm_redirect boolean Если установлено значение true пиксель будет доступен для перенаправления в/из 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 Идентификатор родительского объекта рекламодателя. Можно присоединиться с помощью Advertiser .common_data.id .
partner_id Numeric Id Идентификатор объекта управляющего партнера родительского рекламодателя. Можно присоединиться с помощью Partner .common_data.id .
remarketing_enabled boolean Если установлено значение true , это действие будет разрешено для использования в таргетинге.
ssl_required boolean Если установлено значение true , теги должны соответствовать требованиям.

Таблица InventorySource

Имя поля Тип Описание
id Numeric Id Уникальный ключ для источника инвентаря.
unclassified boolean Если установлено значение true , будут включены все несекретные ресурсы.
inventory_name string Имя источника инвентаря, отображаемое в пользовательском интерфейсе. Это поле может отсутствовать. Если inventory_name отсутствует, а unclassified равно true, оно относится к неклассифицированному инвентарю биржи. Если он отсутствует и unclassified имеет значение false, источником запасов является запас на уровне биржи.
exchange_id Numeric Id Идентификатор биржи, на которой доступен этот источник инвентаря. Можно присоединиться с помощью SupportedExchange .id .
accessing_advertisers [Numeric Id] Массив идентификаторов рекламодателей, которые можно объединить с Advertiser .common_data.id и которым разрешено использовать этот источник инвентаря.

Примечание. Если источник инвентаря доступен ВСЕМ рекламодателям, это поле не будет присутствовать.

external_id string Внешний идентификатор, присвоенный этому источнику ресурсов и определяемый биржей. Обычно его называют идентификатором сделки или продавца. Это поле может отсутствовать.
min_cpm_micros integer Эффективная минимальная цена этого источника запасов в микровалютах.
min_cpm_currency_code string Трехбуквенный код валюты ISO 4217, используемый для min_cpm_micros .

Таблица UserList

Имя поля Тип Описание
id Numeric Id Уникальный ключ для списка пользователей.
name string Имя списка пользователей, отображаемое в пользовательском интерфейсе.
data_partner_id Numeric Id Возможность присоединения с помощью DataPartner .id . Это поле задается только для сторонних списков пользователей.
accessing_advertisers [Numeric Id] Массив идентификаторов рекламодателей, объединяемых с помощью Advertiser .common_data.id , которым разрешено использовать этот список пользователей.

Примечание. Если список пользователей доступен ВСЕМ рекламодателям, это поле не будет присутствовать.

partner_pricing UserListPricing Типом цены всегда будет цена за тысячу показов, а кодом валюты всегда будет доллар США.
advertiser_pricings [UserListAdvertiserPricing] Типом цены всегда будет цена за тысячу показов, а кодом валюты всегда будет доллар США.

Таблица CustomAffinity

Имя поля Тип Описание
id Numeric Id Уникальный ключ для пользовательской привязки.
name string Имя пользовательской привязки, отображаемое в пользовательском интерфейсе.
description string Описание пользовательской привязки, отображаемое в пользовательском интерфейсе.
advertiser_id Numeric Id Идентификатор родительского объекта рекламодателя. Можно присоединиться с помощью Advertiser .common_data.id .

Таблица UniversalChannel

Имя поля Тип Описание
id Numeric Id Уникальный ключ для канала.
name string Имя канала, отображаемое в пользовательском интерфейсе.
site_ids [Numeric Id] Массив, содержащий идентификаторы UniversalSite в этом канале. Можно присоединиться с помощью UniversalSite .id .
accessing_advertisers [Numeric Id] Массив идентификаторов рекламодателей, которые можно объединить с Advertiser .common_data.id , которым разрешено использовать этот канал.

Примечание. Если канал доступен ВСЕМ рекламодателям, это поле не будет присутствовать.

is_deleted boolean Если установлено true новые позиции не смогут настроить таргетинг на этот канал, однако существующие позиции, уже ориентированные на этот канал, продолжат это делать.
is_brand_safe_channel boolean Если установлено true этот канал можно использовать для фильтрации безопасности бренда. В настоящее время это true только для четырех встроенных уровней безопасности бренда.

Таблица NegativeKeywordList

Имя поля Тип Описание
id Numeric Id Уникальный ключ для списка минус-слов.
name string Название списка минус-слов, отображаемое в пользовательском интерфейсе.
advertiser_id Numeric Id Идентификатор родительского объекта рекламодателя. Можно присоединиться с помощью Advertiser .common_data.id .

Общественные столы

SupportedExchange таблица Exchange

Имя поля Тип Описание
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 Сопоставление универсального идентификатора сайта с идентификаторами веб-размещения.
placementId Numeric Id URL-адрес или название веб-размещения, например google.com или Google Unclassified .

Таблица GeoLocation

Имя поля Тип Описание
id Numeric Id Уникальный ключ для географического местоположения.
canonical_name string Строка местоположения и ее родителей, объединенная запятыми. Пример: «Сиэтл, Вашингтон, США».
geo_name string Название места. Пример: «Сиэтл».
country_code string Код страны ISO-3166 альфа-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 Если это правда, этот критерий распространяется только на мобильные устройства. Если значение false, эта запись охватывает только немобильные устройства, даже если ее название (например, «Другое») не указывает на это.
name string Знакомое название Device Criteria.
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 Если это правда, этот критерий распространяется только на мобильные устройства. Если значение false, эта запись охватывает только немобильные устройства, даже если ее название (например, «Другое») не указывает на это.
name string Знакомое название браузера, например Safari 5 . Он не включает полную строку пользовательского агента.

Таблица Isp

Имя поля Тип Описание
id Numeric Id Уникальный ключ для этого интернет-провайдера.
is_mobile boolean Если это правда, этот критерий распространяется только на мобильные устройства. Если значение false, эта запись охватывает только немобильные устройства, даже если ее название (например, «Другое») не указывает на это.
name string Имя этого интернет-провайдера.
secondary_criteria_id integer Необязательный альтернативный идентификатор, который можно использовать для идентификации объекта.

Таблица AppCollection

Имя поля Тип Описание
id Numeric Id Уникальный ключ для этой коллекции приложений.
name string Название этой коллекции приложений.