Format plików odczytu elementu – wersja 2

Udostępnione typy

Te typy definiują pola zagnieżdżone w niektórych tabelach – nie mają one własnych tabel.

Typ: Numeric Id

SkalarnyOpis
integerLiczbowy numer identyfikacyjny używany jako identyfikator podmiotów. Identyfikatory nie powinny być traktowane jako uniwersalne. Na przykład mogą one być takie same w przypadku kampanii, która jest też używana w przypadku Pixela.

Typ: Enum

SkalarnyOpis
integerLista wielu możliwych opcji. Różne opcje są szczegółowo opisane w typie nadrzędnym.

Typ: Time

SkalarnyOpis
integerCzas uniksowy w mikrosekundach (1/1 000 000 sekund), na przykład 1330403779608570 oznacza wtorek 28 lutego 2012 r. o 4:36:19.608570.

Typ: Currency Micro

SkalarnyOpis
integerKwota w mikro (1/1 000 000 jednostki waluty), np.jeśli walutą jest EUR,75000000 oznacza 75 euro, a jeśli waluta to USD, 250000 oznacza 0, 25 USD. Nie można przeliczać kwot na kwoty w dolarach ani z nich.

Typ: Percentage Milli

SkalarnyOpis
integerWartość procentowa wyrażona w milisekundach (1/1000 procenta), na przykład 100 oznacza 0,1%.

Typ: FileSummary

Nazwa polaTypOpis
namestringNazwa pliku (bez nazwy zasobnika ani katalogu).
num_recordsintegerLiczba encji w pliku.
versionintegerNumer wersji głównej pliku. Ta liczba może się zmienić, jeśli w przyszłości będą tworzone nowe wersje tego formatu.

Typ: EntityCommonData

Nazwa polaTypOpis
idNumeric IdUnikalny identyfikator w ramach każdego typu elementu – na przykład w przypadku jednostek partnera będzie to identyfikator partnera, w przypadku reklamodawców – identyfikator reklamodawcy itd.
namestringNazwa elementu widoczna w interfejsie.
activebooleanStan ustawiony przez użytkownika – element może nie wyświetlać z innych powodów, takich jak wyczerpanie budżetu, brak wyświetlania itp.
integration_codestringKod integracji ustawiony przez użytkownika

Typ: ExchangeSettings

Nazwa polaTypOpis
exchange_idNumeric IdIdentyfikator giełdy. Można je łączyć za pomocą identyfikatora SupportedExchange.id
seat_idstringIdentyfikator stanowiska na giełdzie
seat_user_namestringNazwa użytkownika związana z tym stanowiskiem (dotyczy tylko stanowisk Right Media nie RTB).

Typ: ApprovalStatus

Nazwa polaTypOpis
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
feedbackstringOpinia od audytora, która może zawierać dodatkowe informacje, takie jak przyczyny odrzucenia.
sync_timeTimeData ostatniej synchronizacji elementu z: auditor
external_idNumeric IdPole wypełnione tylko wtedy, gdy auditor ma wartość APPNEXUS, APPNEXUS_MICROSOFT lub RIGHT_MEDIA_NON_RTB. Jest to identyfikator podmiotu w obszarze audytora.

Typ: Budget

Nazwa polaTypOpis
start_time_usecTimeCzas rozpoczęcia okresu budżetowego.
end_time_usecTimeGodzina zakończenia okresu budżetowego.
max_impressionsintegerMaksymalna liczba wyświetleń przy tym budżecie. Jeśli brakuje tego pola, oznacza to nieograniczony budżet wyświetleń.
max_spend_advertiser_microsintegerMaksymalne wydatki w tym budżecie (w mikro walucie reklamodawcy). Jeśli brakuje tego pola, oznacza to, że budżet jest z nieograniczonymi wydatkami.
pacing_typeEnum0=FLIGHT
1=DAILY
pacing_max_impressionsintegerMaksymalna liczba wyświetleń na interwał częstotliwości ustawiona w polu pacing_type. Jeśli to pole nie jest wypełnione, liczba wyświetleń nie jest ograniczona.
pacing_max_spend_advertiser_microsintegerMaksymalne wydatki (w mikro walucie reklamodawcy) na przedział tempa ustawiony przez pacing_type. Jeśli go brakuje, wydatki nie są ograniczone.
pacing_distributionEnum0=ASAP
1=EVEN
2=AHEAD

