/
Información de Pauta

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>

 


Related content