/
Editing a campaign

Editing a campaign



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>