Tabele prywatne
Partner
tabela
Nazwa pola | Typ | Opis |
---|---|---|
common_data | EntityCommonData | Zawiera wspólne dane o tym partnerze, takie jak nazwa i identyfikator. |
currency_code | string | Trzyliterowy 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_costs | PartnerCosts | Zawiera informacje o domyślnych kosztach dla tego partnera. |
default_partner_revenue_model | PartnerRevenueModel | Zawiera informacje o domyślnym modelu przychodów dla tego partnera. |
default_target_list | TargetList | Zawiera domyślne opcje kierowania dla partnera. Obecnie obsługiwane jest tylko domyślne kierowanie geograficzne. |
Advertiser
tabela
Nazwa pola | Typ | Opis |
---|---|---|
common_data | EntityCommonData | Zawiera typowe dane o tym reklamodawcy, np. nazwę i identyfikator. |
partner_id | Numeric Id | 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 . |
dcm_configuration | Enum | 0=NONE |
dcm_network_id | Numeric Id | Identyfikator sieci CM360. Ta wartość nie będzie widoczna, jeśli dcm_configuration jest ustawiona jako NONE . |
dcm_advertiser_id | Numeric Id | Identyfikator reklamodawcy CM360. Ta wartość nie będzie widoczna, jeśli dcm_configuration jest ustawiona jako NONE . |
dcm_floodlight_group_id | Numeric Id | Ta 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_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. Dołączanie do Advertiser.common_data.id |
budget | Budget | Planowany budżet tej kampanii. Obejmuje czas rozpoczęcia i zakończenia. |
frequency_cap | FrequencyCap | Limit 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_list | TargetList | Zawiera informacje o kierowaniu stosowanym w tej kampanii. |
uses_video_creatives | boolean | Jeśli ma wartość Prawda, zalecane są zamówienia reklamowe z wstawkami 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, zalecane są zamówienia reklamowe z reklamami audio. |
objective | Enum |
Wartości:1 = BRAND_AWARENESS 2 = ONLINE_ACTION 3 = OFFLINE_ACTION 4 = APP_INSTALL |
metric | Enum |
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_description | String | Gdy dane dotyczą OTHER , jest to krótki opis tych danych. |
metric_amount_micros | integer | Wartość docelowa danych wyrażona w mikro. |
InsertionOrder
tabela
Nazwa pola | Typ | Opis |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | Identyfikator obiektu reklamodawcy nadrzędnego. Można dołączyć do Advertiser.common_data.id . |
campaign_id | Numeric Id | Identyfikator nadrzędnego obiektu kampanii. |
overall_budget | Budget | Cał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_cap | FrequencyCap | 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. |
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. 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_micros | integer | Maksymalna wartość CPM w mikro w walucie reklamodawcy. |
performance_goal | Enum | 0=NONE (vCPM jest wyłączona)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 tym elemencie zamówienia. |
cost_tracking_pixels | [CostTrackingPixel] | Tablica pikseli śledzenia kosztów przypisanych do śledzenia tego elementu zamówienia. |
Budget | Budget | Ogólny budżet tego 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. Brakuje tej wartości, jeśli nie ustawiono limitu wyświetleń na użytkownika. |
partner_costs | PartnerCosts | |
target_list | TargetList | Zawiera informacje o kierowaniu, które jest aktywne w przypadku tego 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 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 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 nadrzędnego obiektu partnera. Dołączanie z Partner.common_data.id . |
dcm_floodlight_id | Numeric Id | 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 . |
Floodlight Activity
tabela
Nazwa pola | Typ | Opis |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | Identyfikator obiektu reklamodawcy nadrzędnego. Dołączanie z Advertiser.common_data.id . |
partner_id | Numeric Id | Identyfikator obiektu partnera zarządzającego nadrzędnego reklamodawcy. Można połączyć z: Partner.common_data.id . |
remarketing_enabled | boolean | Gdy to ustawienie ma wartość true , ta aktywność będzie dostępna do użycia w kierowaniu. |
ssl_required | boolean | Gdy wartość to 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 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. |
exchange_id | Numeric Id | Identyfikator 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_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 . |
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 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_pricing | UserListPricing | Typ 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 pola | Typ | Opis |
---|---|---|
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 pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz kanału. |
name | string | Nazwa 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_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 |
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. Dołączanie z Advertiser.common_data.id . |
Tabele publiczne
SupportedExchange
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz wymiany. |
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 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 pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz lokalizacji geograficznej. |
canonical_name | string | Łańcuch znaków rozdzielonych przecinkami zawierający lokalizację i jej nadrzędne. Przykład: „Seattle, Waszyngton, Stany Zjednoczone”. |
geo_name | string | Nazwa lokalizacji. Przykład: „Seattle”. |
country_code | string | Kod kraju w formacie ISO-3166 alfa-2 odpowiadający tej lokalizacji geograficznej, np. US . |
region_code | string | Kod podziału podrzędnego zgodny z ISO-3166-2 dla tej lokalizacji geograficznej, np. US-WA . To pole może być puste. |
city_name | string | Nazwa miasta w danej lokalizacji geograficznej, np. Seattle . To pole może być puste. |
postal_code | string | Kod pocztowy lokalizacji geograficznej, na przykład 98033 . To pole może być puste. |
dma_code | integer | Kod DMA tej lokalizacji geograficznej, np. 510 . To pole może być puste. |
Language
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz dla tego języka. |
code | string | 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. |
DeviceCriteria
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | 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. |
name | string | Znajoma nazwa kryteriów Urządzenie. |
criteria_type | Enum | 0=OPERATING_SYSTEM |
operating_system_id | Numeric Id | Identyfikuje system operacyjny. To pole jest wypełnione tylko wtedy, gdy criteria_type ma wartość 0 . |
mobile_brand_name | string | Marka urządzenia. To pole jest wypełnione tylko wtedy, gdy criteria_type ma wartość 1 . |
mobile_model_name | string | Nazwa modelu urządzenia. To pole jest wypełnione tylko wtedy, gdy criteria_type ma wartość 1 . Opcjonalnie: |
mobile_make_model_id | Numeric Id | Identyfikuje numer modelu urządzenia. To pole jest wypełnione tylko wtedy, gdy criteria_type ma wartość 1 . Opcjonalnie: |
device_type | Enum | Wskazuje typ urządzenia. To pole jest wypełnione 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 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. |
Isp
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz dostawcy usług internetowych. |
is_mobile | boolean | 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. |
AppCollection
tabela
Nazwa pola | Typ | Opis |
---|---|---|
id | Numeric Id | Unikalny klucz tej kolekcji aplikacji. |
name | string | Nazwa tej kolekcji aplikacji. |