Compartir a través de

Servicio de carga creativa: formato de archivo

  • Artículo

El servicio De carga creativa proporciona la capacidad de cargar un archivo y obtener un objeto de recurso multimedia a cambio.

Nota:

Los recursos multimedia que no están asociados a un creativo se pueden limpiar en cualquier momento.

Introducción al formato

El servicio de carga creativa es una publicación de formulario de varias partes. Hay algunos parámetros necesarios para construir la publicación.

En la tabla siguiente se describe el orden de los formularios que componen la publicación:

| Autorización | Tipo de | formularioCarga | de archivos de formularioAPI de AppNexus |

Autorización

Nombre Tipo Description Ejemplo
Authorization string Token recibido cuando se autentica en AppNexus API. "hbapi:108172:05866d06f6964:nym2"

Para obtener más información, consulte Autenticación de API.

Tipo de formulario

Use el primer formulario para definir el tipo de archivo que desea cargar.

Nombre Tipo Description Ejemplo
form string Defina el tipo de archivo que desea cargar. --form "type=video"

Tipos de archivo aceptados

Tipo Valor
html "zip".
video "webm","mkv","flv","vob","ogv","ogg","avi","mov","qt","wmv","rm","asf","mp4","m4p","m4v","mpg","mp2","mpeg","mpe","mpv","m2v","m4v",
"3gp","3g2","f4v","f4p","f4a", "f4b", "swf".
audio "aac","webm","mkv","flv","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

Nota:

.mov vídeos se reproducirán en todos los exploradores una vez que el vídeo termine de transcodificarse, sin embargo, puede haber un retraso en la vista previa.

Carga de archivos de formulario

Use el siguiente formulario para definir la ruta de acceso al archivo que desea cargar.

Nombre Tipo Description Ejemplo
form string Defina la ruta de acceso al archivo que desea cargar. --form "file=@/Folder1/Folder2/Downloads/IMG_0332.JPG"

AppNexus API

Defina la dirección URL a la API AppNexus y apunte al creative-upload punto final. Se requiere el identificador de miembro.

Nombre Tipo Description Ejemplo
URL string Defina el protocolo HTTP y el punto de creative-upload conexión. "https://api.appnexus.com/creative-upload?member_id=123"

Ejemplo

En el ejemplo siguiente se muestra un escenario derivado de un caso de uso real.

Un cliente carga un archivo de imagen en el miembro 123.

Campo Valor
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 cliente carga un archivo de imagen en el miembro 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"
         }
      ]
   }
   }