Partager via

Creative Upload Service - Format de fichier

Le service Chargement créatif permet de charger un fichier et d’obtenir un objet multimédia en retour.

Remarque

Les ressources multimédias qui ne sont pas associées à un élément créatif peuvent être nettoyées à tout moment.

Vue d’ensemble du format

Le service de chargement créatif est une publication de formulaire en plusieurs parties. Quelques paramètres sont nécessaires pour construire le billet.

Le tableau suivant décrit l’ordre des formulaires qui composent le billet :

| Autorisation | Type de formulaire | Chargement de fichier de | formulaireAPI AppNexus |

Autorisation

Nom Type Description Exemple
Authorization string Jeton reçu lors de l’authentification auprès de l’API AppNexus. "hbapi:108172:05866d06f6964:nym2"

Pour plus d’informations, consultez Authentification d’API.

Type de formulaire

Utilisez le premier formulaire pour définir le type de fichier que vous souhaitez charger.

Nom Type Description Exemple
form string Définissez le type de fichier que vous souhaitez charger. --form "type=video"

Types de fichiers acceptés

Type Valeur
html « zip ».
video « webm »,"mkv »,"converter »,"vob »,"ogv »,"ogg »,"avi »,"mov »,"qt »,"wmv »,"rm »,"asf »,"mp4 »,"m4p »,"m4v »,"mpg »,"mp2 »,"mpeg »,"mpe »,"mpv »,"m2v »,"m4v »,"m4v »,
« 3gp »,"3g2 »,"f4v »,"f4p »,"f4a »,"f4b », « swf ».
audio « aac »,"webm »,"mkv »,"tm »,"vob »,"ogv »,"ogg »,"avi »,"mov »,"qt »,"wmv »,"rm »,"asf »,"mp3 »,"mp4 »,"m4p »,"m4v »,"mpg »,"mp2 »,"mpeg »,"mpe »,"mpv »,
« m2v »,"m4v »,"3gp »,"3g2 »,"f4v »,"f4p »,"f4a »,"f4b », « swf », « wav ».
image « jpeg », « jpg », « gif », « png », « swf ».
default

Remarque

.mov vidéos seront lues dans tous les navigateurs une fois le transcodage terminé, mais il peut y avoir un retard dans la préversion.

Chargement de fichier de formulaire

Utilisez le formulaire suivant pour définir le chemin d’accès au fichier que vous souhaitez charger.

Nom Type Description Exemple
form string Définissez le chemin d’accès au fichier que vous souhaitez charger. --form "file=@/Folder1/Folder2/Downloads/IMG_0332.JPG"

AppNexus API

Définissez l’URL de l’API AppNexus et pointez vers le point de creative-upload terminaison. L’ID de membre est requis.

Nom Type Description Exemple
URL string Définissez le protocole HTTP et le point de creative-upload terminaison. "https://api.appnexus.com/creative-upload?member_id=123"

Exemple

L’exemple suivant illustre un scénario dérivé d’un cas d’usage réel.

Un client charge un fichier image dans le membre 123.

Champ Valeur
Authorization hbapi:139072:5761726637ada:nym2
Form Type image
Form File Upload Folder1/Folder2/IMG_0332.JPG
AppNexus API https://api.appnexus.com/creative-upload?member_id=12

Un client charge un fichier image dans le membre 123

curl -X POST -H "Authorization: hbapi:139072:5761726637ada:nym2" --form "type=image" --form "file=@/Folder1/Folder2/IMG_0332.JPG" "https://api.appnexus.com/creative-upload?member_id=123"

"response":{  
      "status":"OK",
      "count":0,
      "start_element":0,
      "num_elements":0,
      "dbg_info":{  
         "instance":"05.media-asset-pipeline.prod.nym2",
         "db":"",
         "warnings":[  

         ],
         "start_microtime":1492716035.805,
         "time":5,
         "version":"",
         "output_term":"media-asset"
      },
      "media-asset":[  
         {  
            "id":1536691,
            "parent_media_asset_id":null,
            "member_id":123,
            "advertiser_id":null,
            "publisher_id":null,
            "file_name":"IMG_0332.JPG",
            "size_in_bytes":79400,
            "cdn_uploaded_on":null,
            "cdn_url":"http://vcdn.adnxs.com/p/creative-image/1b/ee/3d/95/1bee3d95-7042-4e10-b0bf-7f43e2e4322a.JPG",
            "cdn_secure_url":"https://vcdn.adnxs.com/p/creative-image/1b/ee/3d/95/1bee3d95-7042-4e10-b0bf-7f43e2e4322a.JPG",
            "created_on":"2017-04-20 19:20:35",
            "last_modified":"2017-04-20 19:20:35",
            "deleted":false,
            "media_asset_status":[  
               {  
                  "id":1536687,
                  "media_asset_id":1536691,
                  "error_message":null,
                  "local_path":"1b/ee/3d/95/1bee3d95-7042-4e10-b0bf-7f43e2e4322a.JPG",
                  "cdn_upload_attempt_count":0,
                  "created_on":"2017-04-20 19:20:35",
                  "last_modified":"2017-04-20 19:20:35",
                  "deleted":false,
                  "status":"on_shared_storage"
               }
            ],
            "media_asset_image":{  
               "id":1005450,
               "media_asset_id":1536691,
               "height":480,
               "width":640,
               "created_on":"2017-04-20 19:20:35",
               "last_activity":"2017-04-20 19:20:35",
               "deleted":false
            },
            "media_asset_video":null,
            "media_asset_html5":null,
            "asset_type":"image",
            "mime_type":"image/jpeg"
         }
      ]
   }
   }
  • Last updated on