次の方法で共有


クリエイティブ HTML サービス

クリエイティブ HTML サービスを使用して、HTML5 クリエイティブを AppNexus に追加できます。 すべてのクリエイティブを広告主またはパブリッシャーにアタッチする必要があります。

  • 広告主サービスを呼び出すことで 、広告主 ID を表示できます。
  • パブリッシャー サービスを呼び出すことで、 発行元 ID を表示できます。
  • クリエイティブをパブリッシャーにアタッチして、プレースメントの既定のクリエイティブとして使用できます。 その後、プレースメント サービスを使用して、その ID を使用してクリエイティブを プレースメントにアタッチします。

注:

media_asset_id は、ホストされている HTML5 クリエイティブをアップロードするために必要です。 詳細については、以下の 「例 」セクションを参照してください。

監査

AppNexus は、ブランドと評判に深く関心を持つメンバーと連携します。 そのため、システムを通過する広告(クリエイティブ)が全ての関係者に受け入れられるよう注意を払っています。 品質保証のため、サード パーティの広告枠で配信するすべてのクリエイティブは、クリエイティブ サービスを使用して事前に登録する必要があります。

  • クリエイティブは、media_url (サードパーティの広告サーバー URL または Flash またはビデオ ファイルのコンテンツ配信ネットワーク URL) によって識別されます。
  • AppNexus は、定期的にmedia_urlsをチェックします。 ファイルが消えた場合、クリエイティブは監査されていないものとして扱われます。
  • クリエイティブが AppNexus 監査に合格すると、クリエイティブに対する特定の変更によって、そのクリエイティブが監査のために再送信されます。 詳細については、以下の 「再監査の原因となる変更 」を参照してください。
  • 監査の詳細については、「 クリエイティブスタンダードと監査」を参照してください。

REST API

HTTP メソッド エンドポイント 説明
POST https://api.appnexus.com/creative-html?advertiser_id=ADVERTISER_ID
(クリエイティブ JSON)
新しいホスト型 HTML5 クリエイティブをいずれかの広告主に追加します。
POST https://api.appnexus.com/creative-html?publisher_id=PUBLISHER_ID
(クリエイティブ JSON)
新しい HTML5 クリエイティブをいずれかのパブリッシャーに追加します。
PUT - https://api.appnexus.com/creative-html?id=CREATIVE_ID&advertiser_id=ADVERTISER_ID
- https://api.appnexus.com/creative-html?id=CREATIVE_ID&p ublisher_id=PUBLISHER_ID
既存のホストされている HTML5 クリエイティブを変更します。
GET https://api.appnexus.com/creative-html ホストされているすべての HTML5 クリエイティブを表示します。
GET - https://api.appnexus.com/creative-html?advertiser_id=ADVERTISER_ID
- https://api.appnexus.com/creative-html?advertiser_code=ADVERTISER_CODE
- https://api.appnexus.com/creative-html?publisher_id=PUBLISHER_ID
- https://api.appnexus.com/creative-html?publisher_code=PUBLISHER_CODE
広告主またはパブリッシャー向けのホストされているすべての HTML5 クリエイティブを表示します。

注:
クリエイティブの最初と最後の配信日に基づいてフィルター処理できます。 これは、 オブジェクトの制限 に近づき、システムから削除できるクリエイティブを特定する必要がある場合に特に便利です。 詳細については、以下の 「最初の実行/最後の実行」を 参照してください。
GET - https://api.appnexus.com/creative-html?id=CREATIVE_ID
- https://api.appnexus.com/creative-html?code=CREATIVE_CODE
特定のクリエイティブを表示します。
GET https://api.appnexus.com/creative-html?id=1,2,3 コンマ区切りリストを使用して、ID で複数のクリエイティブを表示します。
GET https://api.appnexus.com/creative-html?audit_stats=true クリエイティブ監査統計を表示します。

注:
応答では、AppNexus、Microsoft、Google の各監査ステータスを持つクリエイティブの数が示されます。 応答形式については、以下 の例を 参照してください。
DELETE - https://api.appnexus.com/creative-html?id=CREATIVE_ID&advertiser_id=ADVERTISER_ID
- https://api.appnexus.com/creative-html?id=CREATIVE_ID&p ublisher_id=PUBLISHER_ID
クリエイティブを削除します。

