Crea una pauta en el sistema.  Permite luego asignarle anuncios.

El request se debe realizar con el método POST

URL: /admin/adnet/pub/admin/pautas.html?op=a&o=xml


En caso de tener habilitada la opción de segmentación avanzada de pautas ver el artículo Segmentación avanzada de pautas


Requisitos:

Antes de crear una pauta, deben estar creados en el sistema:

Parámetros obligatorios:

Para pauta con una fecha de inicio y una fecha de fin:

- fecha_inicio: fecha de inicio de la pauta, en el formato definido para el usuario en la interfaz (DD/MM/AAAA o MM/DD/AAAA).

- hora_inicio: hora de inicio de la pauta, en HH:MM:SS.

- fecha_fin: fecha de fin de la pauta.  Debe ser posterior a la fecha de inicio.

- hora_fin: hora de finalización de la pauta.

Para pautas con múltiples fechas de inicio y fin:

- fecha_inicio_0, fecha_inicio_1, ... hasta fecha_inicio_9: fechas de inicio (es obligatorio ingresar al menos 1).  No se pueden solapar.

- fecha_fin_0, fecha_fin_1, ... hasta fecha_fin_9: fechas de fin, correspondientes a cada una de las fechas de inicio ingresadas.

Para pautas con horario semanal:

- target_horario_semanal_0: horario para el lunes.  Se deben indicar cada una de las horas en que estará activa la pauta el lunes.  Ej: “9 10 11 12 13 14 15 16” para una pauta que funcionará desde las 9:00 hasta las 16:59.

- target_horario_semanal_1 a 6: idem para martes a domingo.

 

Si la prioridad elegida tiene activa la optimización por eCPM, además son obligatorios los siguientes atributos:

- prioridad_prueba: prioridad de la pauta durante el período de prueba

- cantidad_impresiones_prueba: cantidad de impresiones que debe correr la pauta durante el período de prueba

 

Parámetros opcionales:

Estos son algunos de los parámetros opcionales y no son todos los que están disponibles a través de la interfaz web.   Para poder realizar un ajuste completo de la pauta, se debe realizar a través de la interfaz web.

- cantidad_total_<espacio_id>: cantidad de acciones para el espacio <espacio_id>.

Si se eligió modo de precios global:

 
Si se eligió modo de precios por espacio, por cada espacio_id seleccionado debe especificar los siguientes parámetros, reemplazando <espacio_id> por el código del espacio:

 

 

Si desea activar el registro de impresiones vistas (Viewability): contar_impresiones_vistas=on

 

SEGMENTACIÓN

*Para aquellos parámetros que requieran el ingreso de códigos, verificar los mismos desde Referencias.


Si se desea segmentar la pauta a uno o más Países, se deberán agregar los siguientes parámetros:

 

Si se desea segmentar la pauta con opciones Geográficas Avanzadas (Ciudades / Regiones /Código Postal, etc) se deberán agregar los siguientes parámetros:

                              1 segmentación por ciudad

                              2 segmentación por región

                              3 segmentación por código postal

                              4 segmentación por código de área

                              5 segmentación por red

 

                                    - 1 si la segmentación es negativa

 

 

Si se desea segmentar la pauta por una o más IPs , se deberán agregar los siguientes parámetros:

 

Si se desea segmentar la pauta por uno o más Idiomas, se deberán agregar los siguientes parámetros:

 

Si se desea segmentar la pauta por uno o más Anchos de Banda , se deberán agregar los siguientes parámetros:

 

Si se desea segmentar la pauta por uno o más Tipo de Conexión , se deberán agregar los siguientes parámetros:

 

Si se desea segmentar la pauta a uno o más Navegadores, se deberán agregar los siguientes parámetros:

 

Si se desea segmentar la pauta a uno o más Tipos de Navegadores, se deberán agregar los siguientes parámetros:

 

Si se desea segmentar la pauta por uno o más Sistemas Operativos , se deberán agregar los siguientes parámetros:

 

