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

Creative HTML Service を使用して、HTML5 クリエイティブを AppNexus に追加できます。すべてのクリエイティブは、広告主またはパブリッシャーに添付されている必要があります。

広告主サービスを呼び出すことで、広告主 ID を確認できます。
パブリッシャーサービスを呼び出すことで、パブリッシャー ID を確認できます。
クリエイティブをパブリッシャーにアタッチして、配置のデフォルトクリエイティブとして使用できます。その後、 Placement Service を使用して、クリエイティブをその ID を介してプレースメントに添付します。

注:

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

注:

2025 年 9 月より有効: 広告が政治的なものであり、[ is_political_and_eu_targeted ] フィールドと [ is_political_and_non_eu_targeted ] フィールドを通じて EU 内で配信されることを意図しているかどうかを宣言します。

監査

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

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

REST API

HTTP メソッド	エンドポイント	説明
`POST`	https://api.appnexus.com/creative-html?advertiser_id=ADVERTISER_ID (creative JSON)	ホストされている新しい HTML5 クリエイティブを広告主のいずれかに追加します。
`POST`	https://api.appnexus.com/creative-html?publisher_id=PUBLISHER_ID (creative JSON)	新しい HTML5 クリエイティブをパブリッシャーの 1 つに追加します。
`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。既定値: 自動生成された数値。 Required On:`PUT`, in query string.
`code`	string (100)	クリエイティブのカスタムコード。
`code2`	string (100)	クリエイティブの追加のカスタムコード。 `line_items`内の各オブジェクト。
`name`	string (100)	クリエイティブの名前。
`type`	列挙	クリエイティブのタイプ。使用可能な値: `"html"` 注: アルファベータ版に関する通知: このフィールドまたは機能は、現在アルファ版またはベータ版のどちらかにある機能の一部です。そのため、変更される可能性があります。読み取り専用。
`height`	int	クリエイティブの高さのサイズ。
`width`	int	クリエイティブの幅のサイズ。
`advertiser_id`	int	クリエイティブが添付されている広告主の ID。必須 On:`POST`/`PUT`、クリエイティブが広告主にアタッチされている場合は、クエリ文字列内。
`publisher_id`	int	クリエイティブが添付されているパブリッシャー/メディア購入の ID。必須 On:`POST`/`PUT`, in query string (クリエイティブがパブリッシャーにアタッチされている場合)。
`brand_id`	int	クリエイティブを宣伝する会社のブランドの ID。含まれている場合は、AppNexus の監査チームによって検証されます。含まれない場合は、監査チームによって割り当てられます。ブランドの完全なリストを取得するには、 Brand Service を参照してください。
`state`	列挙	クリエイティブの状態。使用可能な値: `"active"` または `"inactive"`。読み取り専用。
`status`	object	クリエイティブを配信する準備ができているかどうかを説明するクリエイティブのステータス。詳細については、以下の「状態」を参照してください。
`click_track_result`	列挙	本体のユーザーインターフェイスでのみ使用できる機能であるクリックトラックテストの結果。指定可能な値: `"not_tested"`、 `"passed"`、または `"failed"`。既定値:`"not_tested"`
`campaigns`	オブジェクトの配列	クリエイティブが関連付けられているキャンペーンのリスト。詳細については、以下のキャンペーンを参照してください。注: このフィールドは、クエリ文字列に `advertiser_id` が指定されている場合にのみ返されます。
`template`	object	クリエイティブのフォーマットとメディアの種類に応じたクリエイティブテンプレート (例: `template_id` 6439)。テンプレートには、Web ページでクリエイティブのレンダリング方法を制御するコードが含まれています。使用可能な値: - HTML マルチアセット - Standard: 8606 - HTML マルチアセット - インタースティシャル: 8607 - HTML マルチアセット - 展開可能: 8608 必須:`POST` 詳細については、以下の例を参照してください。
`media_url`	string (1000)	クリエイティブの URL - Flash、HTML、javascript (形式を参照) にすることができます。必須 On:`POST`、コンテンツを使用しない場合。このフィールドは、サードパーティのクリエイティブにのみ適用されます。 HTML5 クリエイティブの場合は空白のままにします。
`media_url_secure`	string (1000)	セキュリティで保護された (HTTPS) クリエイティブの URL - Flash、HTML、JavaScript (形式を参照) で指定し、安全な広告呼び出しで提供します。このフィールドは、サードパーティのクリエイティブにのみ適用されます。 HTML5 クリエイティブの場合は空白のままにします。
`click_url`	string (2000)	サードパーティ以外の画像およびフラッシュクリエイティブ用の (省略可能) ランディングページ URL。注: この値は、"http://" または "https://" で始まる必要があります必須 On:`POST`、テンプレートが `"image"` 形式用の場合。
`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`	ブール型	シャーロックがクリエイティブにマルウェアが含まれている、またはブロックされたドメインを読み込んでいるというフラグを付けた場合、これは 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`応答に広告サーバーを含めるには、クエリ文字列に `attributes=1` を渡します。広告サーバーの完全なリストを取得するには、広告サーバーサービスと次の例を参照してください。読み取り専用。
`technical_attributes`	オブジェクトの配列	クリエイティブの技術的特性を表す属性 ( `"Expandable"` や `"Video"`など)。注: `GET`応答に技術属性を含めるには、クエリ文字列に `attributes=1` を渡します。技術属性の完全なリストを取得するには、技術属性サービスと次の例を参照してください。
`language`	object	クリエイティブの言語。言語の完全なリストを取得するには、言語サービスと次の例を参照してください。
`brand`	object	クリエイティブを宣伝する会社のブランドと、ブランドに関連付けられているカテゴリ。詳細については、以下のブランドを参照してください。読み取り専用。
`sla`	int	"0" に設定されたクリエイティブは、標準の SLA で監査のために送信されます。注意: 0 以外の数値で送信されたクリエイティブは、優先監査 (有効な場合) と結果として料金が発生します。 AppNexus と優先監査に関する補足サービス契約を結んでいる場合は、このフィールドを 2 に設定することで、優先監査 (営業時間内の 2 時間以内の監査) のクリエイティブを提出できます。優先度監査の詳細については、「クリエイティブ基準と監査」を参照してください。
`sla_eta`	timestamp	優先監査の推定完了時間。読み取り専用。
`currency`	string	広告主の主要通貨 ( 米国ドルなど) を定義するコード。利用可能な通貨の種類の詳細については、「通貨サービス」を参照してください。既定値: メンバーの既定の通貨。読み取り専用。
`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 にする必要があります。
`is_political_and_eu_targeted`	ブール型	クリエイティブに政治的コンテンツが含まれており、EU 内で掲載する場合は true に設定します。フィールドが送信されない場合、想定される既定値は false です。注: 政治的広告は EU ではサポートされていません。
`is_political_and_non_eu_targeted`	ブール型	クリエイティブに政治的なコンテンツが含まれており、EU 内で掲載する予定がない場合は、true に設定します。フィールドが送信されない場合、想定される既定値は false です。注: 政治広告は EU 以外の国で、Microsoft Monetize Adserver クライアントでのみサポートされています。

`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`	ブール値/null 値	AppNexus の内部システムによってアップロードされたクリエイティブの状態。使用可能な値: ホスト型クリエイティブの場合は `"true"` または `"false"` 、サードパーティクリエイティブの場合は `"null"` 。読み取り専用。

競争力のあるブランド

注:

ブランドについて詳しくは、ブランドサービスを参照してください。

名前	型	説明
`id`	int	ブランドの ID。既定値: 該当なし必須: 該当なし
`name`	string	ブランドの名前。既定値: 該当なし必須: 該当なし

競合カテゴリ

注:

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

名前	型	説明
`id`	int	カテゴリの ID。既定値: 該当なし必須: 該当なし
`name`	string	カテゴリの名前。既定値: 該当なし必須: 該当なし

セグメント

これらのフィールドは、セグメント配列に含まれます。

フィールド	種類	説明
`id`	int	セグメントの ID。必須:`POST`、 `PUT`
`segment_id`	int	セグメントの ID。このフィールドには、[ `id` ] フィールドと同じ情報が含まれます。
`action`	列挙	セグメントに追加するためにユーザーが実行するアクション。使用可能な値: `"add on view"` または `"add on click"`。必須:`POST`、 `PUT`
`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=true と min_first_run=2012-01-01 00:00:00 の両方を渡す場合、2012-01-01 以降に最初に配信された OR ラインアイテムを送信したことがないクリエイティブを検索することになります。

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

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"
        },
        ...
    }
    }

Last updated on 2026-08-18