Typ: FrequencyCap

Nazwa polaTypOpis
max_impressionsintegerMaksymalna liczba wyświetleń w każdym przedziale czasu ograniczenia.
time_unitEnumJednostka czasu:
0=MINUTE
1=HOUR
2=DAY
3=WEEK
4=MONTH
5=LIFE_TIME
time_rangeintegerLiczba time_units, np. jeśli time_unit to 1, to wartość 6 dla time_range wynosi 6 godzin.

Typ: PartnerCosts

Nazwa polaTypOpis
cpm_fee_1_advertiser_microsintegerOpłata za CPM 1 w walucie reklamodawcy (mikro).
cpm_fee_2_advertiser_microsintegerOpłata za CPM 2 w walucie reklamodawcy (mikro).
cpm_fee_3_advertiser_microsintegerOpłata za CPM 3 w walucie reklamodawcy (mikro).
cpm_fee_4_advertiser_microsintegerOpłata za CPM 4 w walucie reklamodawcy (mikro).
cpm_fee_5_advertiser_microsintegerOpłata za CPM 5 w walucie reklamodawcy (mikro).
media_fee_percent_1_millisintegerOpłata za media 1 w Percentage Milli
media_fee_percent_2_millisintegerOpłata za media 2 w: Percentage Milli
media_fee_percent_3_millisintegerOpłata za media 3 w Percentage Milli
media_fee_percent_4_millisintegerOpłata za media 4 w: Percentage Milli
media_fee_percent_5_millisintegerOpłata za media 5 – Percentage Milli
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 reprezentuje opłatę dla agencyjnej platformy zakupowej.
cpm_fee_2_cost_typeEnumTaka sama jak w przypadku cpm_fee_1_cost_type.
cpm_fee_3_cost_typeEnumTaka sama jak w przypadku cpm_fee_1_cost_type.
cpm_fee_4_cost_typeEnumTaka sama jak w przypadku cpm_fee_1_cost_type.
cpm_fee_5_cost_typeEnumTaka sama jak w przypadku cpm_fee_1_cost_type.
media_fee_percent_1_cost_typeEnumTaka sama jak w przypadku cpm_fee_1_cost_type.
media_fee_percent_2_cost_typeEnumTaka sama jak w przypadku cpm_fee_1_cost_type.
media_fee_percent_3_cost_typeEnumTaka sama jak w przypadku cpm_fee_1_cost_type.
media_fee_percent_4_cost_typeEnumTaka sama jak w przypadku cpm_fee_1_cost_type.
media_fee_percent_5_cost_typeEnumTaka sama jak w przypadku cpm_fee_1_cost_type.
cpm_fee_1_bill_to_typeEnum0=DEFAULT_BILL_TO_TYPE
1=INVITE_MEDIA
2=PARTNER
cpm_fee_2_bill_to_typeEnumTaka sama jak w przypadku cpm_fee_1_bill_to_type.
cpm_fee_3_bill_to_typeEnumTaka sama jak w przypadku cpm_fee_1_bill_to_type.
cpm_fee_4_bill_to_typeEnumTaka sama jak w przypadku cpm_fee_1_bill_to_type.
cpm_fee_5_bill_to_typeEnumTaka sama jak w przypadku cpm_fee_1_bill_to_type.
media_fee_percent_1_bill_to_typeEnumTaka sama jak w przypadku cpm_fee_1_bill_to_type.
media_fee_percent_2_bill_to_typeEnumTaka sama jak w przypadku cpm_fee_1_bill_to_type.
media_fee_percent_3_bill_to_typeEnumTaka sama jak w przypadku cpm_fee_1_bill_to_type.
media_fee_percent_4_bill_to_typeEnumTaka sama jak w przypadku cpm_fee_1_bill_to_type.
media_fee_percent_5_bill_to_typeEnumTaka sama jak w przypadku cpm_fee_1_bill_to_type.

Typ: PartnerRevenueModel