Si se desea segmentar la pauta por una o más Versiones de Sistemas Operativos , se deberán agregar los siguientes parámetros:

                                    4 si la segmentación es negativa

 

Si se desea segmentar la pauta por Marcas de Dispositivos viles, se deberán agregar los siguientes parámetros:

 

Si se desea segmentar la pauta por Modelos de Dispositivos viles, se deberán agregar los siguientes parámetros:

 

Si se desea segmentar la pauta por Características de los Dispositivos Móviles, se deberá agregar el parámetro correspondiente a cada característica, los valores que pueden tomar esos parámetros son:

Las características mobile disponibles para segmentar son:

 mobf_has_cellular_radio : Conexión celular

 mobf_dual_orientation : Pantalla con doble orientación

 mobf_png : Soporte de imágenes PNG

 mobf_ajax_support_javascript : soporte de Javacript

 mobf_built_in_camera : vídeo cámara

 mobf_can_assign_phone_number : Se puede asignar numero telefonico

 mobf_is_tablet : Es tablet

 mobf_has_qwerty_keyboard : Teclado qwerty

 mobf_j2me_midp_1_0 : Soporte MIDP 1.0

 mobf_j2me_midp_2_0 : Soporte MIDP 2.0

 mobf_jpg : Soporte de imágenes JPG

 mobf_wifi : Conexión WIFI

 mobf_full_flash_support : Soporte de FLASH full

 mobf_gif: Soporte de imágenes GIF

 

Si se desea segmentar la pauta por DMPs, se deberán agregar los siguientes parámetros:

         DESACTIVADO 0 / TODOS 1 / AL MENOS UNO 2

        .target_clustergroup_modo_N: N es el id del clustergroup, los valores posibles son:       

        TODOS 0 / ALGUNO 1 / NINGUNO 2

         Este parámetro indica cómo se van a tomar los clusters seleccionados para este clustergroup. Ej. Si el modo es ALGUNO, se van a tomar solo los clusters seleccionados.       

        .target_clustergroup_clusters_N: N es el id del clustergroup, este parámetro se envía con los ids de los clusters seleccionados dentro del clustergroup N.       

        Ej. target_clustergroup_clusters_2 = 2 3 4 (se envían ids 2, 3 y 4)

Si se desea activar Competencia a la pauta, se deberán agregar los siguientes parámetros:

 

Si se desean asociar Códigos de Conversión a la pauta, se deberán agregar los siguientes parámetros:

 

Si desea segmentar la pauta por Palabras Claves, se deberán agregar los siguientes parámetros:

          '1' Match exacto para Palabras Claves del tipo texto con opciones, tabla de datos, texto libre y numéricas (solo en el caso de seleccionar lista de valores) 

          '5' Match parcial para Palabras Claves del tipo texto con opciones, tabla de datos, texto libre

          '2' Valor mínimo para Palabras Claves del tipo meros enteros y decimales. 

          '3' Valor maximo para Palabras Claves del tipo meros enteros y decimales. 

          '4' Valor mínimo y máximo para Palabras Claves del tipo números enteros y decimales.

*Para conocer los id del sistema, se sugiere inspeccionar los elementos de la Segmentación por Palabra Clave dentro del formulario de Alta de Pauta utilizando Firebug.

VEA LOS EJEMPLOS DE REQUEST AL FINAL DEL ARTICULO


Parámetros opcionales, disponibles en interfaz de agencia o network:

pago_sitio_tprecio_modo: modo de precio – global o por espacio.  Ídem cobro_anunciante_tprecio_modo.

Si se eligió precios globales:

-      pago_sitio_tprecio_venta: forma que la pauta se le pagará al sitio.  Ídem cobro_anunciante_tprecio_venta.

-      pago_sitio_moneda_id: moneda en que se le pagará al sitio.  Ver valores posibles en 'Referencias' - Monedas. 

