Tabele prywatne
Partner
tabela
Nazwa pola | Typ | Opis |
---|---|---|
common_data | EntityCommonData | Zawiera wspólne dane dotyczące tego partnera, takie jak nazwa i identyfikator. |
currency_code | string | Trzyliterowy 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_costs | PartnerCosts | Zawiera informacje o kosztach awarii w przypadku tego partnera. |
default_partner_revenue_model | PartnerRevenueModel | Zawiera informacje o domyślnym modelu rozliczeniowym tego partnera. |
default_target_list | TargetList | Zawiera domyślne opcje kierowania partnera. Obecnie obsługiwane jest tu tylko domyślne kierowanie geograficzne. |
Advertiser
tabela
Nazwa pola | Typ | Opis |
---|---|---|
common_data | EntityCommonData | Zawiera wspólne dane dotyczące tego reklamodawcy, np. nazwę i identyfikator. |
partner_id | Numeric Id | Identyfikator obiektu partnera nadrzędnego. Można je dołączyć do grupy Partner.common_data.id . |
currency_code | string | Trzyliterowy kod waluty w standardzie ISO 4217, np. USD w przypadku dolarów amerykańskich. |
timezone_code | string | Kanoniczny 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_url | string | Domyś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_configuration | Enum | 0=NONE |
dcm_network_id | Numeric Id | Identyfikator sieci CM360. Tej wartości nie będzie, jeśli dcm_configuration ma wartość NONE . |
dcm_advertiser_id | Numeric Id | Identyfikator reklamodawcy CM360. Tej wartości nie będzie, jeśli dcm_configuration ma wartość NONE . |
dcm_floodlight_group_id | Numeric Id | Tej 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_tags | boolean | Tagi OBA są włączone, gdy ma wartość true . |
Campaign
tabela
Nazwa pola | Typ | Opis |
---|---|---|
common_data | EntityCommonData | Zawiera wspólne dane o tej kampanii, takie jak nazwa i identyfikator. |
advertiser_id | Numeric Id | Identyfikator nadrzędnego obiektu reklamodawcy. Można dołączyć do spotkania z: Advertiser.common_data.id |
budget | Budget | Planowany budżet kampanii. Obejmuje godzinę rozpoczęcia i zakończenia. |
frequency_cap | FrequencyCap | Limit 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_list | TargetList | Zawiera informacje o kierowaniu obowiązującym w tej kampanii. |
uses_video_creatives | boolean | Jeśli zasada ma wartość Prawda, zamówienia reklamowe wideo będą zalecane. |
uses_display_creatives | boolean | Jeśli ma wartość Prawda, zalecane będą displayowe zamówienia reklamowe. |
uses_audio_creatives | boolean | Jeśli zasada ma wartość Prawda, zamówienia reklamowe audio będą zalecane. |
objective | Enum |
Wartości to:1 = BRAND_AWARENESS 2 = ONLINE_ACTION 3 = OFFLINE_ACTION 4 = APP_INSTALL |
metric | Enum |
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_description | String | Jeśli dane mają wartość OTHER , jest to krótki opis danych. |
metric_amount_micros | integer | Docelowa ilość danych w mikro. |
InsertionOrder
tabela
Nazwa pola | Typ | Opis |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | Identyfikator nadrzędnego obiektu reklamodawcy. Można je dołączyć do grupy Advertiser.common_data.id . |
campaign_id | Numeric Id | Identyfikator nadrzędnego obiektu kampanii. |
overall_budget | Budget | Cał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_cap | FrequencyCap | Limit 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_costs | PartnerCosts | |
default_target_list | TargetList |
LineItem
tabela
Nazwa pola | Typ | Opis |
---|---|---|
common_data |
EntityCommonData |
|
line_item_type | Enum |
0=RTB |
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_micros | integer | Maksymalna wartość CPM w walucie reklamodawcy (mikro). |
performance_goal | Enum | 0=NONE (vCPM jest wyłączone)1=CPC |
goal_advertiser_micros | integer | Cel vCPM w walucie reklamodawcy (mikro). Tej wartości nie będzie, jeśli performance_goal ma wartość NONE . |
partner_revenue_model | PartnerRevenueModel | Model rozliczeniowy partnera używany w tym elemencie zamówienia. |
cost_tracking_pixels | [CostTrackingPixel] | Tablica CostTrackingPixels przypisana do śledzenia tego elementu zamówienia. |
Budget | Budget | Całkowity budżet danego elementu zamówienia. Obejmuje czas rozpoczęcia i zakończenia. |
frequency_cap | FrequencyCap | Limit 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_costs | PartnerCosts | |
target_list | TargetList | Zawiera informacje o kierowaniu obowiązującym w przypadku danego elementu zamówienia. |
Creative
tabela
Nazwa pola | Typ | Opis |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | Identyfikator nadrzędnego obiektu reklamodawcy. Można je dołączyć do grupy Advertiser.common_data.id . |
dcm_placement_id | Numeric Id | Identyfikator miejsca docelowego w CM360 powiązany z tą kreacją. |
width_pixels | integer | Szerokość kreacji w pikselach. |
height_pixels | integer | Wysokość kreacji w pikselach. |
approval_status | [ApprovalStatus] | Tablica zawierająca obiekty ApprovalStatus reprezentujące stan kreacji na giełdach, które je zatwierdzają. |
expanding_direction | Enum | 0=Not Expandable |
creative_type | Enum |
0=Image or HTML5 |
Pixel
tabela
Nazwa pola | Typ | Opis |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | Identyfikator nadrzędnego obiektu reklamodawcy. Można je dołączyć do grupy Advertiser.common_data.id . |
partner_id | Numeric Id | Identyfikator obiektu partnera nadrzędnego. Można je dołączyć do grupy Partner.common_data.id . |
dcm_floodlight_id | Numeric Id | Identyfikator Floodlight w usłudze DFA powiązany z tym pikselem. |
allow_google_redirect | boolean | |
allow_rm_redirect | boolean | Gdy ustawisz wartość true , piksel będzie mógł być kodowany do/z Right Media. |
remarketing_enabled | boolean | Gdy 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_secure | boolean | Gdy 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 pola | Typ | Opis |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | Identyfikator nadrzędnego obiektu reklamodawcy. Można je dołączyć do grupy Advertiser.common_data.id . |
partner_id | Numeric Id | Identyfikator obiektu partnera zarządzającego reklamodawcy nadrzędnego. Można je dołączyć do grupy Partner.common_data.id . |
remarketing_enabled | boolean | Jeśli ustawisz wartość true , aktywność będzie używana do kierowania. |
ssl_required | boolean | Gdy ustawiona jest wartość true , tagi muszą być zgodne. |
InventorySource
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz źródła zasobów reklamowych. |
unclassified | boolean | Gdy ma wartość true , uwzględniane są wszystkie niesklasyfikowane zasoby reklamowe. |
inventory_name | string | Nazwa ź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_id | Numeric Id | Identyfikator 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_id | string | Identyfikator 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_micros | integer | Efektywna cena minimalna tego źródła zasobów reklamowych w milionowych częściach waluty. |
min_cpm_currency_code | string | Trzyliterowy kod waluty w formacie ISO 4217 używany w polu min_cpm_micros . |
UserList
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz listy użytkowników. |
name | string | Nazwa listy użytkowników widoczna w interfejsie. |
data_partner_id | Numeric Id | Moż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_pricing | UserListPricing | Typem 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 pola | Typ | Opis |
---|---|---|
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 pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz dla kanału. |
name | string | Nazwa 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_deleted | boolean | Gdy 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_channel | boolean | Gdy 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 pola | Typ | Opis |
---|---|---|
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 pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz giełdy. |
name | string | Nazwa giełdy, na przykład Ad Exchange . |
DataPartner
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz dla zewnętrznego dostawcy danych. |
name | string | Nazwa zewnętrznego dostawcy danych, np. BlueKai . |
UniversalSite
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz witryny uniwersalnej. |
name | string | Adres URL lub nazwa witryny, np. google.com lub Google Unclassified . |
SiteIdToPlacementId
tabela
Nazwa pola | Typ | Opis |
---|---|---|
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 pola | Typ | Opis |
---|---|---|
id | Numeric Id | Niepowtarzalny klucz do lokalizacji geograficznej. |
canonical_name | string | Ciąg znaków dotyczący lokalizacji i jego elementów nadrzędnych połączony przecinkami. Przykład: „Seattle, Washington, United States”. |
geo_name | string | Nazwa lokalizacji. Przykład: „Warszawa”. |
country_code | string | Kod kraju w formacie ISO-3166 alfa-2 dla tej lokalizacji geograficznej, np. US . |
region_code | string | Kod podziału ISO-3166-2 dla tej lokalizacji geograficznej, np. US-WA . Może brakować tego pola. |
city_name | string | Nazwa miasta dla tej lokalizacji geograficznej, np. Seattle . Może brakować tego pola. |
postal_code | string | Kod pocztowy tej lokalizacji geograficznej, na przykład 98033 . Może brakować tego pola. |
dma_code | integer | Kod DMA tej lokalizacji geograficznej, np. 510 . Może brakować tego pola. |
Language
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz dla tego języka. |
code | string | Kod 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 pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz dla danego kryterium urządzenia. |
is_mobile | boolean | Jeś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. |
name | string | Znajoma nazwa kryteriów dotyczących urządzenia. |
criteria_type | Enum | 0=OPERATING_SYSTEM |
operating_system_id | Numeric Id | Identyfikuje system operacyjny. To pole jest wypełniane tylko wtedy, gdy criteria_type ma wartość 0 . |
mobile_brand_name | string | Marka urządzenia. To pole jest wypełniane tylko wtedy, gdy criteria_type ma wartość 1 . |
mobile_model_name | string | Nazwa modelu urządzenia. To pole jest wypełniane tylko wtedy, gdy criteria_type ma wartość 1 . Opcjonalnie. |
mobile_make_model_id | Numeric Id | Określa numer modelu urządzenia. To pole jest wypełniane tylko wtedy, gdy criteria_type ma wartość 1 . Opcjonalnie. |
device_type | Enum | Wskazuje typ urządzenia. To pole jest wypełniane tylko wtedy, gdy criteria_type ma wartość 2 .
|
Browser
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz dla tej przeglądarki. |
is_mobile | boolean | Jeś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. |
name | string | Znajoma nazwa przeglądarki, na przykład Safari 5 . Nie zawiera ona pełnego ciągu znaków klienta użytkownika. |
Isp
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz tego dostawcy usług internetowych. |
is_mobile | boolean | Jeś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. |
name | string | Nazwa tego dostawcy usług internetowych. |
secondary_criteria_id | integer |
Opcjonalny alternatywny identyfikator, którego można użyć do identyfikacji jednostki. |
AppCollection
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz do tej kolekcji aplikacji. |
name | string | Nazwa tej kolekcji aplikacji. |