Service Dossier créatif

Le service dossier créatif vous permet de regrouper des créations à des fins organisationnelles. Vous pouvez ajouter plusieurs créations à la fois à un dossier au fur et à mesure que vous le créez.

API REST

HTTP, méthode	Endpoint	Description
GET	https://api.appnexus.com/creative-folder?advertiser_id=ADVERTISER_ID	Afficher tous les dossiers créatifs (vous devez spécifier l’annonceur).
GET	https://api.appnexus.com/creative-folder?advertiser_id=ADVERTISER_ID& id=FOLDER_ID	Afficher un dossier créatif spécifique.
POST	https://api.appnexus.com/creative-folder?advertiser_id=ADVERTISER_ID (creative-folder JSON)	Ajoutez un nouveau dossier créatif (vous pouvez ajouter des éléments créatifs au dossier dans cette action ou par la suite).
POST	https://api.appnexus.com/creative-folder?advertiser_id=ADVERTISER_ID (creative-folder JSON)	Ajoutez un nouveau contenu créatif à l’un de vos dossiers.
PUT	https://api.appnexus.com/creative-folder?id=CREATIVE_ID& advertiser_id=ADVERTISER_ID (creative-folder JSON)	Modifier un dossier créatif existant.
DELETE	https://api.appnexus.com/creative-folder?advertiser_id=ADVERTISER_ID& id=FOLDER_ID	Supprimez un dossier créatif existant.

Champs JSON

Champ	Type	Description
id	int	ID interne associé au dossier créatif.
parent_id	int	Déconseillée.
name	string	Nom facultatif du dossier créatif.
advertiser_id	int	Toutes les créations sont attachées à un annonceur ou à un éditeur au moment de la création.
creatives	tableau d’objets	Liste des créations que vous souhaitez inclure dans ce dossier, ou liste des créations déjà dans le dossier, en fonction de votre demande.
last_modified	Timestamp	Date et heure de la dernière modification du dossier créatif.

Exemples

Ajouter un dossier créatif qui contient deux éléments créatifs (préexistants)

{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}

Afficher tous les dossiers de l’annonceur 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}

Ajouter un élément créatif à un dossier créatif existant

Veillez à inclure append=true dans votre instruction de requête. Si vous laissez cela désactivé, toutes les créations existantes dans le dossier seront remplacées.

$ 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
  }
}