Información de Pauta
Da información acerca de una pauta previamente creada en el sistema.
URL: /admin/adnet/pub/admin/pautas.html?op=v&o=xml
Parámetro obligatorio:
- pauta_id: identificador de la pauta.
Ejemplos de URL con parámetro:
/admin/adnet/pub/admin/pautas.html?op=v&o=xml&pauta_id=5521
Respuesta:
Contiene un objeto <pauta>. El identificador se especifica mediante el atributo pauta_id y los datos presentados son los siguientes:
- nombre: nombre de la pauta
- anunciante_id: identificador del anunciante
- anunciante: nombre del anunciante
- ptestado_id: código de estado de la pauta. Ver valores posibles en Referencias - Estados de pautas
- tipoventa_id: tipo de comercialización de la pauta. Ver valores posibles en Referencias - Tipos de comercialización de pautas.
- custom_id: identificador personalizado
- cantidad_total: cantidad total contratada (de impresiones, clicks o conversiones, según el tipo de venta). Es opcional para pautas de tipo Sponsor.
- cantidad_cumplida: cantidad cumplida de lo contratado. Puede ser impresiones, clicks o conversiones, según el tipo de comercialización.
- impresiones_cumplidas: cantidad de impresiones cumplidas
- clicks_cumplidos: cantidad de clicks cumplidos.
- peso: peso de la pauta (de 1 a 100)
- prioridad: prioridad otorgada a la pauta (de 1 a 10)
- ptmodo_id: modo de distribución de las acciones asignadas a la pauta. Ver valores posibles en Referencias - Modo de distribución de pautas.
- fecha_inicio: fecha de inicio de la pauta
- fecha_fin: fecha de finalización de la pauta. Es opcional.
- fecha_alta: fecha de creación de la pauta.
- fecha_baja: si el anunciante hubiera sido borrada, indica la fecha en que fue borrada.
- target_sitio_id: listado de los identificadores de los sitios asociados a la pauta
- target_espacio_id: listado de los identificadores de los espacios asociados a la pauta
- target_country: si la pauta estuviera segmentada por país, el tag contendrá dos tags más, de lo contrario el tag se mostrará vacío:
- type: indica el tipo de segmentación por país, muestra los valores 1, -1 y 2 para “Mostrar la pauta en estos países”, “No mostrar la pauta en estos países” y “Mostrar la pauta cuando el país es desconocido ” respectivamente.
- countries: listado de los países elegidos .Ver valores posibles en Referencias - Países.
- target_perfil: si la pauta estuviera segmentada por país, el tag contendrá un tag más, de lo contrario el tag se mostrará vacío:
- perfil_id: contiene un listado de los ids de los perfiles segmentados en la pauta.
- precio_venta_anunciante: si se puede cobrar a anunciantes el tag contendrá 2 tags, de lo contrario se mostrará vacío:
- tmodo: muestra el método de cobro a anunciantes, puede contener los valores 0, 1 y 3 para “No especificado”, “Mismo precio para todos los espacios y códigos de conversión” y “Precios distintos por espacio” respectivamente.
- precio: se mostrará en caso de que el tmodo sea 1 o 3.
En caso de que sea 1, contendrá un sólo ítem que contiene los tags:
- precio: contiene el precio asignado.
- moneda_id: contiene el id de la moneda asignada (ver apéndice de monedas).
- tprecio: tipo del precio, puede ser 1, 2, 3 o 4 para CPM, CPC, CPA y Sponsor respectivamente.
En caso de que sea 3, contendrá un listado de ítems que corresponden a cada espacio. Cada uno de los mismos contendrá los mismos campos que en tmodo = 1 pero se le suman las etiquetas:
- nombre_espacio: contiene el nombre completo del espacio.
- espacio_id: id del espacio.
- pago_sitio: el contenido del campo funciona de la misma manera que el de precio_venta_anunciante.
- observaciones: observaciones de la pauta.
- target_keywords: si estuviera habilitada la segmentación por palabras claves el contendrá 2 etiquetas, de lo contrario estará vacío:
- keywords: contiene una lista de ítems, cada ítem contendrá:
- tkeyword_id: contiene el id la palabra clave.
- comparacion: puede contener los valores 1, 2, 3, 4 o 5, para “Comparación exacta” o “Listado de valores”, “Valor mínimo”, “Valor máximo”, “Valor máximo y mínimo”, “Comparación parcial” respectivamente.
Según el modo de comparación se agregan más tags al conteniendo de keywords.- Si la comparación es 1 o 5, se agrega la etiqueta values, la cuál contiene las keywords por las cuales se está segmentando.
- Si la comparación es de 2, se agrega la etiqueta min_value la cual contiene el valor mínimo indicado.
- Si la comparación es de 3, se agrega la etiqueta max_value la cual contiene el valor máximo indicado.
- Si la comparación es de 4, se agregan las etiquetas de max_value y min_value.
- type: indica el tipo de segmentación por palabras clave, puede contener los valores 0 o 1 para “Debe coincidir al menos una palabra clave” y “Deben coincidir todas las palabras claves” respectivamente.
- intervalo_activacion: indica con ids qué tipo de intervalo fue seleccionado en la pauta (ej: '1' - Simple - Fecha de inicio y fecha de fin) .Ver valores posibles en 'Referencias'-
Intervalos de activación de pautas.
Ejemplo de respuesta
<pauta pauta_id=”123”> <nombre>Septiembre Clicks</nombre> <anunciante_id>5435</anunciante_id> <anunciante>InSPect Tech</anunciante> <tipoventa_id>2</tipoventa_id> <custom_id>4432</custom_id> <cantidad_total>5000</cantidad_total> <cantidad_cumplida>524</cantidad_cumplida> <impresiones_cumplidas>135912</impresiones_cumplidas> <clicks_cumplidos>1652</clicks_cumplidos> <fecha_inicio>2006-01-21 15:00:00</fecha_inicio> <fecha_fin>2006-02-18 23:59:59</fecha_fin> <fecha_alta>2006-01-21 13:45:35</fecha_alta> <fecha_baja/> <target_country> <type>1</type> <countries> <item id='1'>AD</item> <item id='2'>AF</item> </countries> </target_country> <target_perfil> <perfil_id> <item id='1'>1358</item> </perfil_id> </target_perfil> <target_keyword> <keywords> <item id='1'> <tkeyword_id>112</tkeyword_id> <values> <item id='1'>1</item> <item id='2'>4</item> <item id='3'>6</item> <item id='4'>7</item> </values> <comparacion>1</comparacion> </item> <item id='2'> <tkeyword_id>113</tkeyword_id> <values> <item id='1'>PalabraClave1</item> <item id='2'>PalabraClave2</item> </values> <comparacion>5</comparacion> </item> </keywords> <type>0</type> </target_keyword> <pago_sitio> <precio> <item id='1'> <precio>123123.0000</precio> <moneda_id>1</moneda_id> <tprecio>4</tprecio> </item> </precio> <tmodo>1</tmodo> </pago_sitio> <intervalo_activacion>4</intervalo_activacion> <precio_venta_anunciante> <precio> <item id='1'> <nombre_espacio>Seccion_Deportes- Espacio_1</nombre_espacio> <precio>99999.0000</precio> <moneda_id>5</moneda_id> <tprecio>4</tprecio> <espacio_id>28360</espacio_id> </item> <item id='2'> <nombre_espacio>Seccion_Deportes - Espacio_2</nombre_espacio> <precio>123124.0000</precio> <moneda_id>5</moneda_id> <tprecio>4</tprecio> <espacio_id>38989</espacio_id> </item> </precio> <tmodo>3</tmodo> </precio_venta_anunciante> <observaciones> Estas son las observaciones de la pauta</observaciones> </pauta> |