Nazwa polaTypOpis
typeEnum0=CPM
1=MEDIA_COST_MARKUP
2=TOTAL_MEDIA_COST_MARKUP
amount_advertiser_microsintegerKwota przychodów w bieżącej części budżetu reklamodawcy. Ta wartość jest ustawiana tylko wtedy, gdy typ to CPM.
media_cost_markup_percent_millisintegerMarża procentowa przychodów w Percentage Milli. Tę wartość ustawia się tylko wtedy, gdy typ to MEDIA_COST_MARKUP lub TOTAL_MEDIA_COST_MARKUP.
post_view_conversion_tracking_fractionfloatOdsetek konwersji po obejrzeniu na potrzeby śledzenia konwersji. Jeśli wynosi 0, uwzględniane są tylko konwersje po kliknięciu, a jeśli wartość 1,0 są śledzone, wszystkie konwersje są zliczane.

Typ: CostTrackingPixel

Nazwa polaTypOpis
pixel_idNumeric IdIdentyfikator piksela śledzącego – pamiętaj, że 2 elementy CostTrackingPixel mogą mieć ten sam parametr pixel_id, ale różne wartości widoku lub okna kliknięcia.

Tę wartość można złączyć z parametrem Pixel.common_data.id.
view_window_minutesintegerLiczba minut, przez które mają być sprawdzane konwersje po obejrzeniu.
click_window_minutesintegerLiczba minut, w których sprawdzane są konwersje po kliknięciu.
floodlight_activity_idIdentyfikator liczbowyIdentyfikatory aktywności Floodlight CM. Tę wartość można złączyć z polem Pixel.dcm_floodlight_id.

Typ: Target

Nazwa polaTypOpis
criteria_idNumeric IdMożna ją łączyć z inną tabelą w zależności od typu zdefiniowanego w zasadzie TargetList. Tej wartości może brakować.
parameterstringDodatkowy parametr, którego definicja zależy od typu określonego w polu TargetList. Tej wartości może brakować.
excludedbooleanGdy true oznacza, że cel jest wykluczony. Brak wartości oznacza false.

Typ: TargetUnion

Nazwa polaTypOpis
union[Target]Tablica typów Target reprezentująca sumę celów.
excludedbooleanGdy true oznacza, że suma docelowa jest wykluczona. Brak wartości oznacza false.

Typ: TargetList

Nazwa polaTypOpis
inventory_sources [Target]Tablica Target typów dla źródeł zasobów reklamowych. Element Target.criteria_id można złączać z InventorySource.id, a Target.parameter jest niezdefiniowany.
geo_locations [Target] Tablica typów Target dla lokalizacji geograficznych. Element Target.criteria_id można złączać z GeoLocation.id, a Target.parameter jest niezdefiniowany.
ad_position Target Wartość Target wskazująca pozycję reklamy na stronie wydawcy. Wartości Target.criteria_id
0=ALL_POSITIONS
1=ABOVE_THE_FOLD
2=BELOW_THE_FOLD
3=UNKNOWN_POSITION

Target.parameter jest nieokreślone.
net_speed Target Wartość Target wskazująca szybkość sieci.
Wartości parametru Target.criteria_id to:
0=ALL_CONNECTION_SPEEDS
1=BROADBAND (2,0 Mb/s i szybsza).
2=DIALUP (56 kb/s i wolniejsze).
3=UNKNOWN_CONNECTION_SPEED
4=EDGE (Extended Data for GSM Evolution (2G). 57 kb/s i szybciej).
5=UMT (Universal Mobile Telecom System (3G). 384 kb/s i szybsze).
6=DSL (cyfrowa linia subskrypcyjna, 768 kb/s i szybsze).
7=HSDPA (szybki dostęp do pakietów w ramach linku pobierania (3,5G). 1,8 mpbs i szybsze).

Target.parameter jest nieokreślony.
browsers TargetUnion Typ TargetUnion w przypadku przeglądarek. Element Target.criteria_id można złączać z Browser.id, a Target.parameter jest niezdefiniowany.
device_criteria [Target]Typy kryteriów urządzeń: Array of Target. Element Target.criteria_id można złączać z DeviceCriteria.id, a Target.parameter jest niezdefiniowany.
languages TargetUnionTyp TargetUnion dla języka. Element Target.criteria_id można złączać z Language.id, a Target.parameter jest niezdefiniowany.
day_parting TargetUnionTyp TargetUnion uwzględnia pory dnia. Target.criteria_id ma 6 cyfr: (TimeZone)(DayOfWeek)(StartTime)(EndTime)

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


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