注:
メンバーまたはプレースメントの既定のクリエイティブとして使用されているクリエイティブは削除できません。 既定のクリエイティブは、プレースメントとの関連付けを解除した後に削除できます。

JSON フィールド

フィールド 種類 説明
id int クリエイティブに関連付けられている内部 ID。
デフォルト: 自動生成された数値。
クエリ文字列で必要な On:PUT
code string (100) クリエイティブのカスタム コード。
code2 string (100) クリエイティブの追加のカスタム コード。 line_items内の各オブジェクト。
name string (100) クリエイティブの名前。
type 列挙 クリエイティブの種類。 使用可能な値:
"html"

注:
アルファベータ通知: このフィールドまたは機能は、現在アルファフェーズまたはベータフェーズの機能の一部です。 そのため、変更される可能性があります。

読み取り専用。
height int 高さのクリエイティブのサイズ。
width int 幅のクリエイティブのサイズ。
advertiser_id int クリエイティブがアタッチされている広告主の ID。
クリエイティブが広告主にアタッチされている場合は、クエリ文字列で[オン]:[POST/PUTが必要です。
publisher_id int クリエイティブがアタッチされている発行元/メディア購入の ID。
クリエイティブがパブリッシャーにアタッチされている場合は、クエリ文字列で On:POST/PUT が必要です。
brand_id int クリエイティブを宣伝する会社のブランドの ID。 含まれている場合は、AppNexus 監査チームによって検証されます。 含まれていない場合は、監査チームによって割り当てられます。 ブランドの完全な一覧を取得するには、 ブランド サービスに関するページを参照してください。
state 列挙 クリエイティブの状態。 使用可能な値: "active" または "inactive"
読み取り専用。
status object クリエイティブが配信する準備ができているかどうかを説明するクリエイティブの状態。 詳細については、以下の 「状態 」を参照してください。
click_track_result 列挙 クリック トラック テストの結果。コンソール ユーザー インターフェイスでのみ使用できる機能です。 使用可能な値: "not_tested""passed"、または "failed"
デフォルト:"not_tested"
campaigns オブジェクトの配列 クリエイティブが関連付けられているキャンペーンの一覧。 詳細については、以下 の「キャンペーン 」を参照してください。

注:
このフィールドは、クエリ文字列に advertiser_id が指定されている場合にのみ返されます。
template object クリエイティブの形式とメディアの種類のクリエイティブ テンプレート (例: template_id 6439)。 テンプレートには、クリエイティブが Web ページでどのようにレンダリングされるかを制御するコードが含まれています。
使用可能な値:
- HTML マルチアセット - 標準: 8606
- HTML マルチアセット - スポット: 8607
- HTML マルチアセット - 展開可能: 8608
必須:POST
詳細については、以下 の例を 参照してください。
media_url string (1000) クリエイティブの URL - フラッシュ、HTML、javascript を指定できます (形式を参照)。
コンテンツを使用していない場合は、On:POST 必須。
このフィールドは、サード パーティのクリエイティブにのみ適用されます。 HTML5 クリエイティブの場合は空白のままにします。
media_url_secure string (1000) セキュア (HTTPS) クリエイティブの URL - フラッシュ、HTML、javascript (形式を参照) して、セキュリティで保護された広告通話で配信できます。
このフィールドは、サード パーティのクリエイティブにのみ適用されます。 HTML5 クリエイティブの場合は空白のままにします。
click_url string (2000) サード パーティ以外のイメージとフラッシュ クリエイティブの (省略可能) ランディング ページ URL。

注:
この値は、"http://" または "https://" で始まる必要があります
テンプレートが"image"形式の場合は、On:POST 必須
file_name string (1000) このフィールドは、ホストされているビデオ クリエイティブには適用されません。
audit_status 列挙 クリエイティブの監査状態。 使用可能な値: "no_audit""pending""rejected"、または "audited"

注:
- allow_audit が false の場合、このフィールドは "no_audit"する必要があります。
- クリエイティブの有効期限が切れている場合は、このフィールドを変更して再アニメーション化できます。 "pending"に設定すると、監査のために再送信されます。 監査のためにクリエイティブを自動的に再送信する変更については、以下の「 再監査の原因となる変更 」を参照してください。
デフォルト:"pending"
audit_feedback string クリエイティブ監査チームは、このフィールドでクリエイティブに関するメッセージを渡すことができます。
読み取り専用。
allow_audit ブール型 true場合、クリエイティブは監査のために送信されます。 false場合、クリエイティブは送信されません。 監査されていないクリエイティブは、ネットワークのマネージド インベントリでのみ実行できます。

注:
- audit_status"no_audit"されている場合、このフィールドは "false" である必要があります。
- メンバーがまだアクティブでない場合は、クリエイティブを追加できますが、監査のために送信されることはありません (allow_audit は false になります)。 メンバーがアクティブ化されたら、これらのクリエイティブを監査する場合は、クリエイティブを更新し、 allow_audit を true に設定する必要があります。
デフォルト:true
ssl_status 列挙 クリエイティブの ssl (HTTPS) の状態。 ssl_status = 承認済みのクリエイティブのみが、安全な在庫で配信できます。

注:
クリエイティブが ssl Sherlock 監査に失敗した場合は、このフィールドを "保留中" に変更することで、(ダウンストリームのセキュリティで保護されていないコンテンツを修正したら) 再テスト用に送信できます。 有効な値は次のとおりです。
- "disabled"
- "pending"
- "approved"
- "failed"

デフォルト:"disabled"
allow_ssl_audit ブール型 true場合、クリエイティブはセキュリティで保護された (HTTPS) 監査のために送信されます。 false場合、クリエイティブは送信されません。 true場合は、media_url_secureまたはcontent_secureも必要です。
デフォルト:false
google_audit_status 列挙 非推奨。 代わりに「 adx_audit 」を参照してください。
google_audit_feedback string 非推奨。 代わりに「 adx_audit 」を参照してください。
msft_audit_status 列挙 廃止。
msft_audit_feedback string 廃止。
is_self_audited ブール型 true場合、クリエイティブは自己監査されるため、プラットフォーム (AppNexus) 監査は行われません。 クリエイティブは、自己分類クリエイティブを受け入れるインベントリ、または監査されていないクリエイティブを受け入れるインベントリでのみ配信できます。
デフォルト:false
is_expired ブール型 クリエイティブ (1) が実行されておらず、(2) が 45 日以内に変更されていない場合、自動的に期限切れとマークされ、インベントリに配信されません。
- サード パーティのインベントリで実行するには、期限切れのクリエイティブを再監査する必要があります。 サード パーティのインベントリのクリエイティブの展開を解除するには、[ audit_status ] を [ "pending"] に設定します。
- 期限切れのクリエイティブは、直接在庫で実行するために再監査する必要はありません。 直接在庫のクリエイティブの展開を解除するには、 audit_status を [ "no_audit"] に設定します。
デフォルト:false
読み取り専用。
is_prohibited ブール型 Sherlock は、マルウェアを持っているか、ブロックされたドメインを読み込むためのクリエイティブにフラグを設定する場合は、クリエイティブが配信されないように true に設定されます。
デフォルト:false
読み取り専用。
is_hosted ブール型 true場合、クリエイティブは AppNexus によってホストされます。
読み取り専用。
lifetime_budget double ドル単位の生涯予算。

注:
このフィールドを GET 応答に含めるには、クエリ文字列に attributes=1 を渡します。
デフォルト:unlimited
lifetime_budget_imps int インプレッション数の有効期間制限。

注:
このフィールドを GET 応答に含めるには、クエリ文字列に attributes=1 を渡します。
デフォルト:unlimited
daily_budget double ドル単位の 1 日の予算。

注:
このフィールドを GET 応答に含めるには、クエリ文字列に attributes=1 を渡します。
デフォルト:unlimited
daily_budget_imps int インプレッション数の 1 日あたりの制限。

注:
このフィールドを GET 応答に含めるには、クエリ文字列に attributes=1 を渡します。
デフォルト:unlimited
enable_pacing ブール型 true場合、1 日の予算支出は 1 日を通じて均等に分散されます。

手記: このフィールドを GET 応答に含めるには、クエリ文字列に attributes=1 を渡します。
デフォルト:true
allow_safety_pacing ブール型 true場合、1 分あたりの支出は、生涯予算の最大 1% と 1 日の予算の 5% に制限されます。
管理者のみ。
profile_id int 性別や地域などのターゲット設定をクリエイティブにアタッチするには、プロファイルを作成し、ここで関連付けます。
folder object 便利なフォルダー (通常は UI) でクリエイティブを配置するには、 Creative Folder Service を使用してフォルダーを作成し、フォルダー ID またはクリエイティブ ID を使用してクリエイティブ フォルダー サービスに関連付けます。 出力が {"id": "41", "name": "MyFolder"}
line_items オブジェクトの配列 クリエイティブに関連付けられている広告申込情報。 詳細については、以下の 「行項目 」を参照してください。
is_control ブール型 これは、このクリエイティブを A/B テストのコントロール/テスト グループの一部としてマークするために使用されるフラグです。 詳細については、「 テストと制御のターゲット設定」を参照してください。
デフォルト:false
segments 配列 このクリエイティブを表示またはクリックしたときにユーザーが追加するセグメントの一覧。 詳細については、セグメントと以下を参照してください。
created_on timestamp このクリエイティブが作成された日時。 2010 年 1 月より前に作成された場合、これは 0 になります。
読み取り専用。
last_modified timestamp クリエイティブが最後に変更された日時。
読み取り専用。
categories オブジェクトの配列 クリエイティブとオファーの種類を表すカテゴリ。

注:
GET応答にカテゴリを含める場合は、クエリ文字列にattributes=1を渡します。 カテゴリの完全な一覧を取得するには、 カテゴリ サービス と以下の を参照してください。
adservers オブジェクトの配列 クリエイティブを配信する広告サーバー、またはクリエイティブの配信中にデータ収集のために呼び出される広告サーバー。

注:
GET応答に adservers を含める場合は、クエリ文字列にattributes=1を渡します。 広告サーバーの完全な一覧を取得するには、 Ad Server Service と以下の を参照してください。
読み取り専用。
technical_attributes オブジェクトの配列 "Expandable""Video"など、クリエイティブの技術的特性を表す属性。

注:
GET応答に技術属性を含めるには、クエリ文字列にattributes=1を渡します。 技術属性の完全な一覧を取得するには、 技術属性サービス と以下の を参照してください。
language object クリエイティブの言語。 言語の完全な一覧を取得するには、 言語サービス と以下の を参照してください。
brand object クリエイティブを宣伝する会社のブランドと、ブランドに関連するカテゴリ。 詳細については、以下の 「ブランド」 を参照してください。
読み取り専用。
sla int [0] に設定されたクリエイティブは、標準 SLA で監査のために送信されます。

注意: 0 以外の番号で送信されたクリエイティブは、優先監査 (有効な場合) と料金が発生します。
優先度監査のために AppNexus と補助サービス契約がある場合は、このフィールドを 2 に設定することで、優先度監査 (営業時間中に 2 時間以内に監査) 用のクリエイティブを送信できます。 優先監査の詳細については、「 クリエイティブスタンダードと監査」を参照してください。
sla_eta timestamp 優先度監査の完了の見積もり時間。
読み取り専用。
currency string 広告主の主通貨 ( USD など) を定義するコード。 使用できる通貨の種類の詳細については、「 Currency Service」を参照してください。
デフォルト: メンバーの既定の通貨。
読み取り専用。
first_run timestamp クリエイティブが最初に配信された日時を、1 時間ごとに更新します。 この値は UTC タイム ゾーンを反映します。 この情報を GET 応答に含めるには、クエリ文字列に flight_info=true を渡します。 クリエイティブの配信時期に基づいてクリエイティブをフィルター処理する方法の詳細については、以下の 「初回実行/最終実行 」を参照してください。
読み取り専用。
last_run timestamp クリエイティブが最後に配信された日時。1 時間ごとに更新されます。 この値は UTC タイム ゾーンを反映します。 この情報を GET 応答に含めるには、クエリ文字列に flight_info=true を渡します。 クリエイティブが最後に配信されたタイミングに基づく方法の詳細については、以下の 「初回実行/最終実行 」を参照してください。
読み取り専用。
competitive_brands オブジェクトの配列 この配列のブランドに関連付けられているクリエイティブは、 /mtj オークションでは一緒に配信されません。 競合ブランドの典型的な例は、コーラとペプシです。 以下 の「競合ブランド」を 参照してください。 システム内のブランドの詳細については、 ブランド サービスに関するページを参照してください。
competitive_categories オブジェクトの配列 この配列のカテゴリに関連付けられているクリエイティブは、 /mtj オークション (例: "デート" や "教育") で一緒に配信されることはありません。 以下の 「競合カテゴリ」を 参照してください。 クリエイティブ (およびブランド) に適用されるカテゴリの詳細については、 カテゴリ サービスに関するページを参照してください。
adx_audit object このオブジェクトには、クリエイティブの Google Ad Exchange 監査に関連する状態とフィードバックに関する情報が含まれます。 クリエイティブが承認されたかどうかに関する情報は、[ audit_status ] フィールドに返されます。
読み取り専用。
member_id int クリエイティブを所有するメンバーの ID。
custom_macros オブジェクトの配列 HTML5 クリエイティブには、API によって設定される HTML5_INDEX_FILE カスタム マクロが含まれます。
media_assets オブジェクトの配列 AppNexus でホストされているファイルをクリエイティブに関連付けるために使用されます。 このフィールドは、API 経由でファイルをアップロードするときに自動的に設定されます。
を参照してください。

注:
creative_field HTML5 クリエイティブの場合は常に null にする必要があります。

segments

"segments":[
{"id":11111,
"action":"add_on_view"
},
{"id":22222,
"action":"add_on_click"
}
]

categories

"categories":[{"id":"13","name":"Online Games"}]

adservers

"adservers":[{"id":"1","use_type":"adserver","name":"24/7 Real Media"}]

technical_attributes

"technical_attributes":[{"id":"1","name":"Image"}]

language

"language":{"id":"1","name":"English"}

media_assets

"media_assets":[
{
"media_asset_id":22,
"creative_field":null
}
]

行項目

line_items配列内の各オブジェクトには、次のフィールドが含まれます。 "id"または"code"フィールドの情報を取得するには、明細サービス - ALI を使用します。

フィールド 型 (長さ) 説明
name string 行項目の名前。
読み取り専用。
state 列挙 クリエイティブの状態。 使用可能な値: "active" または "inactive"
読み取り専用。
id int 明細の ID。 行項目の関連付けを更新する場合は、 "id" または "code" が必要です。
必須:PUT
code string 行項目のカスタム コード。 行項目の関連付けを更新する場合は、 "id" または "code" が必要です。
必須:PUT

キャンペーン

campaigns配列内の各オブジェクトには、次のフィールドが含まれます。 "id"または"code"フィールドの情報を取得するには、キャンペーン サービスを使用できます。

フィールド 型 (長さ) 説明
id int キャンペーンの ID。 キャンペーンの関連付けを更新する場合は、 "id" または "code" が必要です。
必須:PUT
campaign_id int キャンペーンの ID。
creative_id int クリエイティブの ID。
name string キャンペーンの名前。
読み取り専用。
state 列挙 キャンペーンの状態。 使用可能な値: "active""inactive"、または "parent_inactive"
読み取り専用。
code string キャンペーンのカスタム コード。 行項目の関連付けを更新する場合は、 "id" または "code" が必要です。
必須:PUT

状態

名前 種類 説明
user_ready ブール値 クリエイティブが配信の準備ができているかどうかを説明する、ユーザーが設定したクリエイティブの状態。 使用可能な値: "true" または "false"
デフォルト:true
hosted_assets_association_complete boolean/null AppNexus の内部システムによってアップロードされたクリエイティブの状態。 使用可能な値: ホストされているクリエイティブの "true" または "false" 、サード パーティのクリエイティブの "null"
読み取り専用。

競争力のあるブランド

注:

ブランドの詳細については、 ブランド サービスに関するページを参照してください。

名前 種類 説明
id int ブランドの ID。
デフォルト: N/A
必須: N/A
name string ブランドの名前。
デフォルト: N/A
必須: N/A

競合カテゴリ

注:

カテゴリの詳細については、 カテゴリ サービスに関するページを参照してください。

名前 種類 説明
id int カテゴリの ID。
デフォルト: N/A
必須: N/A
name string カテゴリの名前。
デフォルト: N/A
必須: N/A

セグメント

これらのフィールドは、Segments 配列に含まれます。

フィールド 種類 説明
id int セグメントの ID。
必須 On:POSTPUT
segment_id int セグメントの ID。 このフィールドには、 id フィールドと同じ情報が含まれています。
action 列挙 ユーザーがセグメントに追加するアクション。 使用可能な値: "add on view" または "add on click"
必須 On:POSTPUT
name string セグメントの名前。

ブランド

brand オブジェクトには、次のフィールドが含まれています。

注:

このオブジェクトは 読み取り専用です。 クリエイティブのブランドを設定するには、このオブジェクトの外部にある [ brand_id ] フィールドを使用します。

フィールド 種類 説明
id int クリエイティブを宣伝する会社のブランドの ID。
読み取り専用。
name string クリエイティブを宣伝する会社のブランドの名前。
読み取り専用。
category_id int ブランドに関連付けられているカテゴリの ID。
読み取り専用。
category_name string ブランドに関連付けられているカテゴリの名前。

手記:category_name フィールドは、呼び出しのクエリ文字列にpassshow_category_name=trueした場合にのみ返されます。
読み取り専用。

最初の実行/最後の実行

GET応答にfirst_runフィールドとlast_runフィールドを含める場合は、クエリ文字列にflight_info=trueを渡します。 クリエイティブの最初と最後の配信時間に基づいて、次のようにフィルター処理することもできます。

配信したことがないクリエイティブのみを取得する

クエリ文字列に never_run=true を渡します。

curl -b cookies -c cookies 'https://api.appnexus.com/creative-html?advertiser_id=100&flight_info=true&never_run=true'

注:

never_run=trueは他のフィルターと組み合わせて使用できますが、常に OR リレーションシップであることに注意してください。 たとえば、クエリ文字列に never_run=truemin_first_run=2012-01-01 00:00:00 の両方を渡すと、2012-01-01 以降に配信された広告申込情報や広告申込情報を配信したことがないクリエイティブが検索されます。

特定の日付以降に配信されたクリエイティブのみを取得する

クエリ文字列に min_first_run=YYYY-MM-DD HH:MM:SS を渡します。

curl -b cookies -c cookies 'https://api.appnexus.com/creative-html?advertiser_id=100&flight_info=true&min_first_run=2012-01-01 00:00:00'

特定の日付以前に配信されたクリエイティブのみを取得する

クエリ文字列に max_first_run=YYYY-MM-DD HH:MM:SS を渡します。

curl -b cookies -c cookies 'https://api.appnexus.com/creative-html?advertiser_id=100&flight_info=true&max_first_run=2012-08-01 00:00:00'

特定の日付範囲内で最初に配信されたクリエイティブのみを取得する

クエリ文字列に min_first_run=YYYY-MM-DD HH:MM:SS&max_first_run=YYYY-MM-DD HH:MM:SS を渡します。

curl -b cookies -c cookies 'https://api.appnexus.com/creative-html?advertiser_id=100&flight_info=true&min_first_run=2012-01-01 00:00:00&max_first_run=2012-08-01 00:00:00'

特定の日付以降に最後に配信されたクリエイティブのみを取得する

クエリ文字列に min_last_run=YYYY-MM-DD HH:MM:SS を渡します。

curl -b cookies -c cookies 'https://api.appnexus.com/creative-html?advertiser_id=100&flight_info=true&min_last_run=2012-01-01 00:00:00'

特定の日付以前に最後に配信されたクリエイティブのみを取得する

クエリ文字列に max_last_run=YYYY-MM-DD HH:MM:SS を渡します。

curl -b cookies -c cookies 'https://api.appnexus.com/creative-html?advertiser_id=100&flight_info=true&max_last_run=2012-08-01 00:00:00'

特定の日付範囲内で最後に配信されたクリエイティブのみを取得する

クエリ文字列に min_last_run=YYYY-MM-DD HH:MM:SS&max_last_run=YYYY-MM-DD HH:MM:SS を渡します。

curl -b cookies -c cookies 'https://api.appnexus.com/creative-html?advertiser_id=100&flight_info=true&min_last_run=2012-01-01 00:00:00&max_last_run=2012-08-01 00:00:00'

再監査の原因となる変更

クリエイティブが AppNexus 監査に合格すると (audit_status"audited")、次のいずれかのフィールドを変更すると、クリエイティブは監査のために再送信されます (allow_audit"pending"に設定されます)。

  • media_url
  • click_url
  • language
  • categories
  • technical_attributes
  • brand_id
  • pixel_url
  • video_attribute
  • media_asset

また、 audit_status"no_audit"されている場合、 allow_audit"false" から "true" に変更すると、クリエイティブが AppNexus 監査のために再送信されます。

HTML5 クリエイティブをアップロードする

AppNexus を使用してホスティング用のクリエイティブをアップロードする場合:

手順 1:クリエイティブ アップロード サービスにアセットをアップロードします。

curl -X POST -H "Authorization: hbapi:139072:5761726637ada:nym2" --form "type=html" --form "file=@./AppNexus_30_1280_720_2500k.zip" "https://api.appnexus.com/creative-upload?member_id=123"

media_asset_idが返されます。

{
    "response": 
        "status": "OK",
        "count": 0,
        "start_element": 0,
        "num_elements": 0,
        "media-asset": [
            {
                "id": 54621,
                "parent_media_asset_id": null,
                "member_id": 123,
                "advertiser_id": null,
                "publisher_id": null,
                "file_name": "AppNexus_30_1280_720_2500k.zip",
                "size_in_bytes": 8358845,
                "cdn_uploaded_on": null,
                "cdn_url": null,
                "cdn_secure_url": null,
                "created_on": "2016-06-15 15:33:17",
                "last_modified": "2016-06-15 15:33:17",
                "deleted": false,
                "media_asset_status": [
                    {
                        "id": 54621,
                        "media_asset_id": 54621,
                        "error_message": null,
                        "local_path": "03/36/2e/66/03362e66-674a-41b3-9477-fcd979cdbf0b/03362e66-674a-41b3-9477-fcd979cdbf0b.zip",
                        "cdn_upload_attempt_count": 0,
                        "created_on": "2016-06-15 15:33:17",
                        "last_modified": "2016-06-15 15:33:17",
                        "deleted": false,
                        "status": "on_shared_storage"
                    }
                ],
                "media_asset_video": null,
                "media_asset_html5": null,
                "asset_type": "html",
                "mime_type": "zip" 
            }
        ]
    }

手順 2:media_asset_idを使用してクリエイティブをアップロードします。

$ cat creative_html

{
    "creative-html": {
        "name": "upload_hosted_html5.zip",
        "template":{
            "id":8606
            },
        "media_assets": 
           [{
               "media_asset_id": 54621
            }
        ],
        "width":120
        "height":600
        "click_url": "https://appnexus.com",
        "advertiser_id": 164979,
        "segments": null,
        "allow_audit": true,
        "is_self_audited": false,
        "sla": 0
    }
}
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 12345678,
        "start_element": 0,
        "num_elements": 100,
        "creative-html": {
            "name": "upload_hosted_html5.zip",
            "brand_id": 1,
            "media_url": "http://appnexus.com",
            "id": 12345678,
            ...
            "track_clicks": true,
            "audit_status": "pending",
            ...
            "media_url_secure": "https://appnexus.com",
            ...
            "is_hosted": true,
            ...
            "language": {
                "id": 1,
                "name": "English"
            },
            ...
            },
            "template": {
                "id": 8606,
                "name": "HTML Multi Asset - Standard",
            },
            ...
            "media_assets": [
                {
                    "media_asset_id": 54621
                }
            ],
            ...
            "currency": "USD",
            "type": "html"
        },
        ...
    }
    }