Creación de Pautas

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

El request se debe realizar con el método POST

URL: /admin/jsapi/pauta?op=a

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:

· El anunciante. Se debe conocer su identificador.

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

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

· Si está activada la optimización por eCPM para ciertas prioridades, debe tomarlo en cuenta al cargar la pauta si carga una pauta cuya prioridad tiene activa la optimización por eCPM, ya que deberá indicar obligatoriamente los parámetros prioridad_prueba, cantidad_impresiones_prueba, e indicar además el precio de la pauta. Puede controlar qué prioridades están activas para optimización por eCPM en las preferencias del sistema.

Parámetros obligatorios:

* nombre: nombre de la pauta. Debe cumplir con las reglas para nombres válidos (ver más adelante). No puede haber pautas del mismo anunciante con el mismo nombre, por más que hayan sido borradas.

* sitio_id: identificador del anunciante.

* orden_id: identificador de la orden (La orden a la cual se quiera asociar la nueva pauta debe ser del mismo Anunciante)

* tipoventa_id: tipo de comercialización. Ver valores posibles en Referencias .

* cpa_tracer_id: sólo si eligió CPA como tipo de comercialización, debe indicar el identificador del código de conversión relacionado.

* pauta_tracer_id: si eligió CPA como tipo de comercialización, obligatoriamente debe indicar en este campo el mismo valor ingresado en en cpa_tracer_id.

* cantidad_total: cantidad de impresiones, clicks o conversiones, según el tipo de comercialización de la pauta. El parámetro es opcional en el caso de pautas Sponsor y no se debe incluir en el caso de pautas donde se indica la cantidad de acciones espacio por espacio (ver parámetro acciones_por_espacio más abajo).

* prioridad: prioridad de la pauta en relación a otras que compiten por el mismo espacio. Valores posibles: de 1 a 10.

* 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.

* ptmodo_id: para pautas no sponsor, se debe especificar el modo de distrubició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 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.

* numero_oc: número de orden de compra, utilizado a modo de identificador. Puede contener como máximo 16 caracteres.

* fecha_oc: fecha de orden de compra. Solo se puede especificar si especifica también numero_oc. En caso contrario será ignorada.

* 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.

- max_impresiones_sesion: cantidad máxima de veces que cada usuario puede ver la pauta en una sesión. Número entre 1 y 254.

- intervalo_sesiones: intervalo entre sesiones, en horas. Número entre 1 y 720. Ver el Manual del Usuario para obtener una explicación de estos últimos 3 parámetros.

- stop_after_click: índique 1 si desea que una vez que un usuario cliqueó en una pauta, ésta no se le muestre más.

- 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 clicds, no mostrará más de 1.000 clics por hora.

- max_acciones_dia: ídem anterior, pero por día.

- max_acciones_semana: ídem por semana

- max_acciones_mes: ídem por mes.

- optim_banners_ctr: índique 1 si desea que el peso de los anuncios de la pauta se optimice automáticamente.

- 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.

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 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:

* target_ccountries: listado de códigos ISO-3166 de países separados por espacio (ej: “US CA MX”)

* target_country: indicar 1 para segmentación positiva (la pauta se muestra si el usuario está en alguno de los países indicados) o -1 para segmentación negativa (la pauta se muestra si el usuario NO está en ninguno de los países indicados). Indicar 2 para paises 'Desconocidos' (en este caso no se deberá usar el parámetro target_ccountries)

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:

* target_filtro: 0 desactivada

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

* target_filtro_signo: 1 si la segmentación es positiva

- 1 si la segmentación es negativa

* target_filtro_id: lista de códigos de regiones / ciudades / códigos seleccionados para la segmentación separados por espacio. (ej: 16 22 33)

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

* targetNetwork: 1 si la segmentación es positiva

- 1 si la segmentación es negativa

* target_networks: Ingresar una o más direcciones IPs separadas por espacios. Puede ingresar también redes con el formato AAA.BBB.CCC.DDD/MASK. Ej: 10.0.0.0/8, 192.168.0.0/16.

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

* targetLang: 1 si la segmentación es positiva

- 1 si la segmentación es negativa

* targetlangs: lista de códigos de los idiomas seleccionados separados por espacio. (ej: 16 22 33)

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

* target_connspeed: 1 si la segmentación es positiva

- 1 si la segmentación es negativa

* target_connspeed_id: lista de códigos de los anchos de banda seleccionados separados por espacio. (ej: 16 22 33)

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

* target_conntype: 1 si la segmentación es positiva

- 1 si la segmentación es negativa

* target_conntype_id: lista de códigos de los sistemas operativos seleccionados separados por espacio. (ej: 16 22 33)

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

* target_bproduct: indica si la segmentación es positiva o negativa, si el valor es 1, la misma es positiva y si el valor es -1, esta es negativa.

* target_bproducts: lista de navegadores separados por espacio. (ej: 16 22 33)

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

* target_bptype: 1 siempre que se desee activar esta segmentación