Godzina rozpoczęcia:
Liczba minut od północy (liczba minut od północy podzielona przez 15). Zakres od 0 do 95.

Czas zakończenia:
liczba minut od północy podzielona przez 15. Zakres od 1 do 96.

Na przykład wartość 200380 oznacza poniedziałek od 00:45 do 20:00 czasu pacyficznego.

Target.parameter jest nieokreślona.
audience_intersect [TargetUnion]Tablica typów TargetUnion na potrzeby różnych grup odbiorców, np.
[{“union”: [A, B]},
 {“union”: [C, D]},
 {“union”: [E, F],
 “excluded”: true}]
Oznaczałaby „(A OR B) AND (C OR D) AND NOT (E OR F)”.

Target.criteria_id można złączać z UserList.id, a Target.parameter to wartość czasu od poprzedniej wizyty w pikselu w mikrosekundach. Jeśli jej brak, oznacza to, że kierujesz reklamy na wszystkich odbiorców.
keywords[Target]Tablica Target typów słów kluczowych. Target.criteria_id jest nieokreślone, a Target.parameter to jedno słowo kluczowe.
kct_include_uncrawled_sitesbooleanFlaga określająca, czy w KCT powinny być uwzględnione niezindeksowane witryny.
page_categories[Target]Tablica typów Target dla branż stron AdExchange. Target.criteria_id to liczbowy identyfikator branży, a Target.parameter jest niezdefiniowany.
universal_channels[Target]Tablica typów kanałów (Target). Element Target.criteria_id można złączać z UniversalChannel.id, a Target.parameter jest niezdefiniowany.
sites[Target] Tablica typów Target witryn. Element Target.criteria_id można złączyć z elementem UniversalSite.id lub nie jest ustawiony, jeśli witryna nie znajduje się w elemencie UniversalSite. Target.parameter to witryna taka jak google.com, ale niekoniecznie należy ją znaleźć w usłudze UniversalSite.
ispsTargetUnionTyp TargetUnion dla dostawcy usług internetowych. Element Target.criteria_id można złączać z ISP.id, a Target.parameter jest niezdefiniowany.

Typ: SummaryFile

Nazwa polaTypOpis
file[FileSummary]Tablica z zerem lub większą liczbą wpisów FileSummary. Jeśli tablica jest pusta, w danym dniu nie zostały wygenerowane żadne dane.

Typ: UserListAdvertiserPricing

Nazwa polaTypOpis
pricingUserListPricing
advertiser_idNumeric Id

Typ: UserListPricing

Nazwa polaTypOpis
cost_typestring
currency_codestring3-literowy kod waluty w standardzie ISO 4217, np. PLN w przypadku złotego.
cost_microsCurrency Micro

Tabele prywatne

Partner tabela

Nazwa polaTypOpis
common_dataEntityCommonDataZawiera wspólne dane dotyczące tego partnera, takie jak nazwa i identyfikator.
currency_codestringTrzyliterowy kod waluty w standardzie ISO 4217, np. USD w przypadku dolarów amerykańskich.
exchange_settings[ExchangeSettings]Tablica typów ExchangeSettings zawierająca informacje takie jak ich identyfikatory miejsc. Widoczne będą tylko włączone giełdy.
default_partner_costsPartnerCostsZawiera informacje o kosztach awarii w przypadku tego partnera.
default_partner_revenue_modelPartnerRevenueModelZawiera informacje o domyślnym modelu rozliczeniowym tego partnera.
default_target_listTargetListZawiera domyślne opcje kierowania partnera. Obecnie obsługiwane jest tu tylko domyślne kierowanie geograficzne.

Advertiser tabela

