Extraer Código HTML de un espacio
Retorna el código HTML de un espacio según los parámetros otorgados, no están soportados los tags Imagen, Formatos especiales, Player de video VAST y Link para contar clicks únicamente.
El request se debe realizar con el método POST
URL: /admin/adnet/pub/admin/espacios.html?op=c&o=xml
Requisitos:
El usuario debe tener el permiso correspondiente a la obtención de tags (Código HTML dentro de espacios).
Se debe conocer su identificador (espacio_id)
Parámetros obligatorios:
- espacio_id: el identificador del espacio
- t: Tipo de tag, los valores posibles son:
j → Javascript.
v4 → Ajax V4.
lai → Conteo de Impresiones y Clics
v4i3p → Ajax V4 Sincrónico (para enviar a otros adservers o pegar dentro de iframes).
ifb → Iframe Buster.
ifbyahoo → Iframe Buster para Yahoo.
v4c → Ajax V4 Contextual Asincrónico (para pegar directamente en el sitio).
v4s → Ajax V4 Contextual Sincrónico (para enviar a otros adservers).
fsMSN → Microsoft (MSN.com, Live Mail y otros).
fsMessenger → Windows Live Messenger (234 x 60)
fsGoogle → Javascript para Google Content Network/GAM .
fsDart → Javascript para DART for Publishers/YouTube.
jof → Javascript para ESPN.
m → Imagen mobile.
mj → Javascript mobile.
fs → Detector de Flash.
sfs → Detector de Flash corto.
lo → Link para contar clics únicamente.
- i : Este parámetro nos permite decidir si en el nombre vamos a usar ids para el espacio y la sección o si vamos a usar nombres . Los dos valores posibles son:
Parámetros opcionales:
Definición de los parámetros. Luego se indicará para qué tipo de código está disponible cada uno de ellos.
- maxads: Nos permite decidir la cantidad máxima de anuncios. Los valores van desde 1 a 20.
- rnd: Nos permite decidir si queremos un código para evitar caches o uno sin scripts. Los valores posibles son 1 y 0 respectivamente.
- flash_version: Indicamos en este parámetro la versión mínima de flash. Los parámetros disponibles son 4, 5, 6, 7, 8 y 9.
- keyword_clave_tag: En este parámetro se selecciona qué keywords vamos a aplicar al espacio. El contenido de dicho parámetro es el identificador elegido para el grupo de palabras claves deseado.
- in3pIF: Seteándole valor 1 a esta opción, indicamos que el tag que estará pegado dentro de un iFrame. Para que esta opción funcione, es necesario que el iframe y el sitio compartan el mismo dominio.
- busqueda_keywords: Este parámetro nos permite indicar la búsqueda de palabras clave en la página. Puede tener tres valores distintos:
- epl_div: Se indica que se ingresaron Divs epl_div en la página.
- e_classname: Se ordena que se busque en elementos con determinado class. Esta opción requiere la inclusión de un parámetro más llamado e_classname, el cual tiene como valor el class del elemento en el que se quiere buscar.
- e_id: Se ordena que se busque en elementos con determinado ID. Esta opción requiere la inclusión del parámetro e_id, el cual tiene como valor el ID del elemento en el que se quiere buscar.
Tags que soportan parámetros opcionales.
Si el tipo de tag es Ajax V4: maxads.
Si el tipo de tag es Ajax V4 Sincrónico (para enviar a otros adservers o pegar dentro de iframes): maxads.
Si el tipo de tag es Ajax V4 Contextual Asincrónico (para pegar directamente en el sitio): i, keyword_clave_tag, maxads, busqueda_keywords.
Si el tipo de tag es Ajax V4 Contextual Sincrónico (para enviar a otros adservers): in3pIF, keyword_clave_tag, maxads, busqueda_keywords.
Si el tipo de código es Javascript mobile: rnd
Si el tipo de código es Detector de Flash: flash_version
Si el tipo de código es Detector de Flash corto: flash_version
Respuesta:
A diferencia del resto del API, en este caso la respuesta no es un XML, sino que es directamente el código del tag.
Ejemplo de URL con Parámetros:
Para un tag de tipo Javascript.
URL: /admin/adnet/pub/admin/espacios.html?op=c&t=j&i=enc_id&espacio_id=35132&o=xml
Para un tag Ajax V4 contextual Asincrónico.
URL: /admin/adnet/pub/admin/espacios.html?op=c&espacio_id=35132&t=v4c&maxads=10&keyword_clave_tag=test&busqueda_keywords=e_classname&e_classname=elemento_class&o=xml
Para un tag Ajax V4 contextual Sincrónico.
URL: /admin/adnet/pub/admin/espacios.html?op=c&espacio_id=35132&t=v4s&maxads=10&keyword_clave_tag=test&busqueda_keywords=e_id&e_id=elemento_id&in3pIF=1&o=xml