-      pago_sitio_precio: precio que se le pagará al sitio.  Ver valores posibles en 'Referencias' - cobro_anunciante_precio.

Si se eligió modo de precios por espacio, por cada espacio_id seleccionado debe especificar los siguientes parámetros, reemplazando <espacio_id> por el código del espacio:

-      pago_sitio_tprecio_venta_<espacio_id>: forma de comercialización para el espacio.  Ídem cobro_anunciante_tprecio_venta.

-      pago_sitio_moneda_id_<espacio_id>: moneda de comercialización del espacio.  Ver valores posibles en 'Referencias' - Monedas.

-      pago_sitio_precio_<espacio_id>:  precio para el espacio. 

Ejemplo de request:

URL: /admin/adnet/pub/admin/pautas.html?op=a&o=xml

Parámetros:

 


Explicación de los parámetros:

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>

      <resultado>1</resultado>

      <identificador>52112</identificador>

</operacion>

Ejemplo de respuesta con errores

<operacion>

      <resultado>0</resultado>

      <errores>

            <error atributo=”nombre” mensaje=”El nombre ingresado es inválido”/>

            <error atributo=”anunciante_id” mensaje=”Código de anunciante inválido”>

            <error atributo=”fecha_fin” mensaje=”La fecha de fin no puede ser anterior a la fecha de inicio”>

      </errores>

</operacion>

 

 

Ejemplo de request utilizando PALABRAS CLAVES:

CASO 1: Segmentación por Palabra Clave 'Edad' tipo Numerica (Valores seleccionados 10 y 20)

URL: /admin/adnet/pub/admin/pautas.html?op=a&o=xml

Parámetros:

&sitio_id=2943&nombre=test+api+kw+9&tipoventa_id=1&cpa_tracer_id=&prioridad=1&cantidad_total=10000&peso=100&target_sitio_id=10199&target_espacio_id=183181&intervalo_activacion=1&fecha_inicio=21%2F03%2F2013&hora_inicio=22%3A00%3A00&fecha_fin=20%2F04%2F2013&hora_fin=23%3A59%3A59&ptmodo_id=3&cobro_anunciante_tprecio_modo=1&cobro_anunciante_tprecio_venta=1&cobro_anunciante_precio=1&cobro_anunciante_moneda_id=5&accion_retraso_fecha_fin=0&target_keyword=1&ptk_used_496=0n&ptk_op_496=1&kwv_496=10,20

 

CASO 2: Segmentación por Palabra Clave 'Edad' tipo Numerica (Valores seleccionados Min 10 y Max 20)

URL: /admin/adnet/pub/admin/pautas.html?op=a&o=xml

Parámetros:

&sitio_id=2943&nombre=test+api+kw+8&tipoventa_id=1&cpa_tracer_id=&prioridad=1&cantidad_total=10000&peso=100&target_sitio_id=10199&target_espacio_id=183181&intervalo_activacion=1&fecha_inicio=21%2F03%2F2013&hora_inicio=22%3A00%3A00&fecha_fin=20%2F04%2F2013&hora_fin=23%3A59%3A59&ptmodo_id=3&cobro_anunciante_tprecio_modo=1&cobro_anunciante_tprecio_venta=1&cobro_anunciante_precio=1&cobro_anunciante_moneda_id=5&accion_retraso_fecha_fin=0&target_keyword=1&ptk_used_496=0n&ptk_op_496=4&ptk_max_value_496_4=20&ptk_min_value_496_4=10

 

CASO 3: Segmentación por Palabra Clave 'Moneda' tipo Texto con Opciones (Valores seleccionados 'Dolar' y 'Peso' cuyos ids en el sistema son '151719' y '151721' respectivamente)

URL: /admin/adnet/pub/admin/pautas.html?op=a&o=xml

Parámetros:

