次の方法で共有

クリエイティブ アップロード サービス - ファイル形式

  • [アーティクル]

Creative Upload サービスでは、ファイルをアップロードし、見返りとして メディア アセット オブジェクト を取得できます。

注:

クリエイティブに関連付けられていないメディアアセットは、いつでもクリーンアップできます。

書式の概要

クリエイティブアップロードサービスは、マルチパートフォーム投稿です。 ポストを構築するには、いくつかのパラメーターが必要です。

次の表は、投稿を構成するフォームの順序を示しています。

| 承認 | フォームの種類 | フォーム ファイルのアップロード | AppNexus API |

Authorization

名前 型 説明 例
Authorization string AppNexus API に対して認証されたときに受け取ったトークン。 "hbapi:108172:05866d06f6964:nym2"

詳細については、「 API 認証」を参照してください。

フォームの種類

最初のフォームを使用して、アップロードするファイルの 種類 を定義します。

名前 型 説明 例
form string アップロードするファイルの種類を定義します。 --form "type=video"

受け入れられるファイルの種類

型 値
html "zip"
video "webm","mkv","wmv","vob","ogv","ogg","avi","mov","qt","wmv","rm","asf","mp4","m4p","m4v","mpg",mp2",mpe","mpv","mpv","m2v","m4v",
"3gp","3g2","f4v","f4p","f4a","f4b", "wf"
audio "aac","webm","mkv","flv","vob","ogv","ogg","avi","mov","qt","wmv","rm","asf","mp3","mp4","m4p",m4v","mpg","mpg","mpeg","mpe","mpv",
"m2v","m4v","3gp","3g2","f4v","f4p","f4a","f4b", "wf", "wav"
image "jpeg"、"jpg"、"gif"、"png"、"bmp"。
default

注:

.movビデオは、ビデオのトランスコードが完了した後にすべてのブラウザーで再生されますが、プレビューに遅延が生じる可能性があります。

フォーム ファイルのアップロード

次のフォームを使用して、アップロードするファイルへの パス を定義します。

名前 型 説明 例
form string アップロードするファイルのパスを定義します。 --form "file=@/Folder1/Folder2/Downloads/IMG_0332.JPG"

AppNexus API

AppNexus API の URL を 定義し、エンドポイントを creative-upload ポイントします。 メンバー ID が必要です。

名前 型 説明 例
URL string HTTP プロトコルとエンドポイントを定義します creative-upload 。 "https://api.appnexus.com/creative-upload?member_id=123"

例

次の例は、実際のユース ケースから派生したシナリオを示しています。

クライアントがイメージ・ファイルをメンバー 123 にアップロードしています。

フィールド 値
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

クライアントがイメージ ファイルをメンバー 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"
         }
      ]
   }
   }