Servicio de carpeta creativa

El servicio de carpeta creativa permite agrupar las creatividades con fines organizativos. Puede agregar varias creatividades a la vez a una carpeta mientras la crea.

API de REST

Http (método)	Endpoint	Description
GET	https://api.appnexus.com/creative-folder?advertiser_id=ADVERTISER_ID	Ver todas las carpetas creativas (debe especificar el anunciante).
GET	https://api.appnexus.com/creative-folder?advertiser_id=ADVERTISER_ID& id=FOLDER_ID	Ver una carpeta creativa específica.
POST	https://api.appnexus.com/creative-folder?advertiser_id=ADVERTISER_ID (JSON de carpeta creativa)	Agregue una nueva carpeta creativa (puede agregar creatividades a la carpeta en esta acción o después).
POST	https://api.appnexus.com/creative-folder?advertiser_id=ADVERTISER_ID (JSON de carpeta creativa)	Agregue una nueva creatividad a una de las carpetas.
PUT	https://api.appnexus.com/creative-folder?id=CREATIVE_ID& advertiser_id=ADVERTISER_ID (JSON de carpeta creativa)	Modifique una carpeta creativa existente.
DELETE	https://api.appnexus.com/creative-folder?advertiser_id=ADVERTISER_ID& id=FOLDER_ID	Elimine una carpeta creativa existente.

Campos JSON

Campo	Tipo	Description
id	Entero	Identificador interno asociado a la carpeta creativa.
parent_id	Entero	Obsoleto.
name	string	Nombre opcional de la carpeta creativa.
advertiser_id	Entero	Todas las creatividades se adjuntan a un anunciante o editor en el momento de la creación.
creatives	matriz de objetos	Lista de creatividades que desea incluir en esta carpeta o lista de creatividades que ya están en la carpeta, en función de su solicitud.
last_modified	Timestamp	Fecha y hora en que se modificó por última vez la carpeta creativa.

Ejemplos

Agregar una carpeta creativa que contenga dos creatividades (ya existentes)

{code}$ cat creative-folder

{
    "creative-folder":{
        "creatives":[{
                "id":246305
            },
            {
                "id":246221
            }
        ]
    }
}

$ curl -b cookies -c cookies -X POST -d @creative-folder 'https://api.appnexus.com/creative-folder?advertiser_id=493'

{
  "response": {
    "status": "OK",
    "id": 338
  }
}
{code}

Ver todas las carpetas del anunciante 493

{code}$ curl -b cookies -c cookies 'https://api.appnexus.com/creative-folder?advertiser_id=493'

{
  "response": {
    "creative-folders": [
      {
        "id": 81,
        "parent_id": null,
        "advertiser_id": 493,
        "name": "Hosted Images",
        "last_modified": "2010-03-31 21:26:59",
        "creatives": [
          {
            "id": "14900"
          }
        ]
      },
      {
        "id": 82,
        "parent_id": null,
        "advertiser_id": 493,
        "name": "3rd party images",
        "last_modified": "2010-03-31 21:27:07",
        "creatives": [
          {
            "id": "246305"
          }
        ]
      },
      {
        "id": 152,
        "parent_id": null,
        "advertiser_id": 493,
        "name": "an-creatives-2",
        "last_modified": "2010-08-05 15:18:50",
        "creatives": [
          {
            "id": "246214"
          },
          {
            "id": "246215"
          },
          {
            "id": "246216"
          },
          {
            "id": "246217"
          },
          {
            "id": "246218"
          },
          {
            "id": "246219"
          },
          {
            "id": "246220"
          },
          {
            "id": "246221"
          }
        ]
      },
      {
        "id": 338,
        "parent_id": null,
        "advertiser_id": 493,
        "name": null,
        "last_modified": "2011-06-20 19:15:18",
        "creatives": [
          {
            "id": "246221"
          },
          {
            "id": "246305"
          }
        ]
      }
    ],
    "status": "OK",
    "count": 4,
    "start_element": 0,
    "num_elements": 100
  }
}
{code}

Adición de una creatividad a una carpeta creativa existente

Asegúrese de incluir append=true en la instrucción de consulta. Si lo deja desactivado, se sobrescribirán todas las creatividades existentes en la carpeta.

$ cat creative-folder

{
    "creative-folder":{
        "creatives":[{
                "id":876543
            }
        ]
    }
}

curl -b cookies -X PUT -d @creative-folder 'https://api.appnexus.com/creative-folder?id=338&advertiser_id=493&append=true'

{
  "response": {
    "status": "OK",
    "id": 338
  }
}