Obecnie przenosimy niektóre typy raportów z raportów offline na błyskawiczne. Gdy użytkownik zostanie przeniesiony, odpowiedzi queries.list będą zawierać istniejące raporty błyskawiczne. Więcej informacji znajdziesz na naszym blogu.
Te typy definiują pola zagnieżdżone w niektórych tabelach; te pola nie mają własnych tabel.
Typ: Numeric Id
Scalar
Opis
integer
Liczbowy 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
Scalar
Opis
integer
Lista wielu możliwych opcji. Różne opcje są opisane bardziej szczegółowo w typie nadrzędnym.
Typ: Time
Scalar
Opis
integer
Czas 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
Scalar
Opis
integer
Kwota 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
Scalar
Opis
integer
Wartość procentowa jest podawana w milisekundach (1/1000 procenta), na przykład 100 oznacza 0,1%.
Typ: FileSummary
Nazwa pola
Typ
Opis
name
string
nazwa pliku (bez nazwy zasobów ani katalogu);
num_records
integer
Liczba elementów w pliku.
version
integer
Numer wersji głównej pliku. Ta liczba może się zmienić, jeśli w przyszłości zostaną utworzone nowe wersje formatu danych encji.
Unikalny 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.
name
string
Wyświetlana nazwa elementu.
active
boolean
Stan 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.
Maksymalna 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_micros
integer
Maksymalny 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.
Maksymalna liczba wyświetleń na interwał ustawiony przez pacing_type. Jeśli to pole jest puste, nie ma limitu wyświetleń.
pacing_max_spend_advertiser_micros
integer
Maksymalny wydatek (w mikrowalutach waluty reklamodawcy) na interwał tempa określony przez pacing_type. Jeśli to pole jest puste, nie ma limitu wydatków.
Kwota przychodów w bieżących mikropłatnościach reklamodawcy. Ta wartość jest ustawiana tylko wtedy, gdy typ to CPM.
media_cost_markup_percent_millis
integer
Procentowy 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_fraction
float
Uł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.
Identyfikator 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_minutes
integer
Liczba minut, w których chcesz sprawdzać konwersje po obejrzeniu reklamy.
click_window_minutes
integer
Liczba minut, w ciągu których należy szukać konwersji po kliknięciu.
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.
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.
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.
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).
TargetUnion w przypadku przeglądarek. Element Target.criteria_id można złączyć z elementem Browser.id, a element Target.parameter jest niezdefiniowany.
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.
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.
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.
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.
Typ 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.
Identyfikator nadrzędnego obiektu partnera. Można dołączyć do Partner.common_data.id.
currency_code
string
Trzyliterowy kod waluty zgodny ze standardem ISO 4217, np. USD w przypadku złotego.
timezone_code
string
Kanoniczna 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_url
string
Domyś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.
Limit 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.
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
Identyfikator DFA Floodlight powiązany z tym pikselem.
allow_google_redirect
boolean
allow_rm_redirect
boolean
Jeśli ma wartość true, piksel będzie umożliwiać przekierowanie do lub z Right Media.
remarketing_enabled
boolean
Jeś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_secure
boolean
Jeś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.
Gdy ustawisz wartość true, uwzględnione zostaną wszystkie niezklasyfikowane zasoby reklamowe.
inventory_name
string
Nazwa ź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.
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_id
string
Zewnę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_micros
integer
Efektywny minimalny poziom ceny tego źródła zasobów reklamowych w walucie w milionowych częściach jednostki.
min_cpm_currency_code
string
Trzyliterowy kod waluty w formacie ISO 4217 używany w przypadku min_cpm_micros.
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.
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_deleted
boolean
Po 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_channel
boolean
Gdy 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
Kod 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.
Unikalny klucz dla tych kryteriów dotyczących urządzenia.
is_mobile
boolean
Jeś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.
Jeś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.
name
string
Znana nazwa przeglądarki, np. Safari 5. Nie zawiera pełnego ciągu znaków klienta użytkownika.
Jeś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.
name
string
Nazwa dostawcy usług internetowych.
secondary_criteria_id
integer
Opcjonalny identyfikator alternatywny, którego można użyć do zidentyfikowania elementu.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2024-11-15 UTC."],[[["Entity Read Files, providing data on advertisers, campaigns, and other entities, will be sunset on October 31, 2024, requiring migration to the Display & Video 360 API."],["Shared data types like `Numeric Id`, `Enum`, `Time`, and custom types like `Budget` and `FrequencyCap` are used across various entities to represent specific attributes."],["Data is organized into tables like `Advertiser`, `Campaign`, `LineItem`, and `Creative`, each containing specific fields relevant to their respective entities."],["Tables are interconnected via joinable fields, enabling linking and analysis of data across entities, such as joining `Advertiser` and `Campaign` using `advertiser_id`."],["The `InventorySource` table provides details about ad inventory, including its source, accessibility for advertisers, and associated costs."]]],["Key data elements include numerical IDs for entities, with non-unique values across different types. Files omit null scalars and empty arrays. Time is recorded as Unix timestamps. Currency is measured in micros. Percentages are in millis. Entity files contain common data like IDs, names, and statuses. Budget settings specify timeframes, impression caps, spending, and pacing. Partner costs and revenue models define fees, markup percentages, and billing. Targeting information involves criteria, exclusions, and unions for inventory sources, geo-locations, devices, and more. Entity Read files are to be replaced by Display & Video 360 API.\n"]]