Format plików odczytu elementu – wersja 2

Udostępnione typy

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

Typ: Numeric Id

ScalarOpis
integerLiczbowy numer identyfikacyjny używany jako identyfikator podmiotów. Nie powinny być traktowane jako unikalne uniwersalnie, np. mogą mieć taką samą wartość identyfikatora jak w kampanii, która ma też zastosowanie w przypadku Pixela.

Typ: Enum

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

Typ: Time

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

Typ: Currency Micro

ScalarOpis
integerKwota w walucie wyrażona w milionowych częściach (1/1 000 000 jednostki waluty). Jeśli np. waluta to euro, 75000000 oznacza 75 EUR, a jeśli dolary amerykańskie, 250000 to 0,25 USD. Nie można przeliczać kwot w dolarach na inne waluty ani w drugą stronę.

Typ: Percentage Milli

ScalarOpis
integerWartość procentowa jest podawana w milisekundach (1/1000 procenta), na przykład 100 oznacza 0,1%.

Typ: FileSummary

Nazwa polaTypOpis
namestringnazwa pliku (bez nazwy zasobów ani katalogu);
num_recordsintegerLiczba elementów w pliku.
versionintegerNumer wersji głównej pliku. Ta liczba może się zmienić, jeśli w przyszłości zostaną utworzone nowe wersje formatu danych encji.

Typ: EntityCommonData

Nazwa polaTypOpis
idNumeric IdUnikalny identyfikator w ramach danego typu elementu – np. w przypadku elementów typu Partner będzie to identyfikator partnera, w przypadku reklamodawców – identyfikator reklamodawcy itd.
namestringWyświetlana nazwa elementu.
activebooleanStan ustawiony przez użytkownika – jednostka może nie wyświetlać z innych powodów, np. z powodu wyczerpania budżetu, braku udziału w kampanii itp.
integration_codestringKod integracji ustawiony przez użytkownika

Typ: ExchangeSettings

