Private Tables
Partner
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
common_data | EntityCommonData | Contiene i dati comuni relativi a questo partner, come nome e ID. |
currency_code | string | Codice valuta ISO 4217 di tre lettere, ad esempio USD per i dollari USA. |
exchange_settings | [ExchangeSettings] | Array di tipi ExchangeSettings contenenti informazioni come gli ID dei posti. Saranno presenti solo le piattaforme di scambio pubblicitario attivate. |
default_partner_costs | PartnerCosts | Contiene informazioni sui costi predefiniti per questo partner. |
default_partner_revenue_model | PartnerRevenueModel | Contiene informazioni sul modello di entrate predefinito per questo partner. |
default_target_list | TargetList | Contiene le opzioni di targeting predefinite per il partner. Attualmente è supportato solo il targeting geografico predefinito. |
Advertiser
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
common_data | EntityCommonData | Contiene i dati comuni relativi a questo inserzionista, come nome e ID. |
partner_id | Numeric Id | L'ID dell'oggetto partner principale. Possibile partecipare con Partner.common_data.id . |
currency_code | string | Codice valuta ISO 4217 espresso con tre lettere, ad esempio USD per i dollari USA. |
timezone_code | string | Il codice del fuso orario canonico, ad esempio "America/Los_Angeles". Se dfa_configuration è impostato su NORMAL o HYBRID , questo valore corrisponderà al fuso orario dell'inserzionista DFA associato. |
landing_page_url | string | L'URL pagina di destinazione predefinito. |
available_channel_ids | [integer] | Array di numeri interi contenenti i canali disponibili associati a questo inserzionista. Possibile partecipare con UniversalChannel.id . |
blacklist_channel_id | [integer] | Array di numeri interi contenenti i canali nella lista nera per questo inserzionista. Partecipabile con UniversalChannel.id . |
dcm_configuration | Enum | 0=NONE |
dcm_network_id | Numeric Id | L'ID della rete CM360. Questo valore non sarà presente se dcm_configuration è impostato su NONE . |
dcm_advertiser_id | Numeric Id | L'ID dell'inserzionista CM360. Questo valore non sarà presente se dcm_configuration è impostato su NONE . |
dcm_floodlight_group_id | Numeric Id | Questo valore non sarà presente se dcm_configuration è impostato su NONE . |
dcm_syncable_site_ids | [Numeric Id] | Array di Numeric Id tipi per ogni sito sincronizzabile di questo inserzionista. |
enable_oba_tags | boolean | I tag OBA vengono attivati quando questo valore è impostato su true . |
Campaign
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
common_data | EntityCommonData | Contiene i dati comuni relativi a questa campagna, come il nome e l'ID. |
advertiser_id | Numeric Id | L'ID dell'oggetto inserzionista principale. Possibile abbinamento con Advertiser.common_data.id |
budget | Budget | Il budget pianificato per questa campagna. Sono incluse le ore di inizio e di fine. |
frequency_cap | FrequencyCap | La quota limite attiva per questa campagna. Questo valore non sarà presente se non è impostata una quota limite. |
default_target_list | TargetList | Contiene informazioni sul targeting in vigore per questa campagna. |
uses_video_creatives | boolean | Se impostato su true, verranno consigliati gli ordini di inserzione video. |
uses_display_creatives | boolean | Se impostato su true, verranno consigliati gli ordini di inserzione display. |
uses_audio_creatives | boolean | Se il valore è impostato su true, vengono consigliati gli ordini di inserzione audio. |
objective | Enum |
I valori sono:1 = BRAND_AWARENESS 2 = ONLINE_ACTION 3 = OFFLINE_ACTION 4 = APP_INSTALL |
metric | Enum |
Indicatore chiave di prestazione. Utilizza questo campo per tenere traccia della metrica principale che utilizzerai per valutare il successo della campagna.
I valori possibili sono: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 | Quando la metrica è OTHER , questa è la descrizione breve della metrica. |
metric_amount_micros | integer | L'importo target per la metrica in micro. |
InsertionOrder
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | L'ID dell'oggetto inserzionista principale. Possibile partecipare con Advertiser.common_data.id . |
campaign_id | Numeric Id | L'ID dell'oggetto della campagna principale. |
overall_budget | Budget | Il budget complessivo per questo ordine di inserzione. Sono incluse l'ora di inizio e l'ora di fine. |
scheduled_segments | [Budget] | Contiene eventuali segmenti di budget pianificati. Questo array potrebbe essere vuoto o completamente assente. |
frequency_cap | FrequencyCap | La quota limite attiva per questo ordine di inserzione. Questo valore non sarà presente se non è impostata una quota limite. |
default_partner_costs | PartnerCosts | |
default_target_list | TargetList |
LineItem
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
common_data |
EntityCommonData |
|
line_item_type | Enum |
0=RTB |
insertion_order_id |
Numeric Id |
L'ID dell'oggetto ordine di inserzione principale. Partecipabile con
InsertionOrder.common_data.id . |
creative_ids | [Numeric Id] | Un array di creatività assegnate a questo elemento pubblicitario. Possibile partecipare con Creative.common_data.id . |
max_cpm_advertiser_micros | integer | Il valore CPM massimo in micro della valuta dell'inserzionista. |
performance_goal | Enum | 0=NONE (il vCPM è disattivato)1=CPC |
goal_advertiser_micros | integer | L'obiettivo vCPM in micro della valuta dell'inserzionista. Questo valore non sarà presente se performance_goal è impostato su NONE . |
partner_revenue_model | PartnerRevenueModel | Il modello di entrate del partner utilizzato per questo elemento pubblicitario. |
cost_tracking_pixels | [CostTrackingPixel] | Array di CostTrackingPixels assegnati al monitoraggio di questo elemento pubblicitario. |
Budget | Budget | Il budget complessivo per questo elemento pubblicitario. Include l'ora di inizio e l'ora di fine. |
frequency_cap | FrequencyCap | La quota limite attiva per questo elemento pubblicitario. Questo valore non sarà presente se non è impostata una quota limite. |
partner_costs | PartnerCosts | |
target_list | TargetList | Contiene informazioni sul targeting in vigore per questo elemento pubblicitario. |
Creative
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | L'ID dell'oggetto inserzionista principale. Possibile partecipare con Advertiser.common_data.id . |
dcm_placement_id | Numeric Id | L'ID posizionamento CM360 associato a questa creatività. |
width_pixels | integer | La larghezza della creatività in pixel. |
height_pixels | integer | L'altezza della creatività in pixel. |
approval_status | [ApprovalStatus] | Un array contenente oggetti ApprovalStatus che rappresentano lo stato delle creatività nelle piattaforme di scambio pubblicitario che le approvano. |
expanding_direction | Enum | 0=Not Expandable |
creative_type | Enum |
0=Image or HTML5 |
Pixel
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | L'ID dell'oggetto inserzionista principale. Possibile partecipare con Advertiser.common_data.id . |
partner_id | Numeric Id | L'ID dell'oggetto partner principale. Possibile partecipare con Partner.common_data.id . |
dcm_floodlight_id | Numeric Id | L'ID Floodlight DFA associato a questo pixel. |
allow_google_redirect | boolean | |
allow_rm_redirect | boolean | Se impostato su true , il pixel viene abilitato per il reidrezione da/verso Right Media. |
remarketing_enabled | boolean | Se impostato su true , questo pixel verrà attivato per l'utilizzo nel targeting. Questo valore sarà presente solo se dfa_configuration dell'inserzionista principale è impostato su NONE . |
is_secure | boolean | Se impostato su true , questo pixel utilizzerà HTTPS. Questo valore sarà presente solo se dfa_configuration dell'inserzionista principale è impostato su NONE . |
Floodlight Activity
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | L'ID dell'oggetto inserzionista principale. Possibile partecipare con Advertiser.common_data.id . |
partner_id | Numeric Id | L'ID dell'oggetto partner di gestione dell'inserzionista principale. È possibile partecipare con Partner.common_data.id . |
remarketing_enabled | boolean | Se impostato su true , questa attività verrà attivata per l'utilizzo nel targeting. |
ssl_required | boolean | Se impostato su true , i tag devono essere conformi. |
InventorySource
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
id | Numeric Id | Chiave univoca per l'origine dell'inventario. |
unclassified | boolean | Se impostato su true , viene incluso tutto l'inventario non classificato. |
inventory_name | string | Il nome dell'origine dell'inventario mostrato nell'interfaccia utente. Questo campo potrebbe non essere presente. Se inventory_name è assente e unclassified è true, si riferisce all'inventario non classificato della piattaforma di scambio pubblicitario. Se non è presente e unclassified è falso, l'origine dell'inventario è l'inventario a livello di piattaforma di scambio pubblicitario. |
exchange_id | Numeric Id | L'ID della piattaforma di scambio pubblicitario in cui è disponibile questa origine dell'inventario. È possibile partecipare con SupportedExchange.id . |
accessing_advertisers | [Numeric Id] | Un array di ID inserzionista, unibile con Advertiser.common_data.id , autorizzato a utilizzare questa origine dell'inventario.Nota: se un'origine dell'inventario è disponibile per TUTTI gli inserzionisti, questo campo non sarà presente. |
external_id | string | L'ID esterno assegnato a questa origine dell'inventario e definito dalla piattaforma di scambio pubblicitario, in genere noto come deal o ID venditore. Questo campo potrebbe non essere presente. |
min_cpm_micros | integer | Il prezzo minimo effettivo di questa origine dell'inventario in micro valuta. |
min_cpm_currency_code | string | Il codice valuta ISO 4217 di 3 lettere utilizzato per min_cpm_micros . |
UserList
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
id | Numeric Id | Chiave univoca per l'elenco di utenti. |
name | string | Il nome dell'elenco di utenti come mostrato nell'interfaccia utente. |
data_partner_id | Numeric Id | Possibile partecipare con DataPartner.id . Questo campo viene impostato solo per gli elenchi di utenti di terze parti. |
accessing_advertisers | [Numeric Id] | Un array di ID inserzionista, unibili a Advertiser.common_data.id , autorizzati a utilizzare questo elenco di utenti.Nota: se un elenco utenti è disponibile per TUTTI gli inserzionisti, questo campo non sarà presente. |
partner_pricing | UserListPricing | Il tipo di costo sarà sempre CPM e il codice valuta sarà sempre USD. |
advertiser_pricings | [UserListAdvertiserPricing] | Il tipo di costo sarà sempre CPM e il codice valuta sarà sempre USD. |
CustomAffinity
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
id |
Numeric Id |
Chiave univoca per l'affinità personalizzata. |
name |
string |
Il nome dell'affinità personalizzata come mostrato nell'interfaccia utente. |
description |
string |
La descrizione dell'affinità personalizzata mostrata nell'interfaccia utente. |
advertiser_id |
Numeric Id |
L'ID dell'oggetto inserzionista principale. Possibile partecipare con Advertiser.common_data.id . |
UniversalChannel
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
id | Numeric Id | Chiave univoca per il canale. |
name | string | Il nome del canale come mostrato nell'interfaccia utente. |
site_ids |
[Numeric Id] |
Un array contenente gli ID dei UniversalSite
in questo canale. Possibile partecipare con UniversalSite.id . |
accessing_advertisers | [Numeric Id] | Un array di ID inserzionista, unibili a Advertiser.common_data.id , autorizzati a utilizzare questo canale.Nota: se un canale è disponibile per TUTTI gli inserzionisti, questo campo non sarà presente. |
is_deleted | boolean | Se impostato su true , nessun nuovo elemento pubblicitario potrà avere come target questo canale, ma gli elementi pubblicitari esistenti che hanno già questo canale come target continueranno a farlo. |
is_brand_safe_channel | boolean | Se impostato su true , questo canale può essere utilizzato per il filtro per la sicurezza del brand. Al momento, true è disponibile solo per i quattro livelli di sicurezza del brand integrati. |
NegativeKeywordList
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
id |
Numeric Id |
Chiave univoca per l'elenco di parole chiave escluse. |
name |
string |
Il nome dell'elenco di parole chiave escluse come mostrato nell'interfaccia utente. |
advertiser_id |
Numeric Id |
L'ID dell'oggetto inserzionista principale. Possibile partecipare con Advertiser.common_data.id . |
Tabelle pubbliche
SupportedExchange
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
id | Numeric Id | Chiave univoca per lo scambio. |
name | string | Nome della piattaforma di scambio pubblicitario, ad esempio Ad Exchange . |
DataPartner
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
id | Numeric Id | Chiave univoca per il fornitore di dati di terze parti. |
name | string | Nome del fornitore di dati di terze parti, ad esempio BlueKai . |
UniversalSite
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
id | Numeric Id | Chiave univoca per il sito universale. |
name | string | L'URL o il nome del sito, ad esempio google.com o Google Unclassified . |
SiteIdToPlacementId
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
siteId |
Numeric Id |
Mappatura dall'ID sito universale agli ID posizionamento web. |
placementId |
Numeric Id |
L'URL o il nome del posizionamento web, ad esempio google.com o Google Unclassified . |
GeoLocation
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
id | Numeric Id | Chiave univoca per la posizione geografica. |
canonical_name | string | Stringa concatenata con virgole della stazione di ricarica e dei relativi elementi principali. Esempio: "Seattle, Washington, Stati Uniti". |
geo_name | string | Nome della località. Esempio: "Seattle". |
country_code | string | Codice paese ISO-3166 alpha-2 per questa posizione geografica, ad esempio US . |
region_code | string | Codice di suddivisione ISO-3166-2 per questa geolocalizzazione, ad esempio US-WA . Questo campo potrebbe non essere presente. |
city_name | string | Il nome della città per questa posizione geografica, ad esempio Seattle . Questo campo potrebbe non essere presente. |
postal_code | string | Il codice postale di questa posizione geografica, ad esempio 98033 . Questo campo potrebbe non essere presente. |
dma_code | integer | Il codice DMA per questa posizione geografica, ad esempio 510 . Questo campo potrebbe mancare. |
Language
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
id | Numeric Id | Chiave univoca per questa lingua. |
code | string | Il codice ISO-639-1 per questa lingua o uno dei valori zh_CN per il cinese (semplificato), zh_TW per il cinese (tradizionale) o other per altre lingue. |
DeviceCriteria
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
id | Numeric Id | Chiave univoca per questo criterio del dispositivo. |
is_mobile | boolean | Se true, questo criterio riguarda solo i dispositivi mobili. Se false, questa voce riguarda solo i dispositivi non mobili, anche se il nome (ad es. "Altro") non lo indica. |
name | string | Il nome familiare dei criteri dei dispositivi. |
criteria_type | Enum | 0=OPERATING_SYSTEM |
operating_system_id | Numeric Id | Identifica il sistema operativo. Questo campo viene compilato solo quando criteria_type è 0 . |
mobile_brand_name | string | Il nome del brand del dispositivo. Questo campo viene compilato solo quando criteria_type è 1 . |
mobile_model_name | string | Il nome del modello del dispositivo. Questo campo viene compilato solo quando criteria_type è 1 . (Facoltativo) |
mobile_make_model_id | Numeric Id | Identifica il numero di modello del dispositivo. Questo campo viene compilato solo quando criteria_type è 1 . (Facoltativo) |
device_type | Enum | Indica il tipo di dispositivo. Questo campo viene compilato solo quando criteria_type è 2 .
|
Browser
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
id | Numeric Id | Chiave univoca per questo browser. |
is_mobile | boolean | Se true, questo criterio riguarda solo i dispositivi mobili. Se il valore è false, questa voce riguarda solo i dispositivi non mobili, anche se il nome (ad esempio, "Altro") non lo indica. |
name | string | Il nome familiare del browser, ad esempio Safari 5 . Non include la stringa completa dello user agent. |
Isp
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
id | Numeric Id | Chiave univoca per questo provider di servizi internet. |
is_mobile | boolean | Se true, questo criterio riguarda solo i dispositivi mobili. Se false, questa voce riguarda solo i dispositivi non mobili, anche se il nome (ad es. "Altro") non lo indica. |
name | string | Il nome di questo provider di servizi internet. |
secondary_criteria_id | integer |
ID alternativo facoltativo che può essere utilizzato per identificare l'entità. |
AppCollection
tabella
Nome campo | Tipo | Descrizione |
---|---|---|
id | Numeric Id | Chiave univoca per questa raccolta di app. |
name | string | Il nome di questa raccolta di app. |