Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

CampoTipoEstadoComentarios
idStringObligatorioUn identificador para el request. Puede ser utilizado para relacionar el bid request al bid response fuera del protocolo HTTP
tmaxIntegerRecomendadoEn milisegundos, el tiempo máximo de respuesta para participar de la subasta
atIntegerObligatorioTipo de subasta, donde 1 = First Price, 2 = Second Price Plus
impObject ArrayObligatorioVer objeto Imp
allimpsIntegerRecomendadoIndica si todas las impresiones del contexto están disponibles o no
userObjectObligatorioVer objeto User
deviceObjectObligatorioVer objeto Device
siteObjectObligatorio para WebVer objeto Site
appObjectObligatorio para In-AppVer objeto App
sourceObjectObligatorioVer objeto Source
regsObjectObligatorio para Europa
(Recomendado para el resto)
Ver objeto Regs
badvString ArrayRecomendadoListado de dominios de anunciantes bloqueados
bcatString ArrayRecomendadoListado de categorías IAB bloqueadas

...

CampoTipoEstadoComentarios
idStringObligatorioIdentificador único para la impresión dentro del Bid Request.
Habitualmente comienza en "1" y se incrementa progresivamente.
bannerObjectObligatorioVer objeto Banner
bidfloorcurStringObligatorioDivisa a utilizar en los precios, tanto en el bid response como en los precios mínimos.
Utiliza códigos ISO-4217, por ejemplo "USD".
bidfloorFloatObligatorioEl precio mínimo al cual la impresión puede ser vendida, expresado en la divisa especificada en bidfloorcur
secureIntegerObligatorioIndica "1" si el anuncio en el bid response debe utilizar HTTPS
instlIntegerRecomendadoIndica "1" cuando la impresión corresponde a un anuncio de página completa (Full page o Interstitial)
clickbrowserIntegerObligatorio para In-AppIndica el tipo de navegador a abrirse al realizar click en el anuncio. 0 = Interno de la App, 1 = Nativo

Ejemplo

Code Block
languagejs
linenumberstrue
collapsetrue
{
	"id": "1",
	"bidfloor": 0.4286,
	"bidfloorcur": "USD",
	"secure": 1,
	"instl": 0,
	"banner": {
		"w": 300,
		"h": 250,
		"pos": 1,
		"topframe": 0
	},
	"tagid": "79a4e192e54cc0d9"
}

...

Code Block
languagejs
linenumberstrue
collapsetrue
{
	"id": "123",
	"page": "http://example.com/section/page.html",
	"cat": [ "IAB1-2" ],
	"publisher": {
		"id": "456",
		"domain": "example.com",
		"name": "Example Inc"
	}
}

Objeto App

CampoTipoEstadoComentarios
idStringObligatorioID de la App en el SSP
nameStringObligatorioNombre de la aplicación
bundleStringObligatorioBundle de la aplicación o nombre del paquete (por ejemplo, "com.foo.myapp" en Android o un valor numerico en iOS)
domainStringRecomendadoDominio de la aplicación donde se mostrará la impresión
storeurlStringRecomendadoURL de la aplicación en la tienda
catString ArrayRecomendadoArray de categorías IAB de la aplicación

Ejemplo

Code Block
languagejs
linenumberstrue
collapsetrue
{
	"id": "12345",
	"name": "My App",
	"bundle": "com.foo.myapp",
	"domain": "myapp.com",
	"storeurl": "https://store.com/app/12345",
	"cat": [ "IAB1-2" ],
	"publisher": {
		"id": "456",
		"domain": "example.com",
		"name": "Example Inc"
	}
}

Objeto Publisher

CampoTipoEstadoComentarios
idStringObligatorioEl ID del publisher. Debe ser suficiente para identificar a la parte finalmente pagada
domainStringRecomendadoDominio del publisher
nameStringRecomendadoNombre del publisher

Ejemplo

Code Block
languagejs
linenumberstrue
collapsetrue
{
	"id": "456",
	"domain": "example.com",
	"name": "Example Inc"
}

...

CampoTipoEstadoComentarios
idStringRecomendadoID del usuario en el DSP
buyeruidStringRecomendadoID del usuario en E-Planning SSP. Ver sección Sincronización de usuarios

Ejemplo