Nazwa polaTypOpis
common_dataEntityCommonDataZawiera wspólne dane dotyczące tego reklamodawcy, np. nazwę i identyfikator.
partner_idNumeric IdIdentyfikator obiektu partnera nadrzędnego. Można je dołączyć do grupy Partner.common_data.id.
currency_codestringTrzyliterowy kod waluty w standardzie ISO 4217, np. USD w przypadku dolarów amerykańskich.
timezone_codestringKanoniczny kod strefy czasowej, np. „Ameryka/Los_Angeles”. Jeśli dfa_configuration ma wartość NORMAL lub HYBRID, ta wartość jest taka sama jak strefa czasowa powiązanego reklamodawcy DFA.
landing_page_urlstringDomyślny adres URL strony docelowej.
available_channel_ids[integer]Tablica liczb całkowitych zawierających dostępne kanały powiązane z tym reklamodawcą. Można je dołączyć do grupy UniversalChannel.id.
blacklist_channel_id[integer]Tablica liczb całkowitych zawierających kanały na czarnej liście reklamodawcy. Można je dołączyć do grupy UniversalChannel.id.
dcm_configurationEnum0=NONE
1=NORMAL
2=HYBRID
dcm_network_idNumeric IdIdentyfikator sieci CM360. Tej wartości nie będzie, jeśli dcm_configuration ma wartość NONE.
dcm_advertiser_idNumeric IdIdentyfikator reklamodawcy CM360. Tej wartości nie będzie, jeśli dcm_configuration ma wartość NONE.
dcm_floodlight_group_idNumeric IdTej wartości nie będzie, jeśli dcm_configuration ma wartość NONE.
dcm_syncable_site_ids[Numeric Id]Tablica typów Numeric Id dla każdej synchronizowanej witryny tego reklamodawcy.
enable_oba_tagsbooleanTagi OBA są włączone, gdy ma wartość true.

Campaign tabela

Nazwa polaTypOpis
common_dataEntityCommonDataZawiera wspólne dane o tej kampanii, takie jak nazwa i identyfikator.
advertiser_idNumeric IdIdentyfikator nadrzędnego obiektu reklamodawcy. Można dołączyć do spotkania z: Advertiser.common_data.id
budgetBudgetPlanowany budżet kampanii. Obejmuje godzinę rozpoczęcia i zakończenia.
frequency_capFrequencyCapLimit wyświetleń na użytkownika aktywny w tej kampanii. Tej wartości nie będzie, jeśli nie ustawiono limitu wyświetleń na użytkownika.
default_target_listTargetListZawiera informacje o kierowaniu obowiązującym w tej kampanii.
uses_video_creativesbooleanJeśli zasada ma wartość Prawda, zamówienia reklamowe wideo będą zalecane.
uses_display_creativesbooleanJeśli ma wartość Prawda, zalecane będą displayowe zamówienia reklamowe.
uses_audio_creativesbooleanJeśli zasada ma wartość Prawda, zamówienia reklamowe audio będą zalecane.
objectiveEnum Wartości to:
1 = BRAND_AWARENESS
2 = ONLINE_ACTION
3 = OFFLINE_ACTION
4 = APP_INSTALL
metricEnum Główny wskaźnik wydajności. Użyj tego pola, aby śledzić podstawowe dane służące do oceny powodzenia kampanii. Możliwe wartości:
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_descriptionStringJeśli dane mają wartość OTHER, jest to krótki opis danych.
metric_amount_microsintegerDocelowa ilość danych w mikro.

InsertionOrder tabela

Nazwa polaTypOpis
common_dataEntityCommonData
advertiser_idNumeric IdIdentyfikator nadrzędnego obiektu reklamodawcy. Można je dołączyć do grupy Advertiser.common_data.id.
campaign_idNumeric IdIdentyfikator nadrzędnego obiektu kampanii.
overall_budgetBudgetCałkowity budżet tego zamówienia reklamowego. Obejmuje czas rozpoczęcia i zakończenia.
scheduled_segments[Budget]Zawiera zaplanowane segmenty budżetu. Ta tablica może być pusta lub w ogóle jej nie ma.
frequency_capFrequencyCapLimit wyświetleń na użytkownika aktywny dla tego zamówienia reklamowego. Tej wartości nie będzie, jeśli nie ustawiono limitu wyświetleń na użytkownika.
default_partner_costsPartnerCosts
default_target_listTargetList

LineItem tabela

