REST Resource: exchanges.publishers

Risorsa: Publisher

Incapsula un singolo publisher.

Rappresentazione JSON 
{
  "name": string,
  "externalPublisherId": string,
  "externalPublisherIds": [
    string
  ],
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "mediumCapability": enum (MediumCapability),
  "description": string,
  "contactInfo": [
    string
  ],
  "commitmentCapability": [
    enum (CommitmentCapability)
  ],
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "ceilingPrice": {
    object (Money)
  },
  "generalCapability": string,
  "tvMetadata": {
    object (TVMetadata)
  },
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ]
}
Campi
name

string

Solo output. Nome della route relativa per questo publisher. Deve essere nel formato: "exchanges/{seller_id}/publishers/{publisherId} Esempio: "exchanges/1234/publishers/5678".
externalPublisherId

string

Obbligatorio. [DEPRECATO] Questo campo verrà presto sostituito da externalPublisherIds[]. ID publisher univoco fornito dall'exchange. Deve corrispondere all'ID publisher inviato nelle richieste di offerta.

Massimo 100 caratteri. I caratteri consentiti sono alfanumerici, trattino basso, trattino e punto.
externalPublisherIds[]

string

Facoltativo. ID publisher forniti dall'exchange. Ogni ID deve essere univoco e corrispondere all'ID publisher inviato nelle richieste di offerta.

Massimo 10 conteggi. Massimo 100 caratteri per ID. I caratteri consentiti sono alfanumerici, trattino basso, trattino e punto.
displayName

string

Obbligatorio. Il nome visualizzato di questo publisher. Deve essere codificato in UTF-8 con una dimensione massima di 30 caratteri.
status

enum (DiscoveryObjectStatus)

Obbligatorio. Lo stato di questo publisher. I publisher con stato PAUSED o REMOVED non vengono mostrati agli inserzionisti di DV3.
mediumCapability

enum (MediumCapability)

Obbligatorio. Il mezzo su cui questo publisher prevede di ospitare i propri annunci.
description

string

Obbligatorio. Il testo della descrizione per questo publisher. Deve essere codificato in UTF-8 con una dimensione massima di 1000 caratteri.
contactInfo[]

string

Obbligatorio. Email dei punti di contatto per gli inserzionisti per comunicare con il publisher. Massimo 10 contatti. Ogni contatto può contenere al massimo 100 caratteri. Esempio: [US contact - John Smith: john.smith@abc.com].
commitmentCapability[]

enum (CommitmentCapability)

Facoltativo. Tipi di impegno supportati da questo publisher.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Obbligatorio. Suddivisione delle previsioni per l'inventario di questo publisher. Gli inserzionisti di DV3 possono visualizzare e filtrare queste suddivisioni. È richiesta la suddivisione delle previsioni per dominio.
logoUrl

string

Solo output. L'URL del logo di questo publisher.
floorPrice

object (Money)

Facoltativo. Il prezzo minimo di questo publisher. Deve avere lo stesso codice valuta del prezzo massimo.
ceilingPrice

object (Money)

Facoltativo. Il prezzo massimo di questo publisher. Deve avere lo stesso codice valuta del prezzo minimo.
generalCapability

string

Facoltativo. Descrizione generale in formato di testo libero. Deve essere codificato in UTF-8 con una dimensione massima di 200 caratteri. Questa descrizione può riguardare la SOV(Share of Voice), il CPD o la garanzia del volume. Esempio di descrizione: "CPD, High Impact, 69% avg. viewability"
tvMetadata

object (TVMetadata)

Facoltativo. Metadati per il publisher che offre contenuti TV. Obbligatorio quando la funzionalità del mezzo include la TV. Non applicabile quando la funzionalità del mezzo non include la TV.
urgOwners[]

enum (UnderRepresentedGroup)

Facoltativo. Gruppi sottorappresentati di cui il proprietario è membro, se presenti.

MediumCapability

Enum della funzionalità del mezzo. Il frontend del Marketplace (all'interno del modulo Inventario di DV360) include diverse sezioni per l'inventario. "Digitale: include publisher e pacchetti di aste che riguardano l'inventario display, video (inclusi TV connesse a internet e OTT) e audio." "TV: questa è la nostra nuova sezione dedicata per scoprire l'inventario TV connesse a internet e OTT. TV connesse a internet e OTT sono definiti come segue: "TV connesse a internet (CTV) include tutti i dispositivi che rispondono alle seguenti descrizioni: - Dispositivi connessi o di streaming: dispositivi che si connettono allo schermo di una TV per mostrare stream video (Roku, Apple TV e così via). - Smart TV: TV con connessione a internet integrata (Samsung Smart TV e così via). - Console per videogiochi: console per videogiochi connesse a internet (Xbox, PlayStation, Wii e così via). - Decoder: dispositivi che offrono contenuti via cavo tradizionali e video on demand." "Over-the-top (OTT) indica contenuti video simili a quelli televisivi forniti da un provider di video su internet al di fuori delle reti chiuse dei provider di telecomunicazioni e via cavo. I video OTT possono essere visualizzati su computer, dispositivi mobili, tablet, nonché su dispositivi TV connesse a internet o decoder (a condizione che i contenuti vengano distribuiti tramite IP per questi ultimi). "Audio: questa è una nuova sezione dedicata all'inventario audio." "OOH: publisher di out of home digitale."

Enum
MEDIUM_CAPABILITY_UNSPECIFIED Funzionalità del mezzo non specificata. Input non valido.
MEDIUM_CAPABILITY_DIGITAL Funzionalità del mezzo digitale.
MEDIUM_CAPABILITY_TV Funzionalità del mezzo TV.
MEDIUM_CAPABILITY_AUDIO Funzionalità del mezzo audio.
MEDIUM_CAPABILITY_OOH Funzionalità del mezzo out of home.

CommitmentCapability

Enum della funzionalità di impegno.

Enum
COMMITMENT_CAPABILITY_UNSPECIFIED Funzionalità di impegno non specificata. Input non valido.
COMMITMENT_CAPABILITY_GUARANTEED Il publisher ha un inventario garantito.
COMMITMENT_CAPABILITY_NON_GUARANTEED Il publisher ha un inventario non garantito.

TVMetadata

Metadati per i publisher che offrono contenuti TV.

Rappresentazione JSON 
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
Campi
tvDeliveryType

enum (TVDeliveryType)

Obbligatorio. Tipo di pubblicazione degli annunci TV.
topShows[]

string

Facoltativo. Elenco dei titoli dei programmi TV più importanti di proprietà del publisher. Dimensione massima: 10. Deve essere codificato in UTF-8.

TVDeliveryType

Enum del tipo di pubblicazione TV.

Enum
TV_DELIVERY_TYPE_UNSPECIFIED Tipo di pubblicazione TV non specificato. Input non valido.
TV_DELIVERY_TYPE_CTV Tipo di pubblicazione TV connessa a internet.
TV_DELIVERY_TYPE_LINEAR_TV Tipo di pubblicazione TV lineare.

Metodi

create

 Crea un nuovo publisher.

get

 Ottiene un publisher.

list

 Elenca i publisher.

patch

 Aggiorna un publisher.
Carica il logo del publisher.