Tabele prywatne
Partner
tabela
Nazwa pola | Typ | Opis |
---|---|---|
common_data | EntityCommonData | Zawiera wspólne dane o tym partnera, takie jak imię i nazwisko oraz identyfikator. |
currency_code | string | Trzyliterowy kod waluty zgodny ze standardem ISO 4217, np. USD w przypadku złotego. |
exchange_settings | [ExchangeSettings] | Tablica typów ExchangeSettings zawierająca informacje, takie jak identyfikatory miejsc. Dostępne będą tylko włączone giełdy. |
default_partner_costs | PartnerCosts | Zawiera informacje o kosztach błędu automatycznego dla 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 o tym reklamodawcy, np. nazwę i identyfikator. |
partner_id | Numeric Id | Identyfikator obiektu partnera nadrzędnego. Można połączyć z: Partner.common_data.id . |
currency_code | string | Trzyliterowy kod waluty zgodny ze standardem ISO 4217, np. USD w przypadku złotego. |
timezone_code | string | Kanoniczny kod strefy czasowej, na przykład „America/Los_Angeles”. Jeśli dfa_configuration jest ustawiony jako 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ą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_configuration | Enum | 0=NONE |
dcm_network_id | Numeric Id | Identyfikator sieci CM360. Brakuje tej wartości, jeśli dcm_configuration jest ustawiony jako NONE . |
dcm_advertiser_id | Numeric Id | Identyfikator reklamodawcy CM360. Brakuje tej wartości, jeśli dcm_configuration jest ustawiony jako NONE . |
dcm_floodlight_group_id | Numeric Id | Brakuje tej wartości, jeśli dcm_configuration jest ustawiony 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_tags | boolean | Tagi OBA są włączone, gdy ta opcja ma wartość true . |
Campaign
tabela
Nazwa pola | Typ | Opis |
---|---|---|
common_data | EntityCommonData | Zawiera wspólne dane o tej kampanii, np. nazwę i identyfikator. |
advertiser_id | Numeric Id | Identyfikator obiektu reklamodawcy nadrzędnego. Można połączyć z: Advertiser.common_data.id |
budget | Budget | Planowany budżet tej kampanii. Uwzględnia godzinę rozpoczęcia i zakończenia. |
frequency_cap | FrequencyCap | Limit wyświetleń na użytkownika aktywny w tej kampanii. Brakuje tej wartości, jeśli nie ustawiono limitu wyświetleń na użytkownika. |
default_target_list | TargetList | Zawiera informacje o ustawieniach kierowania obowiązujących w tej kampanii. |
uses_video_creatives | boolean | Jeśli ma wartość Prawda, będą zalecane zamówienia reklamowe wideo. |
uses_display_creatives | boolean | Jeśli ma wartość Prawda, displayowe zamówienia reklamowe będą zalecane. |
uses_audio_creatives | boolean | Jeśli ma wartość Prawda, będą zalecane zamówienia reklamowe audio. |
objective | Enum |
Wartości to:1 = BRAND_AWARENESS 2 = ONLINE_ACTION 3 = OFFLINE_ACTION 4 = APP_INSTALL |
metric | Enum |
Kluczowy wskaźnik wydajności Używaj tego pola, aby ś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_description | String | Gdy dane mają wartość OTHER , jest to ich krótki opis. |
metric_amount_micros | integer | Docelowa wartość wskaźnika w mikro. |
InsertionOrder
tabela
Nazwa pola | Typ | Opis |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | Identyfikator obiektu reklamodawcy nadrzędnego. Można połączyć z: Advertiser.common_data.id . |
campaign_id | Numeric Id | Identyfikator obiektu nadrzędnego kampanii. |
overall_budget | Budget | Całkowity budżet danego zamówienia reklamowego. Uwzględnia godzinę rozpoczęcia i zakończenia. |
scheduled_segments | [Budget] | Zawiera dowolne zaplanowane segmenty budżetu. Ta tablica może być pusta lub jej brakować. |
frequency_cap | FrequencyCap | Limit wyświetleń na użytkownika aktywny dla tego zamówienia reklamowego. Brakuje tej wartości, 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 obiektu nadrzędnego zamówienia reklamowego. Można połączyć za pomocą
InsertionOrder.common_data.id |
creative_ids | [Numeric Id] | Tablica kreacji przypisanych do tego elementu zamówienia. Można połączyć z: Creative.common_data.id . |
max_cpm_advertiser_micros | integer | Maksymalna wartość CPM w mikrowalucie reklamodawcy. |
performance_goal | Enum | 0=NONE (vCPM jest wyłączony)1=CPC |
goal_advertiser_micros | integer | Cel vCPM w mikrowalucie reklamodawcy. Brakuje tej wartości, jeśli performance_goal jest ustawiony jako NONE . |
partner_revenue_model | PartnerRevenueModel | Model rozliczeniowy partnera używany w przypadku tego elementu zamówienia. |
cost_tracking_pixels | [CostTrackingPixel] | Tablica elementów CostTrackingPixels przypisanych do śledzenia tego elementu zamówienia. |
Budget | Budget | Całkowity budżet danego elementu zamówienia. Uwzględnia godzinę rozpoczęcia i zakończenia. |
frequency_cap | FrequencyCap | Limit 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_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 obiektu reklamodawcy nadrzędnego. Można połączyć z: Advertiser.common_data.id . |
dcm_placement_id | Numeric Id | Identyfikator miejsca docelowego w CM360 powiązanego z tą kreacją. |
width_pixels | integer | Szerokość kreacji w pikselach. |
height_pixels | integer | Wysokość kreacji w pikselach. |
approval_status | [ApprovalStatus] | Tablica z obiektami ApprovalStatus reprezentującymi stan kreacji na giełdach, które zatwierdzają kreacje. |
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 obiektu reklamodawcy nadrzędnego. Można połączyć z: Advertiser.common_data.id . |
partner_id | Numeric Id | Identyfikator obiektu partnera nadrzędnego. Można połączyć z: Partner.common_data.id . |
dcm_floodlight_id | Numeric Id | Identyfikator Floodlight Floodlight powiązany z tym pikselem. |
allow_google_redirect | boolean | |
allow_rm_redirect | boolean | Gdy ustawisz wartość true , piksel może być przekierowywany do/z Right Media. |
remarketing_enabled | boolean | Gdy ustawisz wartość true , piksel będzie mógł być używany do kierowania. Ta wartość występuje tylko wtedy, gdy w polu dfa_configuration reklamodawcy nadrzędnego ustawiono wartość NONE . |
is_secure | boolean | Gdy ustawisz wartość true , piksel będzie używać protokołu HTTPS. Ta wartość występuje tylko wtedy, gdy w polu dfa_configuration reklamodawcy nadrzędnego ustawiono wartość NONE . |
Floodlight Activity
tabela
Nazwa pola | Typ | Opis |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | Identyfikator obiektu reklamodawcy nadrzędnego. Można połączyć z: Advertiser.common_data.id . |
partner_id | Numeric Id | Identyfikator obiektu partnera zarządzającego reklamodawcy nadrzędnego. Można połączyć z: Partner.common_data.id . |
remarketing_enabled | boolean | Jeśli zasada ma wartość true , aktywność może być używana do kierowania. |
ssl_required | boolean | Gdy ustawisz 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 ustawisz wartość true , uwzględnione zostaną wszystkie niesklasyfikowane zasoby reklamowe. |
inventory_name | string | Nazwa źródła zasobów reklamowych wyświetlana w interfejsie. Tego pola może brakować. Jeśli brakuje parametru inventory_name , a wartość unclassified ma wartość prawda, odnosi się do niesklasyfikowanych zasobów reklamowych na giełdzie. Jeśli brakuje wartości, a 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 połączyć z: SupportedExchange.id . |
accessing_advertisers | [Numeric Id] | Tablica identyfikatorów reklamodawców, które można połączyć za pomocą parametru Advertiser.common_data.id , mających uprawnienia do używania 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 będzie niedostępne. |
external_id | string | Identyfikator zewnętrzny przypisany do tego źródła zasobów reklamowych i zdefiniowany przez giełdę, zwykle nazywany umową lub identyfikatorem sprzedawcy. Tego pola może brakować. |
min_cpm_micros | integer | Efektywna cena minimalna tego źródła zasobów reklamowych w mikro waluty. |
min_cpm_currency_code | string | 3-literowy kod waluty w formacie ISO 4217 używany na potrzeby: 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 połączyć z: DataPartner.id . To pole jest ustawione tylko w przypadku list użytkowników dostarczanych przez inne firmy. |
accessing_advertisers | [Numeric Id] | Tablica identyfikatorów reklamodawców z uprawnieniami do używania tej listy użytkowników, którą można złączyć z zasadą Advertiser.common_data.id .Uwaga: jeśli lista użytkowników jest dostępna dla WSZYSTKICH reklamodawców, to pole nie będzie dostępne. |
partner_pricing | UserListPricing | Typ kosztu to zawsze CPM, a kod waluty to USD. |
advertiser_pricings | [UserListAdvertiserPricing] | Typ kosztu to zawsze CPM, a kod waluty to USD. |
CustomAffinity
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id |
Numeric Id |
Unikalny klucz niestandardowej reklamy o podobnych zainteresowaniach. |
name |
string |
Nazwa niestandardowej listy odbiorców o podobnych zainteresowaniach wyświetlana w interfejsie. |
description |
string |
Opis niestandardowej grupy odbiorców o podobnych zainteresowaniach widoczny w interfejsie. |
advertiser_id |
Numeric Id |
Identyfikator obiektu reklamodawcy nadrzędnego. Można połączyć z: Advertiser.common_data.id . |
UniversalChannel
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz kanału. |
name | string | Nazwa kanału wyświetlana w interfejsie. |
site_ids |
[Numeric Id] |
Tablica z identyfikatorami elementów UniversalSite
na tym kanale. Można połączyć z: UniversalSite.id . |
accessing_advertisers | [Numeric Id] | Tablica identyfikatorów reklamodawców, które można połączyć za pomocą parametru Advertiser.common_data.id , mających uprawnienia do używania 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 są już kierowane na ten kanał, nadal będą to robić. |
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 poziomów 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 wyświetlana w interfejsie. |
advertiser_id |
Numeric Id |
Identyfikator obiektu reklamodawcy nadrzędnego. Można połączyć z: Advertiser.common_data.id . |
Tabele publiczne
SupportedExchange
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz giełdy. |
name | string | Nazwa giełdy, np. Ad Exchange . |
DataPartner
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz 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 miejsc docelowych w internecie. |
placementId |
Numeric Id |
Adres URL lub nazwa miejsca docelowego w witrynie, np. google.com lub Google Unclassified . |
GeoLocation
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz lokalizacji geograficznej. |
canonical_name | string | Ciąg znaków powiązany z lokalizacją i jej elementami nadrzędnymi. Przykład: „Seattle, Waszyngton, Stany Zjednoczone”. |
geo_name | string | Nazwa lokalizacji. Przykład: „Słupsk”. |
country_code | string | Kod kraju zgodny ze standardem ISO-3166 alfa-2 dla tej lokalizacji geograficznej, na przykład US . |
region_code | string | Kod podziału ISO-3166-2 dla tej lokalizacji geograficznej, na przykład US-WA . Może brakować tego pola. |
city_name | string | Nazwa miasta w danej lokalizacji geograficznej, np. Seattle . Może brakować tego pola. |
postal_code | string | Kod pocztowy lokalizacji geograficznej, na przykład 98033 . Może brakować tego pola. |
dma_code | integer | Kod DMA dla danej 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 jeden z zh_CN w przypadku języka chińskiego (uproszczony), zh_TW (chiński tradycyjny) i other w przypadku innych języków. |
DeviceCriteria
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz dla tego kryterium urządzenia. |
is_mobile | boolean | Jeśli wartość to prawda, to kryterium obejmuje tylko urządzenia mobilne. W przypadku wartości false (fałsz) ta pozycja obejmuje tylko urządzenia inne niż mobilne, nawet jeśli ich nazwa (np. „Inny”) 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 | Identyfikuje 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 tej przeglądarki. |
is_mobile | boolean | Jeśli wartość to prawda, to kryterium obejmuje tylko urządzenia mobilne. W przypadku wartości false (fałsz) ta pozycja obejmuje tylko urządzenia inne niż mobilne, nawet jeśli ich nazwa (np. „Inny”) 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 wartość to prawda, to kryterium obejmuje tylko urządzenia mobilne. W przypadku wartości false (fałsz) ta pozycja obejmuje tylko urządzenia inne niż mobilne, nawet jeśli ich nazwa (np. „Inny”) nie oznacza tego. |
name | string | Nazwa tego dostawcy usług internetowych. |
secondary_criteria_id | integer |
Opcjonalny identyfikator alternatywny, którego można użyć do identyfikacji elementu. |
AppCollection
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz tej kolekcji aplikacji. |
name | string | Nazwa tej kolekcji aplikacji. |