Nazwa polaTypOpis
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 Identyfikator nadrzędnego obiektu zamówienia reklamowego. Można je połączyć z: InsertionOrder.common_data.id.
creative_ids[Numeric Id]Tablica kreacji przypisanych do tego elementu zamówienia. Można je dołączyć do grupy Creative.common_data.id.
max_cpm_advertiser_microsintegerMaksymalna wartość CPM w walucie reklamodawcy (mikro).
performance_goalEnum0=NONE (vCPM jest wyłączone)
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_microsintegerCel vCPM w walucie reklamodawcy (mikro). Tej wartości nie będzie, jeśli performance_goal ma wartość NONE.
partner_revenue_modelPartnerRevenueModelModel rozliczeniowy partnera używany w tym elemencie zamówienia.
cost_tracking_pixels[CostTrackingPixel]Tablica CostTrackingPixels przypisana do śledzenia tego elementu zamówienia.
BudgetBudgetCałkowity budżet danego elementu zamówienia. Obejmuje czas rozpoczęcia i zakończenia.
frequency_capFrequencyCapLimit wyświetleń na użytkownika aktywny dla tego elementu zamówienia. Tej wartości nie będzie, jeśli nie ustawiono limitu wyświetleń na użytkownika.
partner_costsPartnerCosts
target_listTargetListZawiera informacje o kierowaniu obowiązującym w przypadku danego elementu zamówienia.

Creative tabela

Nazwa polaTypOpis
common_dataEntityCommonData
advertiser_idNumeric IdIdentyfikator nadrzędnego obiektu reklamodawcy. Można je dołączyć do grupy Advertiser.common_data.id.
dcm_placement_idNumeric IdIdentyfikator miejsca docelowego w CM360 powiązany z tą kreacją.
width_pixelsintegerSzerokość kreacji w pikselach.
height_pixelsintegerWysokość kreacji w pikselach.
approval_status[ApprovalStatus]Tablica zawierająca obiekty ApprovalStatus reprezentujące stan kreacji na giełdach, które je zatwierdzają.
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 tabela

Nazwa polaTypOpis
common_dataEntityCommonData
advertiser_idNumeric IdIdentyfikator nadrzędnego obiektu reklamodawcy. Można je dołączyć do grupy Advertiser.common_data.id.
partner_idNumeric IdIdentyfikator obiektu partnera nadrzędnego. Można je dołączyć do grupy Partner.common_data.id.
dcm_floodlight_idNumeric IdIdentyfikator Floodlight w usłudze DFA powiązany z tym pikselem.
allow_google_redirectboolean
allow_rm_redirectbooleanGdy ustawisz wartość true, piksel będzie mógł być kodowany do/z Right Media.
remarketing_enabledbooleanGdy ustawisz wartość true, piksel będzie mógł być używany do kierowania. Ta wartość będzie występować tylko wtedy, gdy dfa_configuration reklamodawcy nadrzędnego ma wartość NONE.
is_securebooleanGdy ustawisz wartość true, piksel będzie korzystać z HTTPS. Ta wartość będzie występować tylko wtedy, gdy dfa_configuration reklamodawcy nadrzędnego ma wartość NONE.

Floodlight Activity tabela

Nazwa polaTypOpis
common_dataEntityCommonData
advertiser_idNumeric IdIdentyfikator nadrzędnego obiektu reklamodawcy. Można je dołączyć do grupy Advertiser.common_data.id.
partner_idNumeric IdIdentyfikator obiektu partnera zarządzającego reklamodawcy nadrzędnego. Można je dołączyć do grupy Partner.common_data.id.
remarketing_enabledbooleanJeśli ustawisz wartość true, aktywność będzie używana do kierowania.
ssl_requiredbooleanGdy ustawiona jest wartość true, tagi muszą być zgodne.

InventorySource tabela

Nazwa polaTypOpis
idNumeric IdUnikalny klucz źródła zasobów reklamowych.
unclassifiedbooleanGdy ma wartość true, uwzględniane są wszystkie niesklasyfikowane zasoby reklamowe.
inventory_namestringNazwa źródła zasobów reklamowych widoczna w interfejsie. To pole może być puste. Jeśli brak właściwości inventory_name, a zasada unclassified ma wartość prawda, odnosi się do niesklasyfikowanych zasobów reklamowych na giełdzie. Jeśli go brakuje, a atrybut unclassified ma wartość fałsz, źródłem zasobów reklamowych są zasoby reklamowe na poziomie giełdy.
exchange_idNumeric IdIdentyfikator giełdy, na której dostępne jest to źródło zasobów reklamowych. Można je dołączyć do grupy SupportedExchange.id.
accessing_advertisers[Numeric Id]Tablica identyfikatorów reklamodawców, które można połączyć z elementem Advertiser.common_data.id, ma uprawnienia do korzystania z tego źródła zasobów reklamowych.

