Creación de Anuncios

Crea una anuncio asociado a una pauta.

Si adjunta un archivo, debe ser POST con encoding multipart/form-data. Si no se adjunta archivo, puede ser GET.

URL: /admin/adnet/pub/admin/pauta_banner.html?op=ab&o=xml

Requisitos:

Antes de crear un anuncio, deben estar creados en el sistema:

El anunciante y la Pauta a la cual estará asociado el anuncio. Se debe conocer el identificador de la pauta.

El o los espacios donde va a correr la pauta. Se deben conocer sus identificadores.

Parámetros obligatorios comunes a todos los formatos:

pauta_id: identificador de la pauta a la cual se quiere asociar el nuevo anuncio.
banformato_id: identificador de formato del anuncio a crear. Ver valores posibles en 'Referencias'.
nombre: nombre del anuncio. Debe cumplir con las reglas para nombres válidos. No puede haber anuncios del mismo anunciante con el mismo nombre.
layer_efecto: identifica el tipo de efectos a aplicar al banner. Ver valores posibles en 'Referencias'.
alttext: titulo del anuncio. En anuncios con efectos, el titulo puede seleccionar como una opción visible para el usuario final.
linkurl: la url de click, o landing page del anuncio.

prioridad: prioridad del anuncio en relación a otros asociados a la misma pauta. Valores posibles: de 1 a 10.

peso: peso del anuncio en relación a otros asociados a la misma pauta. Valores posibles: de 1 a 100.
url_conteo / url_conteo2 / url_conteo3: permite incorporar pixels tracking externas para conteo conjunto de impresiones.
target_espacio_id_xxxx=xxxx (sustituir los xxxx por el identificador del espacio).

Parámetros adicionales para formato LINK DE TEXTO:

font_size: tamaño de la fuente
font_family: el nombre que identifica la fuente en el sistema.
font_color: color seleccionado para fuente en código RGB
html_code: codigo HTML para V3. En caso de Utilizar V4 se ingresan las etiquetas '<html></html>'.
link_texto_descripcion: lineas descriptivas del anuncio, para el caso de seleccionar efectos del anuncio con 'descripción'. Se pueden enviar la linea descriptiva 1 y 2 por separado dentro del mismo parámetro. Se deben enviar ambas lineas separadas por '\n' (CR / 0x13). Si se está enviando por navegador en método GET utilizar dicho carácter encodeado %0A
link_texto_url: url visible (puede ser una url simplificada que permita visualizar mejor la marca), para el caso de seleccionar efectos del anuncio con 'url'

Parámetros adicionales para formato GIF/JPG/PNG:

origen: puede tomar los valores 'file' (si se adjunta un archivo) o 'url' (si se especifica una url donde esta hosteado el anuncio)
archivo: indicar el archivo de la imagen, en el caso de haber seleccionado origen=file. El archivo se debe adjuntar con método POST y con encoding multipart/form-data
url_anuncio: indicar la url donde esta alojada la imagen, en el caso de seleccionar origen=url
text_align: puede tomar los valores 'left' 'center' o 'right', y determina la posición del anuncio en pantalla.
link_texto_descripcion: lineas descriptivas del anuncio, para el caso de seleccionar efectos del anuncio con 'descripción'. Se pueden enviar la linea descriptiva 1 y 2 por separado dentro del mismo parámetro. Se deben enviar ambas lineas separadas por '\n' (CR / 0x13). Si se está enviando por navegador en método GET utilizar dicho carácter encodeado %0A
link_texto_url: url visible (puede ser una url simplificada que permita visualizar mejor la marca), para el caso de seleccionar efectos del anuncio con 'url'

Parámetros adicionales para formato Flash:

origen: puede tomar los valores 'file' (si se adjunta un archivo) o 'url' (si se especifica una url donde esta hosteado el anuncio)
archivo: indicar el archivo de la imagen, en el caso de haber seleccionado origen=file. El archivo se debe adjuntar con método POST y con encoding multipart/form-data
url_anuncio: indicar la url donde esta alojada la imagen, en el caso de seleccionar origen=url
text_align: puede tomar los valores 'left' 'center' o 'right', y determina la posición del anuncio en pantalla.
flash_background_type: puede tomar los valores 't' 'm' o 'c' según se quiere aplicar transparent, movie o color. En el caso de seleccionar la opción 'c' , se debe enviar el parámetro adicional flash_background_color indicando el color en código RGB

Ejemplo de request:

/admin/adnet/pub/admin/pauta_banner.html?pauta_id=1133&op=ab&o=xml&banformato_id=41&nombre=testapi&alttext=testtituloapi&layer_efecto=132&linkurl=http://wwww.test.com&prioridad=1&peso=100&url_conteo=http://wwww.conteo.com&link_texto_descripcion=esta es una prueba linea1%0Aa partir de aqui linea 2&link_texto_url=test.com&font_size=10&font_family=arial&font_color=000000&htmlcode=<html></html>&target_espacio_id_580=580

Respuesta:

Contiene un objeto <operacion> que a su vez contiene un tag <resultado>. El valor de resultado puede ser 1 (operación exitosa) o 0 (operación fallida).

Si la operación es fallida, se agrega además un listado de errores, mediante tags <error>, que contienen el atributo atributo, que especifica el nombre del atributo con error, y mensaje, con el mensaje de error.

Ejemplo de respuesta sin errores

</operacion>

Ejemplo de respuesta con errores