Uporządkowane dane – wersja 3.1 – Zamówienie reklamowe

Ta wersja pliku SDF została wycofana. Aby nadal korzystać z plików uporządkowanych danych, użytkownicy powinni przejść na SDF w wersji v9. Korzystaj z tej dokumentacji tylko w przypadku odwoływania się do wcześniej wygenerowanych plików.

Wyjaśnienie formatu znajdziesz w omówieniu.

Pole	Wymagane	Typ	Z możliwością zapisu	Opis
Identyfikator Io	Wymagane tylko podczas edytowania istniejących zamówień reklamowych	liczba całkowita	Nie	Liczbowy identyfikator zamówienia reklamowego. Jeśli pozostawisz to pole puste, utworzymy nowy identyfikator zlecenia wstawienia i przypiszemy do niego unikalny identyfikator. Opcjonalnie podczas tworzenia nowego zamówienia reklamowego możesz użyć identyfikatora niestandardowego, aby przypisać do niego elementy zamówienia. Format identyfikatora niestandardowego to „ext[własny identyfikator]”, np. ext123. Podczas przetwarzania przesłanego pliku wszystkie identyfikatory niestandardowe zostaną zastąpione identyfikatorami przypisanymi przez DBM, a obiekty zostaną powiązane (np. element zamówienia z zamówieniem na wstawienie) na podstawie identyfikatorów niestandardowych.
ID kampanii	Nie	liczba całkowita	Nie	Liczbowy identyfikator kampanii. Możesz podać identyfikator niestandardowy (np. „ext[identyfikator kampanii]”) kampanii, którą tworzysz jednocześnie z tym zamówieniem.
Nazwa	Tak	ciąg znaków	Tak	Nazwa wpisu.
Sygnatura czasowa	Wymagane podczas edytowania istniejących wpisów	liczba całkowita	Nie	Sygnatura czasowa elementu. System korzysta z niej, aby potwierdzić, że element nie zmienił się między pobraniem a przesłaniem.
Stan	Tak	ciąg znaków	Tak	Ustawienie stanu wpisu. Aktywne Wstrzymana Wersja robocza Zarchiwizowane Usunięto
Typ wejścia/wyjścia	Tak	ciąg znaków	Tak	Typ zamówienia reklamowego. Można ustawić tylko podczas tworzenia. standardowa
Opłaty	Nie	ciąg znaków, lista list	Tak	Wszystkie opłaty za ten wpis. Format listy = (Kategoria opłaty; Kwota opłaty; Typ opłaty; Zafakturowano;). Kategoria opłaty CPM Multimedia Kwota opłaty Liczba zmiennoprzecinkowa Procent jako liczba zmiennoprzecinkowa Typ opłaty (ciąg znaków, patrz tabela opłat) Fakturowane Prawda Fałsz pusty Przykład: „(CPM; 2; Bid Manager Fee; False) ; (Media; 13; Default; True);” Akceptowane wartości znajdziesz w tej tabeli: Uwaga: opłata za CPM za funkcje premium jest zarezerwowana przez system i nie można jej zmienić. Kardynalność opłaty za funkcje premium jest zachowywana w przypadku zmian przez wstawianie w razie potrzeby domyślnych opłat za CPM. Kategoria opłaty Typ opłaty Opcja fakturowania CPM/Media Domyślny Niedozwolone (pozostaw puste) CPM/Media Serwer reklamowy firmy zewnętrznej Niedozwolone (pozostaw puste) CPM/Media DoubleVerify Dozwolone (prawda/fałsz) CPM/Media Adsafe Niedozwolone (pozostaw puste) CPM/Media AdXpose Niedozwolone (pozostaw puste) CPM/Media Vizu Niedozwolone (pozostaw puste) CPM/Media Aggregate Knowledge Niedozwolone (pozostaw puste) CPM/Media Teracent Niedozwolone (pozostaw puste) CPM/Media Evidon Niedozwolone (pozostaw puste) CPM/Media Opłata dla agencyjnej platformy zakupowej Niedozwolone (pozostaw puste) CPM/Media Adloox Dozwolone (prawda/fałsz) CPM ShopLocal Wymagane (prawda) CPM TrustMetrics Niedozwolone (pozostaw puste) CPM Wideo Integral Ad Science Dozwolone (prawda/fałsz) CPM Wideo MOAT Niedozwolone (pozostaw puste) Multimedia Opłata za zarządzanie stawkami Wymagane (prawda) Multimedia Dane o koszcie mediów Niedozwolone (pozostaw puste) CPM Opłaty za funkcje Premium Niedozwolone (pozostaw puste)
Kod integracji	Nie	ciąg znaków	Tak	Opcjonalny kod do celów śledzenia.
Szczegóły	Nie	ciąg znaków	Tak	Szczegóły wpisu w formacie ciągu znaków.
Tempo	Tak	ciąg znaków	Tak	Okres, w którym ma zostać wydana kwota limitu wydatków. Codziennie Co miesiąc Lot
Tempo	Tak	ciąg znaków	Tak	Tempo wyświetlania tego wpisu. Jak najszybciej Równomierny Do przodu
Kwota dla tempa	Tak	liczba zmiennoprzecinkowa	Tak	Kwota do wydania w okresie określonym przez typ tempa.
Częstotliwość włączona	Tak	ciąg znaków	Tak	Włącza lub wyłącza ograniczenie liczby wyświetleń na podstawie wyświetleń w zamówieniu reklamowym. PRAWDA FAŁSZ
Wyświetlenia o ograniczonej liczbie	Wymagany, gdy „Frequency Enabled” (Częstotliwość włączona) ma wartość „TRUE”	liczba całkowita	Tak	Dodatnia liczba całkowita określająca liczbę wyświetleń w danym okresie częstotliwości, czyli x w wyrażeniu „Wyświetl x razy w okresie y”.
Okres częstotliwości	Wymagany, gdy „Frequency Enabled” (Częstotliwość włączona) ma wartość „TRUE”	ciąg znaków	Tak	Określa jednostkę okresu limitu wyświetleń na użytkownika. Minuty Godziny Dni Tygodnie Miesiące Cały okres
Kwota częstotliwości	Wymagany, gdy „Frequency Enabled” (Częstotliwość włączona) ma wartość „TRUE”	liczba całkowita	Tak	Dodatnia liczba całkowita określająca długość okresu częstotliwości, czyli wartość y w wyrażeniu „Wyświetl x wyświetleń w okresie y”.
Typ celu skuteczności	Tak	ciąg znaków	Tak	Jednostka celu zamówienia reklamowego CPM CPA CPC CPV CPIAVC CTR % widoczności Brak Inne
Wartość celu skuteczności	Tak	ciąg znaków	Tak	Wartość celu w walucie (CPM, CPA, CPC, CPV, CPIAVC), w procentach (% widoczności, CTR) lub jako ciąg znaków (Inne).
Pomiar DAR	Tak	ciąg znaków	Tak	Włącza i wyłącza pomiar odbiorców za pomocą Nielsen Digital Ad Ratings. PRAWDA FAŁSZ
Pomiar kanału DAR	Wymagane, gdy wartość parametru „Measure DAR” to „TRUE”	liczba całkowita	Tak	Kanał, który ma być mierzony za pomocą Nielsen Digital Ad Ratings. Format = UniversalChannel.id
Typ budżetu	Tak	ciąg znaków	Tak	Określa typ budżetu pod kątem wielkości „przychodu” do wydania (kwota) lub liczby wyświetleń do kupienia (wyświetlenia). Kwota Wyświetlenia miniatur
Segmenty budżetu	Tak	ciąg znaków, lista list	Tak	Określa konkretne segmenty budżetu. Format listy = (Budżet, Data rozpoczęcia, Data zakończenia). Budżet jest podany w formacie waluty zmiennoprzecinkowej. Daty są podane w formacie MM/DD/RRRR. Przykład: „(100.50;01/01/2016;03/31/2016;);(200.00;04/01/2016;06/30/2016;);”
Automatyczne przydzielanie budżetu	Tak	ciąg znaków	Tak	Włącza i wyłącza automatyczne przydzielanie budżetu. PRAWDA FAŁSZ
Kierowanie geograficzne – uwzględnij	Nie	ciąg znaków, lista	Tak	Lista obszarów geograficznych do uwzględnienia w kierowaniu. Format listy = (GeoLocation.id; GeoLocation.id;itd.).
Kierowanie geograficzne – Wyklucz	Nie	ciąg znaków, lista	Tak	Lista obszarów geograficznych do wykluczenia z kierowania. Format listy = (GeoLocation.id;GeoLocation.id; itp.).
Kierowanie na język – uwzględnij	Nie	ciąg znaków, lista	Tak	Lista języków, które mają być uwzględnione w kierowaniu. Format listy = (Language.id;Language.id;etc.).
Kierowanie na język – wykluczanie	Nie	ciąg znaków, lista	Tak	Lista języków, które mają zostać wykluczone z kierowania. Format listy = (Language.id;Language.id;etc.).
Kierowanie na urządzenia – uwzględnianie	Nie	ciąg znaków, lista	Tak	Lista urządzeń, które mają być uwzględnione w kierowaniu. Format listy = (DeviceCriteria.id;DeviceCriteria.id;itd.).
Kierowanie na urządzenia – wykluczanie	Nie	ciąg znaków, lista	Tak	Lista urządzeń, które mają zostać wykluczone z kierowania. Format listy = (DeviceCriteria.id;DeviceCriteria.id;itd.).
Kierowanie na przeglądarkę – uwzględnij	Nie	ciąg znaków, lista	Tak	Lista przeglądarek do uwzględnienia w kierowaniu. Format listy = (Browser.id;Browser.id;itd.).
Kierowanie na przeglądarkę – wykluczanie	Nie	ciąg znaków, lista	Tak	Lista przeglądarek, które mają zostać wykluczone z kierowania. Format listy = (Browser.id;Browser.id;itd.).
Etykiety bezpieczeństwa marki	Nie	ciąg znaków, lista	Tak	Lista etykiet treści cyfrowych, na które chcesz kierować reklamy. Format listy = (G;PG; itp.). G PG T MA ?
Ustawienie czułości bezpieczeństwa marki	Nie	ciąg znaków	Tak	Wybierz ustawienie czułości, aby blokować zasoby reklamowe na podstawie tematyki otaczających je treści. Nie blokuj Korzystanie z weryfikacji DoubleClick Użyj niestandardowych
Ustawienia niestandardowe bezpieczeństwa marki	Wymagane, gdy w kolumnie „Brand Safety Custom Setting” (Niestandardowe ustawienie bezpieczeństwa marki) jest ustawiona wartość „Use Custom” (Używaj niestandardowych).	ciąg znaków, lista	Tak	Jeśli ustawienie czułości bezpieczeństwa marki ma wartość „Użyj ustawień niestandardowych”, określ listę standardowych klasyfikatorów treści. Na przykład (Adult;Alcohol;Tobacco;etc.). Dorosły Poniżające Pobieranie i udostępnianie Broń Hazard Przemoc Treści dwuznaczne Wulgaryzmy Alkohol Narkotyki Tytoń Polityka Religia Tragedie Wypadki komunikacyjne Drażliwe zagadnienia społeczne Szokujące treści
Usługi weryfikacyjne innych firm	Nie	ciąg znaków	Tak	Dostawca usług weryfikacyjnych innych firm. Brak Integral Ad Science. DoubleVerify Adloox
Etykiety weryfikacji przez usługi zewnętrzne	Nie	ciąg znaków, lista	Tak	Jeśli w przypadku opcji Usługi weryfikacji firm zewnętrznych nie wybrano wartości „Brak”, podaj listę etykiet obsługiwanych przez wybranego dostawcę.
Kierowanie na kanały – uwzględnianie	Nie	ciąg znaków, lista	Tak	Lista kanałów do uwzględnienia w kierowaniu. Format listy = (UniversalChannel.id;UniversalChannel.id; itp.).
Kierowanie na kanały – wykluczanie	Nie	ciąg znaków, lista	Tak	Lista kanałów do uwzględnienia w kierowaniu. Format listy = (UniversalChannel.id;UniversalChannel.id; itp.).
Kierowanie na witryny – uwzględnij	Nie	ciąg znaków, lista	Tak	Lista witryn do uwzględnienia w kierowaniu. Lista może zawierać zestaw identyfikatorów witryn lub ciągi adresów URL, jeśli nie znajdują się one w tabeli Witryna uniwersalna. Format listy = (UniversalSite.Id;'http://someurl.com';etc.).
Kierowanie na witryny – wykluczanie	Nie	ciąg znaków, lista	Tak	Lista witryn do wykluczenia z kierowania. Lista może zawierać zestaw identyfikatorów witryn lub ciągi adresów URL, jeśli nie znajdują się one w tabeli Witryna uniwersalna. Format listy = (UniversalSite.Id;'http://someurl.com';etc.).
Kierowanie na aplikacje – uwzględnianie	Nie	ciąg znaków, lista	Tak	Lista aplikacji, które mają być uwzględnione w kierowaniu. Lista może zawierać zestaw identyfikatorów witryn uniwersalnych lub ciągi pakietów aplikacji, jeśli nie znajdują się one w tabeli witryn uniwersalnych. Format listy = (UniversalSite.Id; 'some.app.package';etc.).
Kierowanie na aplikację – wykluczanie	Nie	ciąg znaków, lista	Tak	Lista aplikacji, które mają zostać wykluczone z kierowania. Lista może zawierać zestaw identyfikatorów witryn uniwersalnych lub ciągi pakietów aplikacji, jeśli nie znajdują się one w tabeli witryn uniwersalnych. Format listy = (UniversalSite.Id; 'some.app.package';etc.).
Kierowanie na kategorię – uwzględnij	Nie	ciąg znaków, lista	Tak	Lista kategorii do uwzględnienia w kierowaniu, pochodząca z pionowych identyfikatorów AdX. Format listy = (Verticals.Id;Verticals.Id;itd.).
Kierowanie na kategorię – wykluczanie	Nie	ciąg znaków, lista	Tak	Lista kategorii do wykluczenia z kierowania, pochodząca z pionowych identyfikatorów AdX. Format listy = (Verticals.Id;Verticals.Id;itd.).
Kierowanie na słowa kluczowe – uwzględnianie	Nie	ciąg znaków, lista	Tak	Lista ciągów słów kluczowych, które mają być uwzględnione w kierowaniu.
Kierowanie na słowa kluczowe – wykluczanie	Nie	ciąg znaków, lista	Tak	Lista ciągów słów kluczowych do wykluczenia z kierowania.
Kierowanie na odbiorców – podobni odbiorcy	Wymagane, gdy „Typ” to „Displayowa”, „Wideo” lub „Audio”.	ciąg znaków	Tak	Włącz podobnych odbiorców w przypadku własnych list odbiorców, na które kierujesz reklamy. PRAWDA FAŁSZ
Kierowanie na odbiorców – uwzględnianie	Nie	ciąg znaków, lista list par	Tak	Lista list odbiorców, które mają być uwzględnione w kierowaniu. W przypadku własnych list odbiorców każda lista jest wymieniona jako para identyfikatora listy użytkowników i ustawienia aktualności. Para to (1;1d;), gdzie 1d to aktualność próbki reprezentująca aktualność 1 dnia. W przypadku list odbiorców dostarczonych przez firmy zewnętrzne nie jest dostępna opcja „Ostatnia aktywność”, więc format listy to (3;);(4;);. Aby połączyć grupy odbiorców za pomocą operatorów logicznych „ORAZ” i „LUB”, skorzystaj z tego przykładu: aby połączyć pary z danymi o ostatniej aktywności i bez nich: ' ((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'. Oznacza to: (lista 1 z 1-dniową aktualnością LUB lista 2 z 365-dniową aktualnością) ORAZ (lista 3 bez określonej aktualności LUB lista 4 z 5-minutową aktualnością LUB lista 5 ze wszystkimi użytkownikami). Prawidłowe wartości aktualności to: all, 1m, 5m, 10m, 15m, 30m, 1h, 2h, 3h, 6h, 12h, 1d, 2d, 3d, 5d, 7d, 10d, 14d, 15d, 21d, 28d, 30d, 45d, 60d, 90d, 120d, 180d, 270d, 365d
Kierowanie na odbiorców – wykluczanie	Nie	ciąg znaków, lista list par	Tak	Lista list odbiorców do wykluczenia z kierowania. Każda lista odbiorców jest wymieniona jako para identyfikatora UserList i ustawienia aktualności, jeśli jest to lista własnych odbiorców. Para to (1;1d;), gdzie 1d to aktualność próbki reprezentująca aktualność 1 dnia. W przypadku list odbiorców dostarczonych przez firmy zewnętrzne nie jest jednak dostępna aktualność, więc format listy to (3;);(4;);. Format listy= (UserList.id; recency optional;); (UserList.id; recency optional;); Przykład: "(1;1d;);(2;);". Prawidłowe wartości recency to: all, 1m, 5m, 10m, 15m, 30m, 1h, 2h, 3h, 6h, 12h, 1d, 2d, 3d, 5d, 7d, 10d, 14d, 15d, 21d, 28d, 30d, 45d, 60d, 90d, 120d, 180d, 270d, 365d
Kierowanie na odbiorców o podobnych zainteresowaniach i odbiorców na rynku – uwzględnij	Nie	ciąg znaków, lista	Tak	Lista list odbiorców o podobnych zainteresowaniach lub odbiorców na rynku do uwzględnienia. Format listy= Identyfikator listy użytkowników; Identyfikator listy użytkowników;
Kierowanie na odbiorców o podobnych zainteresowaniach i odbiorców na rynku – wykluczanie	Nie	ciąg znaków, lista	Tak	Lista list odbiorców o podobnych zainteresowaniach lub odbiorców na rynku do wykluczenia. Format listy= Identyfikator listy użytkowników; Identyfikator listy użytkowników;
Kierowanie na niestandardowych odbiorców o podobnych zainteresowaniach	Nie	ciąg znaków, lista	Tak	Lista niestandardowych list, na które chcesz kierować reklamy. Format listy= Identyfikator listy użytkowników; Identyfikator listy użytkowników;
Kierowanie na źródło zasobów reklamowych – Uwzględnij	Nie	ciąg znaków, lista	Tak	Lista zasobów reklamowych do uwzględnienia w kierowaniu. Format listy = (InventorySource.id; InventorySource.id;).
Kierowanie na źródło zasobów reklamowych – Wyklucz	Nie	ciąg znaków, lista	Tak	Lista zasobów reklamowych, które mają zostać wykluczone z kierowania. Format listy = (InventorySource.id; InventorySource.id;).
Kierowanie na porę dnia	Nie	ciąg znaków, lista	Tak	Lista identyfikatorów, gdzie każdy identyfikator pory dnia jest tworzony w tym formacie: daypart_id = base_dayparting_id + days_since_monday * 10000 + start * 100 + end base_dayparting_id = 300000 days_since_monday: 0=poniedziałek, 1=wtorek, ..., 6=niedziela start: 0..95 (00:00–23:45) liczba całkowita z zakresu 0–95, reprezentująca 15-minutowe przedziały czasu end: 1..96 (00:15–24:00); liczba całkowita z zakresu 0–95, reprezentująca 15-minutowe przedziały czasu start < end W przypadku nowych podmiotów czasy będą ustawiane w strefie czasowej użytkowników (np. „Lokalne”). W przypadku istniejących elementów strefa czasowa nie zostanie zmieniona.
Kierowanie na środowisko	Wymagane, gdy „Typ” to „Displayowa”, „Wideo” lub „Audio”.	ciąg znaków, lista	Tak	Lista środowisk, na które chcesz kierować reklamy. Format listy = (strony na komputer; aplikacja mobilna itp.). W przypadku środowiska wyświetlania: Witryny na komputery Internet mobilny Aplikacja mobilna Reklama pełnoekranowa w aplikacji mobilnej Strony na komputer na urządzeniu mobilnym W przypadku filmu: Wideo w internecie na komputery Gra w przeglądarce na komputer W tekście strony na komputerze W strumieniu społecznościowym na komputerze Wideo w internecie mobilnym Wideo w aplikacji mobilnej Pełnoekranowa reklama wideo w aplikacji mobilnej W przypadku dźwięku: Dźwięk w aplikacjach internetowych na komputery Dźwięk w internecie mobilnym Dźwięk z aplikacji mobilnej
Kierowanie według widoczności w Widoku aktywnym	Nie	ciąg znaków	Tak	kierować reklamy na prognozowane odsetki widoczności; Wartości procentowe są reprezentowane jako liczby zmiennoprzecinkowe. Jedna z tych wartości: {0,1, 0,2, 0,3, 0,4, 0,5, 0,6, 0,7, 0,8, 0,9}
Kierowanie według widoczności – pozycja reklamy – uwzględnij	Nie	ciąg znaków	Tak	kierować reklamy na określone pozycje, Wybierz jedną z akceptowanych wartości lub nie wybieraj żadnej: Wszystkie ATF BTF Nieznany
Kierowanie według widoczności – pozycja reklamy – wykluczanie	Nie	ciąg znaków	Tak	Wyklucz pozycje reklam z kierowania. Wybierz jedną z akceptowanych wartości lub nie wybieraj żadnej: ATF BTF Nieznany
Kierowanie na pozycję reklamy wideo	Nie	ciąg znaków, lista	Tak	Lista pozycji reklam wideo, na które chcesz kierować reklamy. Wybierz co najmniej jedną z akceptowanych wartości: nieznany Reklama przed filmem Reklama w trakcie filmu Reklama po filmie
Kierowanie na rozmiar odtwarzacza wideo	Nie	ciąg znaków, lista	Tak	Lista rozmiarów odtwarzacza reklam wideo, na które chcesz kierować reklamy. Wybierz co najmniej jedną z akceptowanych wartości: nieznany mały duża HD
Kierowanie demograficzne na płeć	Nie	ciąg znaków, lista	Tak	Lista płci, na które chcesz kierować reklamy. Wybierz co najmniej jedną z akceptowanych wartości: Kobieta Mężczyzna Nieznany
Kierowanie demograficzne – wiek	Nie	ciąg znaków, lista	Tak	kierować reklamy na określony przedział wiekowy użytkowników; Określ przedział „od–do”, wybierając pojedynczy wiek „Od” i pojedynczy wiek „Do” oraz określając, czy uwzględniać nieznany wiek (prawda/fałsz). Zobacz listę akceptowanych przedziałów wiekowych. Przykład 1. Aby kierować reklamy na osoby w wieku 18–55 lat i uwzględnić nieznany wiek, podaj format {Od; Do; Uwzględnij nieznany wiek Prawda/Fałsz} = 18;55;prawda; Przykład 2. Aby kierować reklamy tylko na użytkowników w wieku powyżej 35 lat i wykluczyć nieznany wiek, podaj następujący format = 35;+;fałsz;. Akceptowane wartości dla parametru Od: 18 25 35 45 55 65 Akceptowane wartości pola „Do”: 25 35 45 55 65 +
Kierowanie na szybkość połączenia	Nie	ciąg znaków	Tak	Kierowanie na określoną szybkość połączenia. Wybierz jedną z akceptowanych wartości: Wszystkie 2G 3G DSL 4G
Kierowanie na operatora – uwzględnij	Nie	ciąg znaków, lista	Tak	Lista dostawców usług internetowych lub operatorów sieci komórkowych, na których chcesz kierować reklamy. Format listy = {ISP.id; ISP.id;}
Kierowanie na operatora – wykluczanie	Nie	ciąg znaków, lista	Tak	Lista dostawców usług internetowych lub operatorów sieci komórkowych do wykluczenia. Format listy = {ISP.id; ISP.id;}