Uwaga: jeśli źródło zasobów reklamowych jest dostępne dla WSZYSTKICH reklamodawców, to pole nie będzie widoczne.

external_idstringIdentyfikator zewnętrzny nadany danemu źródłu zasobów reklamowych i zdefiniowany przez giełdę. Zwykle nosi nazwę umowy lub identyfikatora sprzedawcy. To pole może być niedostępne.
min_cpm_microsintegerEfektywna cena minimalna tego źródła zasobów reklamowych w milionowych częściach waluty.
min_cpm_currency_codestringTrzyliterowy kod waluty w formacie ISO 4217 używany w polu min_cpm_micros.

UserList tabela

Nazwa polaTypOpis
idNumeric IdUnikalny klucz listy użytkowników.
namestringNazwa listy użytkowników widoczna w interfejsie.
data_partner_idNumeric IdMożna je dołączyć do grupy DataPartner.id. To pole jest skonfigurowane tylko dla list użytkowników dostarczanych przez inne firmy.
accessing_advertisers[Numeric Id]Tablica identyfikatorów reklamodawców, które można połączyć z elementem Advertiser.common_data.id, z uprawnieniami do korzystania z tej listy użytkowników.

Uwaga: jeśli lista użytkowników jest dostępna dla WSZYSTKICH reklamodawców, to pole nie jest obecne.

partner_pricingUserListPricingTypem kosztu będzie zawsze CPM, a kod waluty zawsze USD.
advertiser_pricings[UserListAdvertiserPricing]Typem kosztu będzie zawsze CPM, a kod waluty zawsze USD.

CustomAffinity tabela

Nazwa polaTypOpis
id Numeric Id Unikalny klucz niestandardowego podobieństwa.
name string Nazwa niestandardowej grupy odbiorców o podobnych zainteresowaniach widoczna w interfejsie.
description string Opis niestandardowego podobieństwa widoczny w interfejsie.
advertiser_id Numeric Id Identyfikator nadrzędnego obiektu reklamodawcy. Można je dołączyć do grupy Advertiser.common_data.id.

UniversalChannel tabela

Nazwa polaTypOpis
idNumeric IdUnikalny klucz dla kanału.
namestringNazwa kanału wyświetlana w interfejsie.
site_ids [Numeric Id] Tablica zawierająca identyfikatory UniversalSite w tym kanale. Można je dołączyć do grupy UniversalSite.id.
accessing_advertisers[Numeric Id]Tablica identyfikatorów reklamodawców, które można połączyć z elementem Advertiser.common_data.id, ma uprawnienia do korzystania z tego kanału.

Uwaga: jeśli kanał jest dostępny dla WSZYSTKICH reklamodawców, to pole nie jest obecne.

is_deletedbooleanGdy ustawisz wartość true, nowe elementy zamówienia nie będą mogły kierować reklam na ten kanał. Istniejące elementy zamówienia, które są już kierowane na ten kanał, nie przestaną być kierowane na ten kanał.
is_brand_safe_channelbooleanGdy ustawisz wartość true, ten kanał może być używany do filtrowania pod kątem bezpieczeństwa marki. Obecnie jest to true tylko w przypadku 4 wbudowanych warstw bezpieczeństwa marki.

NegativeKeywordList tabela

Nazwa polaTypOpis
id Numeric Id Unikalny klucz listy wykluczających słów kluczowych.
name string Nazwa listy wykluczających słów kluczowych widoczna w interfejsie.
advertiser_id Numeric Id Identyfikator nadrzędnego obiektu reklamodawcy. Można je dołączyć do grupy Advertiser.common_data.id.

Stoły publiczne

SupportedExchange tabela

Nazwa polaTypOpis
idNumeric IdUnikalny klucz giełdy.
namestringNazwa giełdy, na przykład Ad Exchange.

DataPartner tabela

Nazwa polaTypOpis
idNumeric IdUnikalny klucz dla zewnętrznego dostawcy danych.
namestringNazwa zewnętrznego dostawcy danych, np. BlueKai.

UniversalSite tabela

Nazwa polaTypOpis
idNumeric IdUnikalny klucz witryny uniwersalnej.
namestringAdres URL lub nazwa witryny, np. google.com lub Google Unclassified.

SiteIdToPlacementId tabela

