...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"pos": 1,
"w": 300,
"h": 250,
"wmin": 300,
"wmax": 300,
"hmin": 50,
"hmax": 600,
"battr": [ 11, 12 ],
"btype": [ 4 ]
} |
Objeto Format
| Campo | Tipo | Estado | Comentarios |
|---|---|---|---|
| w | Integer | Obligatorio | Ancho en pixeles del tamaño |
| h | Integer | Obligatorio | Alto en pixeles del tamaño |
Objeto Site
| Campo | Tipo | Estado | Comentarios |
|---|---|---|---|
| id | String | Obligatorio | ID del sitio en el SSP |
| page | String | Obligatorio | URL de la página donde se mostrará la impresión. Si es desconocido, el campo no debe ser enviado o estar en blanco. |
| publisher | Object | Obligatorio | Ver objeto Publisher |
| domain | String | Recomendado | Dominio de la página donde se mostrará la impresión |
| cat | String Array | Recomendado | Array de categorias IAB del sitio |
| ref | String | Recomendado | URL de la página desde donde se llego a la página actual |
Ejemplo
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"id": "123",
"page": "http://example.com/section/page.html",
"cat": [ "IAB1-2" ],
"publisher": {
"id": "456",
"domain": "example.com",
"name": "Example Inc"
}
} |
Objeto Publisher
| Campo | Tipo | Estado | Comentarios |
|---|---|---|---|
| id | String | Obligatorio | El ID del publisher. Debe ser suficiente para identificar a la parte finalmente pagada |
| domain | String | Recomendado | Dominio del publisher |
| name | String | Recomendado | Nombre del publisher |
Ejemplo
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"id": "456",
"domain": "example.com",
"name": "Example Inc"
} |
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 |
Ejemplo
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"id": "1234567",
"buyeruid": "e3cf38b549b50e01",
"consent": "BOEFEAyOEFEAyAHABDENAI4AAAB9vABAASA"
}
|
Objeto Device
| Campo | Tipo | Estado | Comentarios |
|---|---|---|---|
| ua | String | Obligatorio | El valor de user-agent para el navegador |
| ip | String | Obligatorio | Dirección IP del usuario |
| dnt | Integer | Recomendado | El consentimiento del usuario para ser seguido (tracked). Si el usuario no desea ser seguido este campo debe valer 1. |
| language | String | Opcional | El idioma del navegador del usuario utilizando ISO- 639-1-alpha-2 |
| carrier | String | Recomendado | Proveedor de servicios de Internet del usuario |
| connectiontype | Integer | Recomendado | Tipo de conexión |
| os | String | Recomendado | Sistema operativo del dispositivo |
| geo | Object | Recomendado | Ver objeto Geo |
Ejemplo
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"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"
}
} |
Objeto Geo
| Campo | Tipo | Estado | Comentarios |
|---|---|---|---|
| country | String | Obligatorio | País del usuario en ISO- 3166-1-alpha-3 |
| city | String | Recomendado | Ciudad del usuario |
| latitude | Float | Recomendado | Latitud desde -90.0 hasta +90.0, donde negativo significa sur |
| longitude | Float | Recomendado | Longitud desde -180.0 hasta +180.0, donde negativo es oeste |
Ejemplo
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"latitude": 37.4194,
"longitude": -122.164,
"country": "USA",
"city": "Stanford"
} |
Objeto Regs
| Campo | Tipo | Estado | Comentarios |
|---|---|---|---|
| coppa | Integer | Recomendado | Indica si la petición esta sujeta a regulaciones de COPPA, donde 0 = no, 1 = si |
| gdpr | Integer | Obligatorio para Europa | Indica si la petición esta sujeta a regulaciones de GDPR, donde 0 = no, 1 = si |
| ext.consent | String | Recomendado | Si la petición esta sujeta a regulaciones de GDPR, indica el Consent String del usuario |
| us_privacy | String | Recomendado | Indica 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 | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"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"
}
} |
Objeto Source
| Campo | Tipo | Estado | Comentarios |
|---|---|---|---|
| fd | Integer | Obligatorio | Entidad responsable de la decisión final sobre la impresión, donde 0 = SSP, 1 = la siguiente fuente |
| pchain | String | Recomendado si schain no esta presente | Cadena TAG Payment ID |
| ext.schain | String | Recomendado si pchain no esta presente | Según propuesta de IAB, Supply Chain Object |
| Info | ||
|---|---|---|
| ||
Para implementaciones con pchain soportamos tanto TAG ID como identificación por dominio. |
Ejemplo
Utilizando pchain
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"fd": 1,
"pchain": "directseller.com:12345"
} |
Utilizando schain
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"fd": 1,
"ext": {
"schain": {
"complete": 1,
"nodes": [
{
"asi":"directseller.com",
"pid":"12345",
"rid":"c7ecc1f7b1628d49"
}
]
}
}
} |
Ejemplo de Bid Request
Ejemplo para banner (web)
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"id": "6cb84abfabb2990d",
"tmax": 300,
"at": 1,
"cur": ["USD"],
"imp": [{
"id": "1",
"bidfloor": 0.4,
"secure": 1,
"instl": 0,
"banner": {
"w": 300,
"h": 600,
"pos": 1,
"topframe": 0
}
}],
"user": {
"id": "2e6r4g56ez1hz8er4h",
"buyeruid": "e3cf38b549b50e01"
},
"device": {
"ip": "171.67.194.75",
"ua": "Mozilla\/5.0 (Macintosh; Intel Mac OS X 10.12; rv:71.0) Gecko\/20100101 Firefox\/71.0",
"os": "macOS",
"carrier": "verizon",
"connectiontype": 1,
"dnt": 0,
"lmt": 0,
"geo": {
"country": "USA",
"city": "Stanford"
}
},
"site": {
"id": "123",
"page": "http://example.com/section/page.html",
"cat": [ "IAB1-2" ],
"publisher": {
"id" : "456",
"domain": "example.com",
"name": "Example Inc"
}
}
"source": {
"fd": 1,
"ext": {
"sourcetype": 3,
"sourceorigin": 7,
"schain": {
"complete": 1,
"nodes": [{
"asi":"directseller.com",
"pid":"456",
"rid":" c7ecc1f7b1628d49"
}]
}
}
},
"regs": {
"gdpr": 1,
"us_privacy": "1-N-",
"coppa": 1,
"ext": {
"consent": "BOq9e8JOq9e8lAHABBESCv- AAAAst7_______9______9uz_Ov_v_f__33e8__9v_l_7_-___u_-3zd4u_1vf99yfm1- 7etr3tp_87ues2_Xur__79__3z3_9pxP78k89r7337Ew_v-_v8b7BCIJ"
}
},
"badv": ["ford.com","bmw.com"],
"bcat": ["IAB8-7","IAB8-8"]
} |