E-Planning SSP puede recibir impresiones mediante una conexión de servidor a servidor (server to server) utilizando el protocolo OpenRTB.
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"id": "456",
"domain": "example.com",
"name": "Example Inc"
} |
Objeto
...
Content
Este objeto describe el contenido en el que aparecerá la impresión, que puede ser contenido sindicado o no sindicado. Este objeto puede ser útil cuando el contenido sindicado contiene impresiones y no coincide necesariamente con el contenido general del editor. Este objeto es altamente recomendable en el inventario de CTV y debe enviarse siempre que sea posible.
| Field | Type | Status | Comment |
|---|---|---|---|
| id | String | Recomendado | Identificador único del contenido |
| episode | Integer | Recomendado | Número de episodio |
| title | String | Recomendado | Título del contenido |
| series | String | Recomendado | Serie del contenido |
| season | String | Recomendado | Temporada del contenido |
| artist | String | Recomendado | Artista al que se atribuye el contenido |
| genre | String | Recomendado | Género que mejor describe el contenido |
| album | String | Recomendado | Álbum al que pertenece el contenido |
| producer | Object | Recomendado | Datos sobre el productor del contenido (véase "Objeto Producer") |
| url | String | Recomendado | URL del contenido, para contextualización o revisión por parte del comprador |
| cat | String Array | Recomendado | Conjunto de categorías IAB que describen el contenido |
| prodq | Integer | Recomendado | Calidad de producción. Consulte la lista: Production Qualities en AdCOM 1.0 |
| context | Integer | Recomendado | Tipo de contenido (juego, vídeo, texto, etc.). Consulte la lista: Content Contexts en AdCOM 1.0 |
| contentrating | String | Recomendado | Clasificación del contenido (por ejemplo: MPAA) |
| userrating | String | Recomendado | Valoración del contenido por parte de los usuarios (por ejemplo, número de estrellas, me gusta, etc.) |
| qagmediarating | Integer | Recomendado | Clasificación de los medios según las directrices de IQG. Consulte la lista: Media Ratings en AdCOM 1.0 |
| keywords | String | Recomendado | Lista separada por comas de palabras clave que describen el contenido |
| livestream | Integer | Recomendado | 0 = no en vivo, 1 = vivo |
| sourcerelationship | Integer | Recomendado | 0 = indirecto, 1 = directo |
| len | Integer | Recomendado | Duración del contenido en segundos; apropiado para vídeo o audio |
| language | String | Recomendado | Lenguaje del contenido en ISO-639-1-alfa-2 |
| embeddable | Integer | Recomendado | Indicador de si el contenido es incrustable (por ejemplo, un reproductor de vídeo incrustable), donde 0 = no, 1 = sí |
| channel | Object | Recomendado | Información sobre el canal en el que se encuentra el contenido (véase "Objeto Channel") |
Objeto Producer
Este objeto define el productor del contenido en el que se mostrará el anuncio. Esto es especialmente útil cuando el contenido está sindicado y puede distribuirse a través de diferentes editores y, por tanto, cuando el productor y el editor no son necesariamente la misma entidad.
| Field | Type | Status | Comment |
|---|---|---|---|
| id | String | Recomendado | ID del productor u originador del contenido |
| name | String | Recomendado | Nombre del productor u originador del contenido (por ejemplo, "Warner Bros") |
| cat | String | Recomendado | Conjunto de categorías de contenidos IAB que describen al productor del contenido |
| domain | String | Recomendado | Dominio de nivel superior del productor del contenido (por ejemplo, "productor.com") |
Objecto Channel
Este objeto describe el canal en el que se mostrará un anuncio. Un canal se define como la entidad que gestiona una biblioteca de contenidos o un flujo dentro de una marca para los espectadores. Algunos ejemplos son los «canales» específicos que se pueden seleccionar dentro de la televisión lineal y en streaming (MTV, HGTV, CNN, BBC One, etc.) o un flujo específico de contenido de audio comúnmente denominado «emisoras». El nombre es un campo legible por las personas, mientras que el dominio y el identificador pueden utilizarse con fines informativos y de segmentación.
| Field | Type | Status | Comment |
|---|---|---|---|
| id | String | Recomendado | Identificador único asignado por el editor. Este identificador puede no ser único para todas las fuentes de suministro. |
| name | String | Recomendado | Canal en el que se emite el contenido (por ejemplo, un canal local como "WABC-TV") |
| domain | String | Recomendado | El dominio principal del canal (por ejemplo, "abc7ny.com" en el caso del canal local WABC-TV). Se recomienda incluir el dominio privado superior (PSL+1) a efectos de normalización en la segmentación del DSP. |
Objeto User
| Campo | Tipo | Estado | Comentarios |
|---|---|---|---|
| id | String | Recomendado | ID del usuario en el DSP |
| buyeruid | String | Recomendado | ID del usuario en E-Planning SSP. Ver sección Sincronización de usuarios |
...
| Campo | Tipo | Comentarios |
|---|---|---|
| id | String | Un identificador del bid para assistir con el registro y seguimiento |
| impid | String | Valor del identificador envíado en el objeto Imp |
| price | Float | Oferta hecha en CPM (1 significa que E-Planning SSP esta dispuesto a pagar 0.001 por la impresión) |
| adm | String | El código HTML del anuncio a mostrar si la subasta es ganada. El mismo contiene una macro que debe ser reeamplazada con el precio en CPM. |
| adomain | String Array | El dominio del anunciante de la creatividad |
| w | Integer | El ancho del anuncio en pixeles |
| h | Integer | El alto del anuncio en pixeles |
| lurl | String | URL llamada por el Exchange cuando se sabe que se ha perdido una puja. Se incluye la macro incluyen las macros ${AUCTION_PRICE} y ${AUCTION_LOSS}. La política específica de cada Exchange puede impedir el llamado de lurl o la divulgación del precio ganador, lo que da lugar a que se eliminen las macros (es decir, se sustituyan por una cadena de longitud cero). |
...
La cual en el ejemplo redirigirá finalmente a:
https://test-partner-domain.com/?uid=e3cf38b549b50e01
Formato de buyeruid
El formato utilizado por E-Planning para los buyeruids es de 16 caracteres alfanuméricos, por ejemplo e3cf38b549b50e01
Compresión
E-Planning puede enviar y recibir bid requests y bid responses comprimidos. Se recomienda el uso de compresión en ambos para disminuir la latencia en la subasta y reducir el uso de ancho de banda.
- Para que los requests comprimidos utilizando gzip sean manejados adecuadamente debe agregar la cabecera HTTP Content-Encoding: gzip en el envio del bid request.
- Para que los bid responses sean enviados comprimidos mediante gzip debe agregar la cabecera HTTP Accept-Encoding: gzip en el envío del bid request.
...