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” |
Antes de crear una pauta, deben estar creados en el sistema:
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
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 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 Móviles, se deberán agregar los siguientes parámetros:
Si se desea segmentar la pauta por Modelos de Dispositivos Mó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:
.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 desean asociar Códigos de Conversión a la pauta, 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 números enteros y decimales.
'3' Valor maximo para Palabras Claves del tipo nú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
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.
URL: /admin/adnet/pub/admin/pautas.html?op=a&o=xml
Parámetros:
Explicación de los parámetros:
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.
<operacion> <resultado>1</resultado> <identificador>52112</identificador> </operacion> |
<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> |
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