* target_bptypes: lista de códigos de tipos de navegadores separados por espacio. (ej: 16 22 33)

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

* target_osname: 1 si la segmentación es positiva

- 1 si la segmentación es negativa

* target_osnames: lista de códigos de los sistemas operativos seleccionados separados por espacio. (ej: 16 22 33)

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

* target_osname: 3 si la segmentación es positiva

4 si la segmentación es negativa

* target_os_id: lista de códigos de las versiones de sistemas operativos seleccionadas separados por espacio. (ej: 16 22 33)

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

* target_mobbrand: el valor debe ser 1

* target_mobbrand_id : lista de códigos de marcas de dispositivos seleccionados separados por espacio. (ej: 16 22 33)

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

* target_mobbrand: el valor debe ser 3

* target_mobmodel_id : lista de códigos de modelos de dispositivos seleccionados separados por espacio. (ej: 16 22 33)

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:

-1 cualquiera

1 si

0 no

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 : 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:

.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:

* pct: el valor debe ser 1

* pauta_tracer_id : lista de códigos de modelos de dispositivos seleccionados separados por espacio. (ej: 16 22 33)

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

* target_keyword: indicar siempre el valor 1

* target_keyword_type: se debe enviar este parámetro si la segmentación seleccionada contiene 2 o mas 'Palabras Claves'. Indicar '67108864' si deben matchear todas o '134217728' si debe matchear al menos una.

* ptk_used_<tkeyword_id>: indicar siempre 'on'.

* ptk_op_<tkeyword_id>: es un número del 1 al 5 que refiere al tipo de configuración seleccionado para los valores de la 'Palabra Clave'

- '1' Match exacto para Palabras Claves del tipo texto con opciones, tabla de datos, texto libre y numericas (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.

* ptk_max_value_<tkeyword_id>: indica el valor mínimo del rango seleccionado, para el caso de 'Palabras Claves' de tipo numéricas.

* ptk_min_value_<tkeyword_id>: indica el valor máximo del rango seleccionado, para el caso de 'Palabras Claves' de tipo numéricas.

* kwv_<tkeyword_id>: indica los valores de la Palabra Clave. Para el caso de 'Palabras Claves' texto libre y numéricas (solo en el caso de seleccionar lista de valores) los valores se enumeran separados por como ','. Ej 'casa,perro' '10,20'. Para el caso de 'Palabras Claves' de tipo Tabla de Datos o Texto con Opciones se deben indicar los valores expresados en el id del sistema separados por el signo mas '+'. Ej '988+986'.

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/jsapi/pauta

Parámetros:

Explicación de los parámetros:

· nombre: Test CPM

· sitio_id: 52432 – el identificador del anunciante dueño de la pauta

· tipoventa_id: 1 (pauta por CPM)

· cantidad_total: 100000 impresiones

· prioridad: 1

· peso: 1

· intervalo_activacion: fecha de inicio y fecha de fin

· fecha_inicio: 23/03/2006

· fecha_fin: 23/04/2006

· hora_inicio: 15:00:00

· hora_fin: 23:59:59

· ptmodo_id: 1 – distribución uniforme de impresiones

· target_sitio_id: 13212 – el identificador del sitio donde correrá la pauta.

· target_espacio_id: 45234, 541, 426. La pauta correrá en esos 3 espacios.

· accion_retraso_fecha_fin: 0 – continuar hasta cumplir la pauta.

· cobro_anunciante_tprecio_modo: 3 – precios distintos por espacio

· cobro_anunciante_tprecio_venta_45234, cobro_anunciante_moneda_id_45234, cobro_anunciante_precio_45234: el espacio 45234 se vende por CPM, en moneda 1 (dólares) a un precio de 3,50 el CPM.

· cobro_anunciante_tprecio_venta_541, cobro_anunciante_moneda_id_541, cobro_anunciante_precio_541: el espacio 541 se vende por CPM, en moneda 1 (dólares) a un precio de 2,50 el CPM.

· cobro_anunciante_tprecio_venta_4256, cobro_anunciante_moneda_id_4256, cobro_anunciante_precio_4256: el espacio 4256 se vende por CPC, en moneda 1 (dólares) a un precio de 0,20 el click.

Respuesta:

Contiene un objeto pauta_id , indicando el id de la pauta creada y un objeto status, que indica el estado del resultado, en este caso 200, indica que la pauta se creo correctamente.

Si la operación es fallida, mediante el objeto errors, muestra un listado de errores, indicando: - un atributo que indica cada campo erróneo.

- y el valor de cada uno de esos atributos indicando mensaje de error correspondiente.

También contiene un objeto status, que indica que el resultado fue erróneo, con un valor de 400.

Ejemplo de respuesta sin errores

{'pauta_id':'4496088','status':200}

Ejemplo de respuesta con errores

{'errors':{'pago_sitio_precio':'Invalid price'},'status':400}

Ejemplo de request utilizando PALABRAS CLAVES:

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