The request must be done through POST method.

URL: /admin/adnet/pub/admin/pautas.html?op=m&o=xml

If the option “advanced selection criteria” is enabled, please see the section “Campaign advanced selection criteria” contained in this manual.

Requirements:

• The campaign must be created already
• Campaign identifier must be known (pauta_id)
• The campaign must not have been cancelled
• All the requirements for campaign creation

Mandatory parameters:

The pauta_id parameter must be included, along with the campaign identifier and all the same parameters as per campaign creation. None should be omitted, with the following exceptions:

• If the campaign is already running, the neither parameters fecha_inicio nor hora_inicio can be modified, therefore it is not necessary to include it in the request.  

Optional parameters:
The same as per the campaign creation.

Request example:
URL: /admin/adnet/pub/admin/pautas.html?op=m&o=xml

Parameters:
pauta_id=43242&nombre=Test+CPM&sitio_id=52432&tipoventa_id=1&cantidad_total=100000&prioridad=1&peso=1&intervalo_activacion=1&fecha_inicio=23/03/2006&fecha_fin=23/04/2006&hora_inicio=15:00:00&hora_fin=23:59:59&ptmodo_id=1&target_sitio_id=13212&target_espacio_id=45234+541+4256&accion_retraso_fecha_fin=0

Parameters explanation:

• pauta_id: campaign identifier
• nombre: CPM test
• sitio_id: 52432 – campaign advertiser ID
• tipoventa_id: 1 (CPM campaign)
• cantidad_total: 100,000 impressions
• prioridad: 1
• peso: 1
• intervalo_activacion: one start and end date
• fecha_inicio: 23/03/2006
• fecha_fin: 23/04/2006
• hora_inicio: 15:00:00
• hora_fin: 23:59:59
• ptmodo_id: 1 – even distribution of impressions
• target_sitio_id: 13212 – site identifier where the campaign will run.
• target_espacio_id: 45234, 541, 426.  The campaign will tun in these 3 ad spaces.
• accion_retraso_fecha_fin: 0 – continue running until the amount is reached.
• All the parameters from advanced selection criteria explained below.

Response:

It contains an object <operacion> that contains a tag <resultado>. The result could be either 1 (successful operation) or 0 (failed operation). 

If the operation is unsuccessful, it adds a list of errors through tags <error>, containing the attribute that specifies the attribute's name with error, and message with the error message.

Response example without errors:

<operacion>     <resultado>1</resultado> </operacion>

Response example with errors:

<operacion>     <resultado>0</resultado>     <errores>         <error atributo=”nombre” mensaje=”Invalid option”/>         <error atributo=”anunciante_id” mensaje=”Invalid option”>         <error atributo=”fecha_fin” mensaje=” The end date cannot be less than the start date”>     </errores> </operacion>