Crea una pauta en el sistema. Permite luego asignarle anuncios.
...
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:
...
- peso: peso de la pauta en relación a otras que compiten por el mismo espacio. Valores posibles: de 1 a 100.
- intervalo_activacion: identificador del intervalo de activación de la pauta. Ver valores posibles en 'Referencias' - Intervalos de activación de pautas .Según el valor, ingresado se deben ingresar además los siguientes parámetros:
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.
- ptmodotarget_sitio_id: para pautas no sponsor, se debe especificar el modo de distribución de las impresiones, clicks o conversiones. Ver valores posibles en 'Referencias' – Modo de distribución de pautas.target_sitio_id: listado de sitios, separados por espacios, donde correrá la pauta. Utilizar los listado de sitios, separados por espacios, donde correrá la pauta. Utilizar los identificadores.
- target_espacio_id: identificadores de los espacios donde correrá la pauta.
- accion_retraso_fecha_fin: sólo para pautas no Sponsor, debe indicar qué realizar cuando la pauta llega a la fecha de fin sin haber cumplido la cantidad establecida. Ver valores posibles en 'Referencias' – Acción al retrasarse una Pauta.
...
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.
...
de la interfaz web.
- ptmodo_id: para pautas no sponsor, se debe especificar el modo de distribución de las impresiones, clicks o conversiones. En caso de no enviarse se tomara el valor por defecto de la preferencia global de la cuenta. Ver valores posibles en 'Referencias' – Modo de distribución de pautas
- numero_oc: número de orden de compra, utilizado a modo de identificador. Puede contener como máximo 16 caracteres.
- pauta_competitiva_self: Si se envia con valor "on" se activa la competencia de la pauta consigo misma. En caso de no enviarse se tomara el valor por defecto de la preferencia global de la cuenta.
- accion_retraso_fecha_fin: Permite definir la accion que realizara la pauta si llega a su fecha de fin sin cumplir su objetivo cuantitativo. En caso de no enviarse se tomara el valor por defecto de la preferencia global de la cuenta.
- usuariovendedor_id: Id de usuario del vendedor.
...
- acciones_por_espacio: 0 o 1. Si es 1, permite especificar la cantidad de acciones (impresiones, clicks o conversiones) espacio por espacio. Ej: la pauta corre 40.000 impresiones en el espacio A y 20.000 en el espacio B. Si se indica 1, se debe especificar, por cada espacio, el parámetro:
- cantidad_total_<espacio_id>: cantidad de acciones para el espacio <espacio_id>.
- max_impresiones_usuario: cantidad máxima de veces que cada usuario puede ver la pauta. Número entre 1 y 254.
...
- stop_after_click: índique 1 si desea que una vez que un usuario cliqueó en una pauta, ésta no se le muestre más.
- guaranteed: si se envia con valor "on" la pauta se garantizara. En caso de no enviarse se tomara el valor por defecto de la preferencia global de la cuenta.
- max_acciones_hora: cantidad máxima de acciones a mostrar por hora. Por ejemplo, si la pauta es por impresiones, y se indica el número 1.000 en este parámetro, no mostrará mas de 1.000 impresiones por hora. Si es por clicks, no mostrará más de 1.000 clics por hora.
...
- cobro_anunciante_tprecio_modo: modo de precios. Permite indicar precios globales para todo la pauta (todos los espacios tienen el mismo precio) o precios por espacio (cada espacio tiene un precio distinto). Ver valores posibles en 'Referencias' – Modos de precios. Es obligatorio indicar un valor si desea indicar el precio de la pauta. Además, si definió en las preferencias del sistema que es obligatorio indicar precios para todas las pautas, o si está creando una pauta con optimización por eCPM, es obligatorio indicar un valor para este atributo.
Si se eligió modo de precios global:
- cobro_anunciante_tprecio_venta: forma de comercialización de la pauta con el anunciante. Ver valores posibles en 'Referencias' – Tipo de comercialización de pautas. No es necesario que el valor sea el mismo que tipoventa_id. tipoventa_id determina cuántas veces se va a mostrar la pauta. Este parámetro determina cómo se la va a cobrar.
- cobro_anunciante_moneda_id: identificador de la moneda en la cual se vende la pauta al anunciante. Ver valores posibles en 'Referencias' - Monedas.
- cobro_anunciante_precio: precio de la pauta para el anunciante. Si la pauta se comercializa por impresiones, indique el precio por CPM. Si es por clicks (CPC), indique el precio por cada click. Si es sponsor, indique el precio total de la pauta.
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:
- cobro_anunciante_tprecio_venta_<espacio_id>: forma de comercialización para el espacio. Ídem cobro_anunciante_tprecio_venta.
- cobro_anunciante_moneda_id_<espacio_id>: moneda de comercialización del espacio. Ver valores posibles en 'Referencias' - Monedas.
- cobro_anunciante_precio_<espacio_id>: precio para el espacio.
...
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 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
...
- target_clustergroup : Indica el modo de filtro para los clustergroups seleccionados, los valores posibles son:
DESACTIVADO 0 / TODOS 1 / AL MENOS UNO 2
- Por cada clustergroup seleccionado se envían estos parámetros:
...
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:
- pauta_competitiva_self: siempre el valor será 'on'. Esto indicará que se quiere activar la competencia consigo misma.
- pautas_competitivas: indicar si la competencia será 'Individual' o por 'Grupos' (Valores posibles: 1 - Individual // 2 - Grupos)
- pautas_competitivas_id_target: indica el identificador de la pauta a setear en competencia Individual (si se desea activar más de una, separar los identificadores con un espacio)
- compet_gpauta_id: indicar el identificador del Grupo a setear en competencia (si se desea activar más de uno, separar los identificadores con un espacio)
Si se desean asociar Códigos de Conversión a la pauta, se deberán agregar los siguientes parámetros:
...
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
...
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:
...