Code Block
languagejs
linenumberstrue
collapsetrue
{
	"id": "1234567",
	"buyeruid": "e3cf38b549b50e01",
	"consent": "BOEFEAyOEFEAyAHABDENAI4AAAB9vABAASA"
}

...

CampoTipoEstadoComentarios
uaStringObligatorioEl valor de user-agent para el navegador
ipStringObligatorioDirección IP del usuario
dntIntegerRecomendadoEl consentimiento del usuario para ser seguido (tracked). Si el usuario no desea ser seguido este campo debe valer 1.
languageStringOpcionalEl idioma del navegador del usuario utilizando ISO- 639-1-alpha-2
carrierStringRecomendadoProveedor de servicios de Internet del usuario
connectiontypeIntegerRecomendadoTipo de conexión
osStringRecomendadoSistema operativo del dispositivo
geoObjectRecomendadoVer objeto Geo
ifaStringRecomendadoSolo para In-App. El ID para anuncios del dispositivo

Ejemplo

Code Block
languagejs
linenumberstrue
collapsetrue
{
	"ip": "142.93.199.194",
	"ua": "Mozilla\/5.0 (Macintosh; Intel Mac OS X 10.12; rv:71.0) Gecko\/20100101 Firefox\/71.0",
	"os": "macOS",
	"carrier": "verizon",
	"connectiontype": 6,
	"dnt": 0,
	"geo": {
		"country": "USA",
		"city": "Stanford"
	}
}

...

CampoTipoEstadoComentarios
countryStringObligatorioPaís del usuario en ISO- 3166-1-alpha-3
cityStringRecomendadoCiudad del usuario
latitudeFloatRecomendadoLatitud desde -90.0 hasta +90.0, donde negativo significa sur
longitudeFloatRecomendadoLongitud desde -180.0 hasta +180.0, donde negativo es oeste

Ejemplo

Code Block
languagejs
linenumberstrue
collapsetrue
{
	"latitude": 37.4194,
	"longitude": -122.164,
	"country": "USA",
	"city": "Stanford”
}

...

CampoTipoEstadoComentarios
coppaIntegerRecomendadoIndica si la petición esta sujeta a regulaciones de COPPA, donde 0 = no, 1 = si
gdprInteger

Obligatorio para Europa
(Recomendado para el resto)

Indica si la petición esta sujeta a regulaciones de GDPR, donde 0 = no, 1 = si
ext.consentStringRecomendadoSi la petición esta sujeta a regulaciones de GDPR, indica el Consent String del usuario
us_privacyStringRecomendadoIndica si la petición esta sujeta a regulaciones de CCPA (California Consumer Privacy Act).
Debe contener cuatro caracteres, donde el primero debe ser la versión y los tres siguientes Y, N o -
Mas información haciendo click aquí.

Ejemplo

Code Block
languagejs
linenumberstrue
collapsetrue
{
	"gdpr": 1,
	"coppa": 1,
	"us_privacy": "1-N-",
	"ext": {
		"consent": "BOq9e8JOq9e8lAHABBESCv- AAAAst7_______9______9uz_Ov_v_f__33e8__9v_l_7_-___u_-3zd4u_1vf99yfm1-7etr3tp_87ues2_Xur__79__3z3_9pxP78k89r7337Ew_v-_v8b7BCIJ"
	}
}

...

Info
titleNota

Para implementaciones con pchain soportamos tanto TAG ID como identificación por dominio.

Ejemplo

Utilizando pchain

Code Block
languagejs
linenumberstrue
collapsetrue
{
	"fd": 1,
	"pchain": "directseller.com:12345"
}

...

E-Planning proveerá al SSP con una URL de sincronización de usuarios, la cual debe ser insertada en los sitios a subastar utilizando una etiqueta <iframe>. Luego de que la URL sea llamada en el navegador E-Planning creará un nuevo ID de usuario. Luego E-Planning redirigirá a una URL provista por el SSP. En la misma debe existir una macro $UID que será reemplazada por el ID de usuario de E-Planning (buyeruid). Este proceso solo aplica para subastas Web, no siendo necesario en In-App.

Por ejemplo, si la URL del SSP es https://www.test-partner-domain.com/?uid=$UID, E-Planning reemplazará la macro $UID con el correspondiente buyeruid (por ejemplo "e3cf38b549b50e01") y redirigirá al usuario a la URL final. El SSP debe pasar la URL a redirigir en el parametro redir= de la URL de E-Planning:

...