Nazwa polaTypOpis
exchange_idNumeric IdIdentyfikator giełdy. Dołączanie z SupportedExchange.id
seat_idstringIdentyfikator miejsca w ramach wymiany
seat_user_namestringNazwa użytkownika powiązana z tym miejscem (dotyczy tylko miejsc Right Media innych niż 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 audytora, która może zawierać dodatkowe informacje, takie jak przyczyny odrzucenia;
sync_timeTimeCzas ostatniej synchronizacji elementu z tabelą auditor
external_idNumeric IdWypełnione tylko wtedy, gdy auditor ma wartość APPNEXUS, APPNEXUS_MICROSOFT lub RIGHT_MEDIA_NON_RTB. Jest to identyfikator podmiotu w pokoju 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ń w przypadku tego budżetu. Jeśli brakuje tego pola, oznacza to budżet o nieograniczonej liczbie wyświetleń.
max_spend_advertiser_microsintegerMaksymalny wydatek (w mikrosach waluty reklamodawcy) w ramach tego budżetu. Jeśli to pole jest puste, oznacza to, że budżet ma nieograniczony limit wydatków.
pacing_typeEnum0=FLIGHT
1=DAILY
pacing_max_impressionsintegerMaksymalna liczba wyświetleń na interwał ustawiony przez pacing_type. Jeśli to pole jest puste, nie ma limitu wyświetleń.
pacing_max_spend_advertiser_microsintegerMaksymalny wydatek (w mikrowalutach waluty reklamodawcy) na interwał tempa określony przez pacing_type. Jeśli to pole jest puste, nie ma limitu wydatków.
pacing_distributionEnum0=ASAP
1=EVEN
2=AHEAD

Typ: FrequencyCap

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

Typ: PartnerCosts

Nazwa polaTypOpis
cpm_fee_1_advertiser_microsintegerOpłata CPM 1 w mikrowalucie reklamodawcy.
cpm_fee_2_advertiser_microsintegerOpłata za CPM 2 w walucie reklamodawcy (mikros)
cpm_fee_3_advertiser_microsintegerOpłata CPM 3 w mikrowalucie reklamodawcy.
cpm_fee_4_advertiser_microsintegerOpłata za CPM 4 w walucie reklamodawcy (mikros)
cpm_fee_5_advertiser_microsintegerOpłata za CPM 5 w walucie reklamodawcy (mikros)
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 w 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_typeEnumTo samo co w przypadku cpm_fee_1_cost_type.
cpm_fee_3_cost_typeEnumTo samo co w przypadku cpm_fee_1_cost_type.
cpm_fee_4_cost_typeEnumTo samo co w przypadku cpm_fee_1_cost_type.
cpm_fee_5_cost_typeEnumTo samo co w przypadku cpm_fee_1_cost_type.
media_fee_percent_1_cost_typeEnumTo samo co w przypadku cpm_fee_1_cost_type.
media_fee_percent_2_cost_typeEnumTo samo co w przypadku cpm_fee_1_cost_type.
media_fee_percent_3_cost_typeEnumTo samo co w przypadku cpm_fee_1_cost_type.
media_fee_percent_4_cost_typeEnumTo samo co w przypadku cpm_fee_1_cost_type.
media_fee_percent_5_cost_typeEnumTo samo co 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_typeEnumTak samo jak w przypadku cpm_fee_1_bill_to_type.
cpm_fee_3_bill_to_typeEnumTo samo co w przypadku cpm_fee_1_bill_to_type.
cpm_fee_4_bill_to_typeEnumTo samo co w przypadku cpm_fee_1_bill_to_type.
cpm_fee_5_bill_to_typeEnumTo samo co w przypadku cpm_fee_1_bill_to_type.
media_fee_percent_1_bill_to_typeEnumTo samo co w przypadku cpm_fee_1_bill_to_type.
media_fee_percent_2_bill_to_typeEnumTo samo co w przypadku cpm_fee_1_bill_to_type.
media_fee_percent_3_bill_to_typeEnumTo samo co w przypadku cpm_fee_1_bill_to_type.
media_fee_percent_4_bill_to_typeEnumTo samo co w przypadku cpm_fee_1_bill_to_type.
media_fee_percent_5_bill_to_typeEnumTo samo co 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żących mikropłatnościach reklamodawcy. Ta wartość jest ustawiana tylko wtedy, gdy typ to CPM.
media_cost_markup_percent_millisintegerProcentowy marż na przychodach w walucie Percentage Milli. Ta wartość jest ustawiana tylko wtedy, gdy typ to MEDIA_COST_MARKUP lub TOTAL_MEDIA_COST_MARKUP.
post_view_conversion_tracking_fractionfloatUłamek konwersji po obejrzeniu, który ma być uwzględniany w śledzeniu konwersji. Jeśli wartość wynosi 0, zliczane są tylko konwersje po kliknięciu, a jeśli 1,0, śledzone są wszystkie konwersje.

Typ: CostTrackingPixel

Nazwa polaTypOpis
pixel_idNumeric IdIdentyfikator piksela śledzącego – pamiętaj, że 2 identyfikatory CostTrackingPixel mogą mieć ten sam identyfikator pixel_id, ale różne wartości dotyczące wyświetlenia lub okna kliknięcia.

Tę wartość można złączać z wartością Pixel.common_data.id.
view_window_minutesintegerLiczba minut, w których chcesz sprawdzać konwersje po obejrzeniu reklamy.
click_window_minutesintegerLiczba minut, w ciągu których należy szukać konwersji po kliknięciu.
floodlight_activity_idIdentyfikator liczbowyIdentyfikatory aktywności Floodlight CM. Ta wartość może być złączana z polem Pixel.dcm_floodlight_id.

Typ: Target

Nazwa polaTypOpis
criteria_idNumeric IdMożna je złączyć z inną tabelą w zależności od typu zdefiniowanego w tabeli TargetList. Może brakować tej wartości.
parameterstringDodatkowy parametr, którego definicja zależy od typu zdefiniowanego w elementach TargetList. Ta wartość może być nieobecna.
excludedbooleanGdy true, oznacza to, że cel został wykluczony. Brak wartości oznacza false.

Typ: TargetUnion

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

Typ: TargetList

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

, a wartość Target.parameter jest nieokreślona.
net_speed Target Target wskazujący szybkość sieci.
Wartości Target.criteria_id to:
0=ALL_CONNECTION_SPEEDS
1=BROADBAND (2,0 Mbit/s i szybciej).
2=DIALUP (56 kb/s i wolniejsze).
3=UNKNOWN_CONNECTION_SPEED
4=EDGE (Ulepszone dane na potrzeby GSM Evolution (2G). 57 kb/s i szybsza).
5=UMT (Uniwersalny system telekomunikacyjny (3G). 384 kb/s i szybsza).
6=DSL (cyfrowa linia abonencka. 768 kb/s i szybsza).
7=HSDPA (High-Speed Downlink Packet Access (3.5G). 1,8 Mb/s i szybsza).

Target.parameter jest nieokreślony.
browsers TargetUnion TargetUnion w przypadku przeglądarek. Element Target.criteria_id można złączyć z elementem Browser.id, a element Target.parameter jest niezdefiniowany.
device_criteria [Target]Array of Target typy dla kryteriów dotyczących urządzeń. Funkcja Target.criteria_id może być dołączana do funkcji DeviceCriteria.id, a funkcja Target.parameter jest nieokreślona.
languages TargetUnionTargetUnion typ języka. Funkcja Target.criteria_id może być dołączana do funkcji Language.id, a funkcja Target.parameter jest nieokreślona.
day_parting TargetUnionTyp TargetUnion do określania stawek dziennych. 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


Czas rozpoczęcia:
Liczba minut od północy podzielona przez 15. Zakres: 0–95.

EndTime:
Liczba minut od północy podzielona przez 15. Zakres: 1–96.

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

Target.parameter nie jest zdefiniowana.
audience_intersect [TargetUnion]Tablica typów TargetUnion na przykład dla nakładania się list odbiorców
[{“union”: [A, B]},
 {“union”: [C, D]},
 {“union”: [E, F],
 “excluded”: true}]
Oznacza to „(A LUB B) I (C LUB D) I NIE (E LUB F)”.

Target.criteria_id można złączać z UserList.id, a Target.parameter to wartość ostatnio używanego piksela w mikrosekundach. Jeśli ta wartość jest nieobecna, oznacza to kierowanie na wszystkich odbiorców.
keywords[Target]Tablica typów Target słów kluczowych. Element Target.criteria_id nie został zdefiniowany, a Target.parameter to pojedyncze słowo kluczowe.
kct_include_uncrawled_sitesbooleanFlaga wskazująca, czy do KCT mają być dodawane witryny, które nie zostały zindeksowane.
page_categories[Target]Tablica typów Target dla branż w AdExchange. Target.criteria_id to identyfikator numeryczny branży, a Target.parameter jest nieokreślony.
universal_channels[Target]Tablica typów Target dla kanałów. Funkcja Target.criteria_id może być złączana z funkcją UniversalChannel.id, a funkcja Target.parameter jest niezdefiniowana.
sites[Target] Tablica typów Target dla witryn. Wartość Target.criteria_id może być złączana z wartością UniversalSite.id lub nie jest ustawiona, jeśli witryna nie znajduje się w UniversalSite. Target.parameter to witryna, np. google.com, która niekoniecznie znajduje się w UniversalSite.
ispsTargetUnionTyp TargetUnion dla dostawcy usług internetowych. Funkcja Target.criteria_id może być dołączana do funkcji ISP.id, a funkcja Target.parameter jest nieokreślona.

Typ: SummaryFile

Nazwa polaTypOpis
file[FileSummary]Tablica zawierająca co najmniej 1 element FileSummary. Jeśli tablica jest pusta, oznacza to, że w tym dniu nie wygenerowano żadnych danych.

Typ: UserListAdvertiserPricing

Nazwa polaTypOpis
pricingUserListPricing
advertiser_idNumeric Id

Typ: UserListPricing

Nazwa polaTypOpis
cost_typestring
currency_codestringTrzyliterowy kod waluty według normy ISO 4217, np. PLN w przypadku złotego.
cost_microsCurrency Micro

Tabele prywatne

Partner tabela

Nazwa polaTypOpis
common_dataEntityCommonDataZawiera wspólne dane o tym partnerze, takie jak nazwa i identyfikator.
currency_codestringTrzyliterowy kod waluty według normy ISO 4217, np. USD w przypadku dolarów amerykańskich.
exchange_settings[ExchangeSettings]Tablica typów ExchangeSettings zawierająca informacje takie jak identyfikatory miejsc. Wyświetlane będą tylko włączone giełdy.
default_partner_costsPartnerCostsZawiera informacje o domyślnych kosztach dla tego partnera.
default_partner_revenue_modelPartnerRevenueModelZawiera informacje o domyślnym modelu przychodów dla tego partnera.
default_target_listTargetListZawiera domyślne opcje kierowania dla partnera. Obecnie obsługiwane jest tylko domyślne kierowanie geograficzne.

Advertiser tabela

Nazwa polaTypOpis
common_dataEntityCommonDataZawiera typowe dane o tym reklamodawcy, np. nazwę i identyfikator.
partner_idNumeric IdIdentyfikator nadrzędnego obiektu partnera. Można dołączyć do Partner.common_data.id.
currency_codestringTrzyliterowy kod waluty zgodny ze standardem ISO 4217, np. USD w przypadku złotego.
timezone_codestringKanoniczna nazwa strefy czasowej, np. „Ameryka/Los_Angeles”. Jeśli parametr dfa_configuration ma wartość NORMAL lub HYBRID, będzie on miał tę sam czas co powiązany z nim reklamodawca DFA.
landing_page_urlstringDomyślny adres URL strony docelowej.
available_channel_ids[integer]Tablica liczb całkowitych zawierająca dostępne kanały powiązane z tym reklamodawcą. Można połączyć z: UniversalChannel.id.
blacklist_channel_id[integer]Tablica liczb całkowitych zawierająca kanały na czarnej liście tego reklamodawcy. Można połączyć z: UniversalChannel.id.
dcm_configurationEnum0=NONE
1=NORMAL
2=HYBRID
dcm_network_idNumeric IdIdentyfikator sieci CM360. Ta wartość nie będzie widoczna, jeśli dcm_configuration jest ustawiona jako NONE.
dcm_advertiser_idNumeric IdIdentyfikator reklamodawcy CM360. Ta wartość nie będzie widoczna, jeśli dcm_configuration jest ustawiona jako NONE.
dcm_floodlight_group_idNumeric IdTa wartość nie będzie widoczna, jeśli dcm_configuration jest ustawiona jako NONE.
dcm_syncable_site_ids[Numeric Id]Tablica typów Numeric Id dla każdej możliwej do zsynchronizowania witryny tego reklamodawcy.
enable_oba_tagsbooleanTagi OBA są włączone, gdy ta opcja ma wartość true.

Campaign tabela

Nazwa polaTypOpis
common_dataEntityCommonDataZawiera wspólne dane o tej kampanii, np. nazwę i identyfikator.
advertiser_idNumeric IdIdentyfikator obiektu reklamodawcy nadrzędnego. Dołączanie do Advertiser.common_data.id
budgetBudgetPlanowany budżet tej kampanii. Obejmuje czas rozpoczęcia i zakończenia.
frequency_capFrequencyCapLimit wyświetleń na użytkownika aktywny w tej kampanii. Jeśli nie ustawisz limitu wyświetleń na użytkownika, ta wartość nie będzie widoczna.
default_target_listTargetListZawiera informacje o kierowaniu stosowanym w tej kampanii.
uses_video_creativesbooleanJeśli ma wartość Prawda, zalecane są zamówienia reklamowe z wstawkami wideo.
uses_display_creativesbooleanJeśli ma wartość Prawda, displayowe zamówienia reklamowe będą zalecane.
uses_audio_creativesbooleanJeśli ma wartość Prawda, zalecane są zamówienia reklamowe z reklamami audio.
objectiveEnum Wartości:
1 = BRAND_AWARENESS
2 = ONLINE_ACTION
3 = OFFLINE_ACTION
4 = APP_INSTALL
metricEnum Kluczowy wskaźnik wydajności. Używaj tego pola, by śledzić podstawowe dane, które posłużą 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_descriptionStringGdy dane dotyczą OTHER, jest to krótki opis tych danych.
metric_amount_microsintegerWartość docelowa danych wyrażona w mikro.

InsertionOrder tabela

Nazwa polaTypOpis
common_dataEntityCommonData
advertiser_idNumeric IdIdentyfikator obiektu reklamodawcy nadrzędnego. Można dołączyć do Advertiser.common_data.id.
campaign_idNumeric IdIdentyfikator nadrzędnego obiektu kampanii.
overall_budgetBudgetCałkowity budżet danego zamówienia reklamowego. Obejmuje czas rozpoczęcia i zakończenia.
scheduled_segments[Budget]Zawiera wszystkie zaplanowane segmenty budżetu. Ta tablica może być pusta lub może jej w ogóle nie być.
frequency_capFrequencyCapLimit wyświetleń na użytkownika aktywny w przypadku tego zamówienia reklamowego. Brakuje tej wartości, 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 obiektu nadrzędnego zamówienia reklamowego. Dołączanie za pomocą InsertionOrder.common_data.id.
creative_ids[Numeric Id]Tablica kreacji przypisanych do tego elementu zamówienia. Można dołączyć do Creative.common_data.id.
max_cpm_advertiser_microsintegerMaksymalna wartość CPM w mikro w walucie reklamodawcy.
performance_goalEnum0=NONE (vCPM jest wyłączona)
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 mikrowalucie reklamodawcy. Brakuje tej wartości, jeśli performance_goal jest ustawiony jako NONE.
partner_revenue_modelPartnerRevenueModelModel rozliczeniowy partnera używany w tym elemencie zamówienia.
cost_tracking_pixels[CostTrackingPixel]Tablica pikseli śledzenia kosztów przypisanych do śledzenia tego elementu zamówienia.
BudgetBudgetOgólny budżet tego elementu zamówienia. Obejmuje czas rozpoczęcia i zakończenia.
frequency_capFrequencyCapLimit wyświetleń na użytkownika aktywny dla tego elementu zamówienia. Brakuje tej wartości, jeśli nie ustawiono limitu wyświetleń na użytkownika.
partner_costsPartnerCosts
target_listTargetListZawiera informacje o kierowaniu, które jest aktywne w przypadku tego elementu zamówienia.

Creative tabela

Nazwa polaTypOpis
common_dataEntityCommonData
advertiser_idNumeric IdIdentyfikator obiektu reklamodawcy nadrzędnego. Można połączyć z: Advertiser.common_data.id.
dcm_placement_idNumeric IdIdentyfikator miejsca docelowego 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 zatwierdzają kreacje.
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 obiektu reklamodawcy nadrzędnego. Można połączyć z: Advertiser.common_data.id.
partner_idNumeric IdIdentyfikator nadrzędnego obiektu partnera. Dołączanie z Partner.common_data.id.
dcm_floodlight_idNumeric IdIdentyfikator DFA Floodlight powiązany z tym pikselem.
allow_google_redirectboolean
allow_rm_redirectbooleanJeśli ma wartość true, piksel będzie umożliwiać przekierowanie do lub z Right Media.
remarketing_enabledbooleanJeśli to ustawienie ma wartość true, ten piksel będzie można używać do kierowania reklam. Ta wartość jest obecna tylko wtedy, gdy wartość parametru dfa_configuration reklamodawcy nadrzędnego to NONE.
is_securebooleanJeśli ustawisz wartość true, ten piksel będzie używać protokołu HTTPS. Ta wartość jest obecna tylko wtedy, gdy parametr dfa_configuration reklamodawcy nadrzędnego ma wartość NONE.

Floodlight Activity tabela

Nazwa polaTypOpis
common_dataEntityCommonData
advertiser_idNumeric IdIdentyfikator obiektu reklamodawcy nadrzędnego. Dołączanie z Advertiser.common_data.id.
partner_idNumeric IdIdentyfikator obiektu partnera zarządzającego nadrzędnego reklamodawcy. Można połączyć z: Partner.common_data.id.
remarketing_enabledbooleanGdy to ustawienie ma wartość true, ta aktywność będzie dostępna do użycia w kierowaniu.
ssl_requiredbooleanGdy wartość to true, tagi muszą być zgodne.

InventorySource tabela

Nazwa polaTypOpis
idNumeric IdUnikalny klucz źródła zasobów reklamowych.
unclassifiedbooleanGdy ustawisz wartość true, uwzględnione zostaną wszystkie niezklasyfikowane zasoby reklamowe.
inventory_namestringNazwa źródła zasobów reklamowych wyświetlana w interfejsie. To pole może być puste. Jeśli inventory_name jest nieobecne, a unclassified ma wartość true, odnosi się do niezaklasyfikowanego zasobu reklamowego giełdy. Jeśli nie ma tego pola, a wartość unclassified ma wartość fałsz, źródło zasobów reklamowych to zasoby reklamowe na poziomie wymiany.
exchange_idNumeric IdIdentyfikator giełdy, na której dostępne jest to źródło zasobów reklamowych. Dołączanie z SupportedExchange.id.
accessing_advertisers[Numeric Id]Tablica identyfikatorów reklamodawców, które można złączać z elementem Advertiser.common_data.id i które mają 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_idstringZewnętrzny identyfikator nadany temu źródłowi zasobów reklamowych i zdefiniowany przez giełdę, zwykle znany jako identyfikator umowy lub identyfikator sprzedawcy. To pole może być puste.
min_cpm_microsintegerEfektywny minimalny poziom ceny tego źródła zasobów reklamowych w walucie w milionowych częściach jednostki.
min_cpm_currency_codestringTrzyliterowy kod waluty w formacie ISO 4217 używany w przypadku 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 dołączyć do DataPartner.id. To pole jest ustawiane tylko w przypadku list użytkowników pochodzących z innych firm.
accessing_advertisers[Numeric Id]Tablica identyfikatorów reklamodawców, które można złączać z kluczem Advertiser.common_data.id i które mają uprawnienia 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 będzie widoczne.

partner_pricingUserListPricingTyp kosztu to zawsze CPM, a kod waluty to zawsze USD.
advertiser_pricings[UserListAdvertiserPricing]Typ kosztu to zawsze CPM, a kod waluty to zawsze USD.

CustomAffinity tabela

Nazwa polaTypOpis
id Numeric Id Unikalny klucz niestandardowego podobieństwa.
name string Nazwa niestandardowej grupy odbiorców wyświetlana w interfejsie.
description string Opis listy odbiorców o podobnych zainteresowaniach wyświetlany w interfejsie.
advertiser_id Numeric Id Identyfikator obiektu reklamodawcy nadrzędnego. Dołączanie z Advertiser.common_data.id.

UniversalChannel tabela

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

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

is_deletedbooleanPo ustawieniu wartości true żadne nowe elementy zamówienia nie będą mogły być kierowane na ten kanał, ale istniejące elementy zamówienia, które już są kierowane na ten kanał, nadal będą to robić.
is_brand_safe_channelbooleanGdy to ustawienie jest ustawione na true, kanał może być używany do filtrowania pod kątem bezpieczeństwa marki. Obecnie dotyczy to tylko 4 wbudowanych poziomów bezpieczeństwa marki.true

NegativeKeywordList tabela

Nazwa polaTypOpis
id Numeric Id Unikalny klucz listy wykluczających słów kluczowych.
name string Nazwa listy wykluczających słów kluczowych wyświetlana w interfejsie.
advertiser_id Numeric Id Identyfikator obiektu reklamodawcy nadrzędnego. Dołączanie z Advertiser.common_data.id.

Tabele publiczne

SupportedExchange tabela

Nazwa polaTypOpis
idNumeric IdUnikalny klucz wymiany.
namestringNazwa giełdy, np. Ad Exchange.

DataPartner tabela

Nazwa polaTypOpis
idNumeric IdUnikalny klucz 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 identyfikatora uniwersalnego witryny na identyfikatory miejsc docelowych w internecie.
placementId Numeric Id Adres URL lub nazwa miejsca docelowego w internecie, np. google.com lub Google Unclassified.

GeoLocation tabela

Nazwa polaTypOpis
idNumeric IdUnikalny klucz lokalizacji geograficznej.
canonical_namestringŁańcuch znaków rozdzielonych przecinkami zawierający lokalizację i jej nadrzędne. Przykład: „Seattle, Waszyngton, Stany Zjednoczone”.
geo_namestringNazwa lokalizacji. Przykład: „Seattle”.
country_codestringKod kraju w formacie ISO-3166 alfa-2 odpowiadający tej lokalizacji geograficznej, np. US.
region_codestringKod podziału podrzędnego zgodny z ISO-3166-2 dla tej lokalizacji geograficznej, np. US-WA. To pole może być puste.
city_namestringNazwa miasta w danej lokalizacji geograficznej, np. Seattle. To pole może być puste.
postal_codestringKod pocztowy lokalizacji geograficznej, na przykład 98033. To pole może być puste.
dma_codeintegerKod DMA tej lokalizacji geograficznej, np. 510. To pole może być puste.

Language tabela

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

DeviceCriteria tabela

Nazwa polaTypOpis
idNumeric IdUnikalny klucz dla tych kryteriów dotyczących urządzenia.
is_mobilebooleanJeśli to pole ma wartość Prawda, to kryterium dotyczy tylko urządzeń mobilnych. Jeśli wartość to „fałsz”, ten wpis dotyczy tylko urządzeń innych niż mobilne, nawet jeśli ich nazwa (np. „Inny”) nie oznacza tego.
namestringZnajoma nazwa kryteriów Urządzenie.
criteria_typeEnum0=OPERATING_SYSTEM
1=MOBILE_MAKE_MODEL
2=DEVICE_TYPE
operating_system_idNumeric IdIdentyfikuje system operacyjny. To pole jest wypełnione tylko wtedy, gdy criteria_type ma wartość 0.
mobile_brand_namestringMarka urządzenia. To pole jest wypełnione tylko wtedy, gdy criteria_type ma wartość 1.
mobile_model_namestringNazwa modelu urządzenia. To pole jest wypełnione tylko wtedy, gdy criteria_type ma wartość 1. Opcjonalnie:
mobile_make_model_idNumeric IdIdentyfikuje numer modelu urządzenia. To pole jest wypełnione tylko wtedy, gdy criteria_type ma wartość 1. Opcjonalnie:
device_typeEnumWskazuje typ urządzenia. To pole jest wypełnione 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 to pole ma wartość Prawda, to kryterium dotyczy tylko urządzeń mobilnych. Jeśli wartość to „fałsz”, ten wpis dotyczy tylko urządzeń innych niż mobilne, nawet jeśli ich nazwa (np. „Inne”) nie wskazuje na to.
namestringZnana nazwa przeglądarki, np. Safari 5. Nie zawiera pełnego ciągu znaków klienta użytkownika.

Isp tabela

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

AppCollection tabela

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