Nazwa polaTypOpis
siteId Numeric Id Mapowanie z uniwersalnego identyfikatora witryny na identyfikatory internetowych miejsc docelowych.
placementId Numeric Id Adres URL lub nazwa miejsca docelowego w internecie, np. google.com lub Google Unclassified.

GeoLocation tabela

Nazwa polaTypOpis
idNumeric IdNiepowtarzalny klucz do lokalizacji geograficznej.
canonical_namestringCiąg znaków dotyczący lokalizacji i jego elementów nadrzędnych połączony przecinkami. Przykład: „Seattle, Washington, United States”.
geo_namestringNazwa lokalizacji. Przykład: „Warszawa”.
country_codestringKod kraju w formacie ISO-3166 alfa-2 dla tej lokalizacji geograficznej, np. US.
region_codestringKod podziału ISO-3166-2 dla tej lokalizacji geograficznej, np. US-WA. Może brakować tego pola.
city_namestringNazwa miasta dla tej lokalizacji geograficznej, np. Seattle. Może brakować tego pola.
postal_codestringKod pocztowy tej lokalizacji geograficznej, na przykład 98033. Może brakować tego pola.
dma_codeintegerKod DMA tej lokalizacji geograficznej, np. 510. Może brakować tego pola.

Language tabela

Nazwa polaTypOpis
idNumeric IdUnikalny klucz dla tego języka.
codestringKod ISO-639-1 dla tego języka lub zh_CN – chiński (uproszczony), zh_TW – chiński (tradycyjny), other – w przypadku innych języków.

DeviceCriteria tabela

Nazwa polaTypOpis
idNumeric IdUnikalny klucz dla danego kryterium urządzenia.
is_mobilebooleanJeśli ma wartość prawda, to kryterium obejmuje tylko urządzenia mobilne. W przypadku wartości false (fałsz) wpis dotyczy tylko urządzeń innych niż mobilne, nawet jeśli ich nazwa (np. „Inne”) nie oznacza tego.
namestringZnajoma nazwa kryteriów dotyczących urządzenia.
criteria_typeEnum0=OPERATING_SYSTEM
1=MOBILE_MAKE_MODEL
2=DEVICE_TYPE
operating_system_idNumeric IdIdentyfikuje system operacyjny. To pole jest wypełniane tylko wtedy, gdy criteria_type ma wartość 0.
mobile_brand_namestringMarka urządzenia. To pole jest wypełniane tylko wtedy, gdy criteria_type ma wartość 1.
mobile_model_namestringNazwa modelu urządzenia. To pole jest wypełniane tylko wtedy, gdy criteria_type ma wartość 1. Opcjonalnie.
mobile_make_model_idNumeric IdOkreśla numer modelu urządzenia. To pole jest wypełniane tylko wtedy, gdy criteria_type ma wartość 1. Opcjonalnie.
device_typeEnumWskazuje typ urządzenia. To pole jest wypełniane tylko wtedy, gdy criteria_type ma wartość 2.

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

Browser tabela

Nazwa polaTypOpis
idNumeric IdUnikalny klucz dla tej przeglądarki.
is_mobilebooleanJeśli ma wartość prawda, to kryterium obejmuje tylko urządzenia mobilne. W przypadku wartości false (fałsz) wpis dotyczy tylko urządzeń innych niż mobilne, nawet jeśli ich nazwa (np. „Inne”) nie oznacza tego.
namestringZnajoma nazwa przeglądarki, na przykład Safari 5. Nie zawiera ona pełnego ciągu znaków klienta użytkownika.

Isp tabela

Nazwa polaTypOpis
idNumeric IdUnikalny klucz tego dostawcy usług internetowych.
is_mobilebooleanJeśli ma wartość prawda, to kryterium obejmuje tylko urządzenia mobilne. W przypadku wartości false (fałsz) wpis dotyczy tylko urządzeń innych niż mobilne, nawet jeśli ich nazwa (np. „Inne”) nie oznacza tego.
namestringNazwa tego dostawcy usług internetowych.
secondary_criteria_idinteger Opcjonalny alternatywny identyfikator, którego można użyć do identyfikacji jednostki.

AppCollection tabela

Nazwa polaTypOpis
idNumeric IdUnikalny klucz do tej kolekcji aplikacji.
namestringNazwa tej kolekcji aplikacji.