&sitio_id=2943&nombre=test+api+kw+7&tipoventa_id=1&cpa_tracer_id=&prioridad=1&cantidad_total=10000&peso=100&target_sitio_id=10199&target_espacio_id=183181&intervalo_activacion=1&fecha_inicio=21%2F03%2F2013&hora_inicio=22%3A00%3A00&fecha_fin=20%2F04%2F2013&hora_fin=23%3A59%3A59&ptmodo_id=3&cobro_anunciante_tprecio_modo=1&cobro_anunciante_tprecio_venta=1&cobro_anunciante_precio=1&cobro_anunciante_moneda_id=5&accion_retraso_fecha_fin=0&target_keyword=1&ptk_used_425=0n&ptk_op_425=1&kwv_425=151719+151721

 

CASO 4: Segmentación por Palabra Clave 'Categoria' tipo Tabla de Datos (Valores seleccionados 'Deportes' y 'Musica' cuyos ids en el sistema son '838' y '840' respectivamente)

URL: /admin/adnet/pub/admin/pautas.html?op=a&o=xml

Parámetros:

&sitio_id=2943&nombre=test+api+kw+10&tipoventa_id=1&cpa_tracer_id=&prioridad=1&cantidad_total=10000&peso=100&target_sitio_id=10199&target_espacio_id=183181&intervalo_activacion=1&fecha_inicio=21%2F03%2F2013&hora_inicio=22%3A00%3A00&fecha_fin=20%2F04%2F2013&hora_fin=23%3A59%3A59&ptmodo_id=3&cobro_anunciante_tprecio_modo=1&cobro_anunciante_tprecio_venta=1&cobro_anunciante_precio=1&cobro_anunciante_moneda_id=5&accion_retraso_fecha_fin=0&target_keyword=1&ptk_used_67=0n&ptk_op_67=1&kwv_67=838+840

 

CASO 5: Segmentación por Palabra Clave 'Buscador' tipo Texto Libre (Valores seleccionados 'Manzana' y 'Pera')

URL: /admin/adnet/pub/admin/pautas.html?op=a&o=xml

Parámetros:

&sitio_id=2943&nombre=test+api+kw+11&tipoventa_id=1&cpa_tracer_id=&prioridad=1&cantidad_total=10000&peso=100&target_sitio_id=10199&target_espacio_id=183181&intervalo_activacion=1&fecha_inicio=21%2F03%2F2013&hora_inicio=22%3A00%3A00&fecha_fin=20%2F04%2F2013&hora_fin=23%3A59%3A59&ptmodo_id=3&cobro_anunciante_tprecio_modo=1&cobro_anunciante_tprecio_venta=1&cobro_anunciante_precio=1&cobro_anunciante_moneda_id=5&accion_retraso_fecha_fin=0&target_keyword=1&ptk_used_499=0n&ptk_op_499=5&kwv_499=manzana,naranja

 

CASO 6: Segmentación por 2 Palabra Claves 'Buscador' tipo Texto Libre (Valores seleccionados 'Manzana' y 'Pera') y 'Edad' tipo Numerica (valores seleccionados min 10 y max 20)

URL: /admin/adnet/pub/admin/pautas.html?op=a&o=xml

Parámetros:

&sitio_id=2943&nombre=test+api+kw+13&tipoventa_id=1&cpa_tracer_id=&prioridad=1&cantidad_total=10000&peso=100&target_sitio_id=10199&target_espacio_id=183181&intervalo_activacion=1&fecha_inicio=21%2F03%2F2013&hora_inicio=22%3A00%3A00&fecha_fin=20%2F04%2F2013&hora_fin=23%3A59%3A59&ptmodo_id=3&cobro_anunciante_tprecio_modo=1&cobro_anunciante_tprecio_venta=1&cobro_anunciante_precio=1&cobro_anunciante_moneda_id=5&accion_retraso_fecha_fin=0&target_keyword=1&ptk_used_499=0n&ptk_op_499=5&kwv_499=manzana,naranja&&ptk_used_496=0n&ptk_op_496=4&ptk_max_value_496_4=20&ptk_min_value_496_4=10&target_keyword_type=67108864