入札者 - クリエイティブ サービス

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

  • クリエイティブは、media_url (サードパーティの広告サーバー URL またはフラッシュ/GIF ファイル用のコンテンツ配信ネットワーク URL) によって識別されます。
  • 定期的にチェック media_urlsいたします。 ファイルが消えた場合、そのクリエイティブは未監査として扱われます。
  • 監査ステータスが変更されたクリエイティブごとに、audit_notify_uri ハンドラーに監査通知要求が送信されます。
  • マルウェアや欺瞞的なクリエイティブをアップロードしたり、クリエイティブに意図的に誤ったラベルを付けたりすることは、絶対に禁止されています。
  • 次の場合にメールを受信するようにメンバーを構成する ( メンバー サービスを参照) ことを強くお勧めします。

注:

期限切れのクリエイティブ ポリシー

クリエイティブ (1) が実行されておらず、(2) が連続 15 日間変更されていない場合、そのクリエイティブは自動的に期限切れ ("is_expired": true) としてマークされ、どのインベントリにも配信されません。 入札者がクリエイティブを使用して入札を再開すると、クリエイティブは自動的に再度アクティブ化されます。

アクセス許可

  • 管理者のみが audit_status フィールドを変更できます。
  • 監査後に変更されたクリエイティブは、 pending 監査ステータスに戻ります。

注:

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

REST API

HTTP メソッド 終点 説明
DELETE https://api.adnxs.com/creative/MEMBER_ID?id=CREATIVE_ID クリエイティブを削除します。
GET https://api.adnxs.com/creative/MEMBER_ID
https://api.adnxs.com/creative/MEMBER_ID?num_elements=X&start_element=Y&min_last_activity=Z&sort=id.asc		 メンバーのすべてのクリエイティブを表示します。
注: メンバーに 100 個を超えるクリエイティブがある場合は、以下で説明する num_elements パラメーターと start_element パラメーターを使用してください。

メンバーのクリエイティブの特定の数と範囲を表示する。 X は返される要素の数です。 これは 100 以下にする必要があります。 Y は、返される X 要素の最初の要素です。 最初の要素は 0 です。 num_elementsを使用する場合は、start_elementも指定する必要があります。 一意のページ分割された結果を取得するには、以下に示すようにパラメーター &sort=id.asc を使用します。 フィルターとして min_last_activity=Z を指定することもできます。 Z は YYYY-MM-DD という形式にする必要があります。
GET https://api.adnxs.com/creative/MEMBER_ID/CREATIVE_ID https://api.adnxs.com/creative?member_id=MEMBER_ID&id=CREATIVE_ID1,CREATIVE_ID2,CREATIVE_ID3https://api.adnxs.com/creative?member_id=MEMBER_ID&code=CODE 特定のクリエイティブを表示します。
POST https://api.adnxs.com/creative/MEMBER_ID (creative JSON) 新しいクリエイティブを追加します。
PUT https://api.adnxs.com/creative-macro-check?include_tests=1 (replace_pattern_in_content_url JSON) 既存のクリエイティブを変更します。
PUT https://api.adnxs.com/creative/MEMBER_ID/CREATIVE_ID (creative JSON) https://api.adnxs.com/creative/MEMBER_ID?code=CODE

JSON 構造

フィールド 設定条件 必須 型 説明
active internal いいえ ブール型 読み取り専用です。 クリエイティブの現在の状態。
added_by_bidder internal いいえ int このクリエイティブを追加した入札者の ID。
adservers internal いいえ オブジェクトの配列 読み取り専用です。 クリエイティブを配信する広告サーバー、またはクリエイティブの配信中にデータ収集目的で呼び出される広告サーバー。
adx_audit internal いいえ object 読み取り専用。 このオブジェクトには、クリエイティブの Google Ad Exchange の監査に関連するステータスとフィードバックに関する情報が含まれます。 クリエイティブが承認されたかどうかに関する情報が [ audit_status ] フィールドに返されます。
allow_audit クライアント いいえ ブール型 クリエイティブを監査プロセスに参加させる場合は、true に設定します。
allow_ssl_audit クライアント いいえ ブール型 true の場合、クリエイティブはセキュア (https) 監査の対象に送信されます。 false の場合、クリエイティブは送信されません。 true の場合、media_url_secure または content_secure も必要です。
既定値: false
audit_feedback internal いいえ string クリエイティブが Xandr のクリエイティブ監査に不合格となった場合、これには監査チームの理由が含まれます。
audit_status チームとクライアントの監査 いいえ enum ('no_audit','pending','rejected','unauditable', 'audited') 監査の状態。 このフィールドは、Xandr クリエイティブ監査チームによって設定されます。 audit_statusが "監査済み" になっていないクリエイティブは、クリエイティブのaudit_statusを "保留中" に設定することで、監査のために再送信できます。
backup_upload_status 非推奨です。
brand クライアント いいえ object クリエイティブを宣伝する会社のブランド ID、名前、category_idが含まれます。 監査されます。
ヒント: category_name も返すには、呼び出しのクエリ文字列に show_category_name=true を渡します。
brand_id クライアント いいえ int クリエイティブを宣伝する会社のブランドの ID。
campaign クライアント いいえ string(50) このクリエイティブのキャンペーンの (省略可能) の名前 - レポート/管理目的で使用します。
categories 監査チーム (クライアントが設定した政治的認証を除く) いいえ List[Object] クリエイティブに関連付けられているカテゴリの ID と名前 - カテゴリ サービスを参照してください。 GET の場合、これらは要求 URL でフラグ attributes=true を使用した場合にのみ返されます。
click_action いいえ いいえ string クリエイティブがクリックされたときにデバイスが実行するアクション。 現時点では、このフィールドはサポートされている唯一のクリック アクションである "click to-web" に設定されます
既定値: click-to-web
click_target いいえ いいえ string click_actionのターゲット。 Web クリックの場合、これはクリエイティブの click_url です。 click_url 最終的には非推奨となり、このフィールドが優先されます。
click_trackers 非推奨です。
click_url クライアント はい (creative.format が画像の場合) string(1000) 入札者クライアントに対しては機能しません。
code クライアント いいえ string (100) クリエイティブのメンバー コード。外部 ID マッピングの目的でのみ使用されます ( 「入札者からの受信入札応答」を参照)。
content クライアント いいえ (media_urlが存在する場合) テキスト media_urlの代わりに使用されたクリエイティブの生の JavaScript または html コンテンツ。
content_secure クライアント いいえ (media_url_secureが存在する場合) テキスト セキュア広告呼び出しで配信される "format" が "raw-js" または "iframe-html" の場合の JavaScript または HTML コンテンツ。
created_on internal いいえ timestamp クリエイティブが最初に Xandr にアップロードされたときのタイムスタンプ
creative_upload_status 非推奨です。
description いいえ string (400) クリエイティブに関連付けられている説明文 (任意)。
filter 非推奨です。
flash_backup_url いいえ string Flash 形式クリエイティブのバックアップ。ユーザーのブラウザーで Flash がサポートされていない場合に提供されます。
flash_click_variable クライアント いいえ string フラッシュ クリエイティブ専用。 フラッシュ以外のクリエイティブに対してこのフィールドを POST または PUT しようとすると、有効になりません。 これは、Xandr がユーザーがクリエイティブをクリックしたときのたどるクリック トラッキング URL (クリック トラッキングが有効な場合) を挿入する Flash clickTAG 変数の名前です。 clickTAG 変数を使用するように Flash ファイルを設定する方法については、 Adobe のデザイナー ガイド を参照してください。
format 非推奨です。
height クライアント ○ int クリエイティブの高さ (ピクセル単位)。
id internal はい (更新時) int クリエイティブの ID。内部照合の目的でのみ使用されます。
impression_trackers 非推奨です。
is_expired internal いいえ ブール値 過去 15 日間にクリエイティブが配信または変更されたかどうかを示します。
is_prohibited internal いいえ ブール値 Xandr 内部監査システムがクリエイティブの分析中に悪意のある動作を検出した場合は true。 True の場合、このクリエイティブは配信されません。
is_suspicious internal いいえ ブール値 Xandr 内部監査システムがクリエイティブの分析中に疑わしい動作を検出した場合は true。 True の場合、このクリエイティブは配信されません。
is_political_and_eu_targeted クライアント 不要 ブール型 クリエイティブに政治的コンテンツが含まれており、EU 内で掲載する場合は true に設定します。 フィールドが送信されない場合、想定される既定値は false です。
注: 政治的広告は EU ではサポートされていません。
is_political_and_non_eu_targeted クライアント 不要 ブール型 クリエイティブに政治的なコンテンツが含まれており、EU 内で掲載する予定がない場合は、true に設定します。 フィールドが送信されない場合、想定される既定値は false です。
注: 政治広告は EU 以外の国で、Microsoft Monetize Adserver クライアントでのみサポートされています。
language_id 監査チーム いいえ int クリエイティブの言語の ID - 言語サービスを参照
last_activity internal いいえ timestamp クリエイティブが最後に変更された日時。 タイムゾーンは UTC です。 読み取り専用。
last_checked internal いいえ timestamp URL の存在が最後に確認されたタイムスタンプ。
media_subtypes 非推奨です。
media_url クライアント いいえ (コンテンツが存在する場合) string(1000) クリエイティブの URL - image、flash、html、javascript のいずれか。 URL は存在する必要があり、CDN またはそれに相当するものである必要があります。
media_url_secure クライアント いいえ (content_secureが存在する場合) string(1000) セキュアな (https) クリエイティブの URL - 画像、フラッシュ、HTML、javascript で、セキュアな広告呼び出しで提供されます。 URL は存在する必要があり、CDN またはそれに相当するものである必要があります。
member_id クライアント いいえ int このクリエイティブが属するメンバーの ID。 これは API 呼び出しの URI で指定され、JSON に含める必要はありません。
mobile クライアント いいえ object モバイル クリエイティブがクリエイティブの監査に合格するために必要な情報。 以下の モバイル を参照してください。
native 非推奨です。
native_attribute クライアント はい (テンプレート 39461 のネイティブ広告に必要) object これは、ネイティブ広告に必要な要素を含むネイティブ オブジェクトです。 詳細については、以下の ネイティブ属性 オブジェクトの説明を参照してください。
no_iframes 非推奨です。
no_iframes 非推奨です。
not_found internal いいえ ブール値 URL の読み込みに失敗した回数。 一定回数のチェックが完了すると、クリエイティブは非アクティブになります。
original_content internal いいえ string このフィールドは参照用です。 サードパーティのコンテンツを含むタグが Xandr にアップロードされると、クリエイティブとともにアップロードされた元のコンテンツがこのフィールドに保存されます。
既定値:
必須: タイプ raw-html として送信するときに POST。
original_content_secure internal いいえ string original_contentを参照してください。 これは、このコンテンツの安全なバージョンです。
passed_sherlock_audit internal いいえ ブール値 クリエイティブが最近、Xandr 自動クリエイティブ監査システム ("Sherlock") によってチェックされたかどうかを示します。
pixel_type 非推奨です。 代わりに、 pixels フィールドを使用してください。
pixel_url 非推奨です。 代わりに、 pixels フィールドを使用してください。
pixel_url_secure 非推奨です。 代わりに、 pixels フィールドを使用してください。
pixels クライアント いいえ オブジェクトの配列 クリエイティブで提供するピクセル。 外部インプレッション トラッキング、外部クリック トラッキング、またはクリエイティブへの AdChoices アイコンの追加などの他の目的に使用できます。 詳細については、以下の ピクセル を参照してください。
placement クライアント いいえ string(50) このクリエイティブの配置の (省略可能) 名前 - レポート/管理目的で使用されます。
pop_values 非推奨です。
segments クライアント いいえ 配列 ユーザーがこのクリエイティブを表示またはクリックしたときに追加されるセグメントのリスト。 詳細については、以下の 「セグメント 」を参照してください。 例: "segments": [ { "id": 11111, "action": "add_on_view" }, { "id": 22222, "action": "add_on_click" } ]
size_in_bytes internal いいえ int メディア ファイルのサイズ (バイト単位)。
sla クライアント いいえ integer プラットフォーム監査を要求するときの目標期間。 値 0 が標準、2 が優先度/ラッシュです。 既定値は 0 です。
注: 標準監査を要求すると、API はこのフィールドに null の値を入力します。
ssl_status 監査チーム いいえ enum('disabled','pending','approved','failed') ssl_status = 承認のクリエイティブのみが、セキュリティで保護されたインベントリでサービスを提供できます。 注: クリエイティブが SSL Sherlock の監査に失敗した場合は、このフィールドを "保留中" に変更することで、(ダウンストリームのセキュリティで保護されていないコンテンツを修正した後に) 再テストのために送信できます。
既定値: 'disabled'
state internal いいえ 列挙 クリエイティブの状態。 指定可能な値は、"active" または "inactive" です
status クライアント いいえ object クリエイティブを配信する準備ができているかどうかを説明するクリエイティブのステータス。 詳細については、以下の 状態 を参照してください。
technical_attributes 監査チーム いいえ List of ints クリエイティブに関連付けられている技術属性の ID - 「技術属性サービス」を参照してください。 GET の場合、これらは要求 URL でフラグ attributes=true を使用した場合にのみ返されます。
template クライアント はい object クリエイティブのフォーマットとメディア タイプ (フラッシュや展開可能など) 用のクリエイティブ テンプレート (例: template_id 6 )。 テンプレートには、Web ページでクリエイティブのレンダリング方法を制御するコードが含まれています。 詳細については、以下の クリエイティブ テンプレート を参照してください。
警告: "raw-html" 形式 (iFrame で提供されない HTML) のテンプレートを使用する場合、 content フィールド内のすべてのもの (引用符、スラッシュなど) を escaped し、 document.write(); ステートメントで囲む必要があります。 これは、コンテンツをページに配信するために必要です 。既定値: POST
text_description クライアント はい、書式がテキストの場合のみ 最大 70 文字の文字列 テキスト クリエイティブに表示されるテキストの下行
text_display_url クライアント はい、書式がテキストの場合のみ 最大 35 文字の文字列 テキスト クリエイティブに表示される読み取り可能な URL
text_title クライアント はい、書式がテキストの場合のみ 25 文字までの文字列 テキスト クリエイティブに表示されるテキストの一番上の行
track_clicks 非推奨です。
track_clicks 非推奨です。
video_attribute クライアント いいえ object サードパーティ製インストリーム (VAST) ビデオ クリエイティブの属性。 詳細については、以下の Video 属性 を参照してください。
width クライアント ○ int クリエイティブの幅 (ピクセル単位)。

Mobile

フィールド 種類 説明
alternative_landing_page_url string 特定のデバイス、オペレーティング システム、または通信事業者をターゲットとしたランディング ページを持つクリエイティブのデスクトップ ブラウザーで表示できる代替ランディング ページ URL。
警告: クリエイティブが監査に合格するには、監査可能な URL を指定する必要があります。

オーディオ

フィールド 種類 説明
click_target string クリエイティブがクリックされたときにデバイスが実行するアクションである、click_actionのターゲット。 監査チームがオーディオ クリエイティブのブランドと属性を検証するために使用できる URL を入力します。 URL が指すサイトが、オーディオと同じ言語であることを確認してください。 この URL は、監査目的にのみ使用されます。
警告: クリエイティブが監査に合格するには、監査可能な URL を指定する必要があります。

ビデオ属性

video_attribute のテンプレート ID は 6439 - ビデオ: Standard VAST (VPAID も受け入れます) で、オブジェクトには次のフィールドが含まれています。

注:

オーディオ: video 属性オブジェクトは、オーディオ クリエイティブの作成にも使用されます。 オーディオのテンプレート ID は 38745 - Xandr Audio Template (VAST) です。 XML URL とオーディオ ファイル URL の両方を使用できます。

VAST チェック。 サードパーティの VAST または VPAID ビデオ クリエイティブを追加する場合、XML に対して一連のチェックが実行されます。 表示される可能性のあるさまざまな出力と、実行できる是正措置があります。 詳しくは、 VAST Check をご覧ください。

フィールド 種類 説明
duration_ms double インストリーム (VAST) ビデオ クリエイティブの期間 (ミリ秒単位)。 これは 0 より大きい必要があります。
is_skippable ブール値 true場合、インストリーム (VAST) ビデオ クリエイティブはスキップできます。 スキップ可能なサードパーティ製の VAST ビデオ クリエイティブのみがサポートされています。したがって、is_skippableがtrueされている場合は、is_hostedfalseする必要があります。
wrapper object elements 配列と trackers 配列を含む VAST ドキュメント ラッパー。

ビデオ属性ラッパー

wrapper オブジェクトには以下のフィールドがあります。

フィールド 種類 説明
elements 配列 VAST ラッパーの要素。
secure_url string VAST ドキュメントのセキュア URL。
url string VAST ドキュメントの URL。

ビデオ属性ラッパー要素

elements 配列には以下のフィールドが含まれています。

少なくとも 1 つの要素を指定する必要があります。

フィールド 種類 説明
trackers 配列 VAST イベント トラッカー。
type string 読み取り専用です。 要素の種類。 指定可能な値: "linear"
vast_element_type_id int VAST 要素 ID。 設定可能な値: 1: linear

動画属性イベント トラッカー

レポートで追跡するすべてのイベントにピクセルをドロップできます (下記vast_event_type_id参照)。 クリエイティブの trackers としてピクセルを追加します。 trackers 配列には以下のフィールドが含まれています。

フィールド 種類 説明
event_type string 読み取り専用です。 vast_event_type_idに対応するイベントの種類。
is_segment_pixel ブール値 ピクセルをセグメント ピクセルとして定義し、デバイスの種類に関係なく、そのイベントのユーザー ID がセグメントに追加されるようにします。 既定値 = false。 これが true に設定されている場合、URL は標準形式 ( https://ib.adnxs.com/seg?add=segmentID) で構成されている必要があります。そうしないと、エラーが返されます。
name string イベント トラッカーの名前。
secure_url string イベント トラッカーのセキュリティで保護された URL。
url string イベント トラッカーの URL。
vast_event_type_id int VAST イベントの ID。 使用可能な値:
- 1:サービス
- 2:開始
- 3:スキップ
- 4:エラー
- 5:first_quartile
- 6:中点
- 7 : third_quartile
- 8:完了
- 9:インプレッション
- 10: クリック

クリエイティブ テンプレート

クリエイティブ テンプレート サービスを使用すると、クリエイティブに割り当てることができるすべてのレンダリング テンプレートを表示できます。

フィールド 種類 説明
id int クリエイティブ テンプレートの ID。

最も一般的なクリエイティブ形式の標準テンプレート ID を次に示します。

ID フォーマット 名前
1 url-html Standard バナー
2 url-js Standard バナー
3 点滅 Standard バナー
4 image Standard バナー
5 raw-js Standard バナー
6 raw-html Standard バナー
7 iframe-html Standard バナー
8 url-xml ビデオ In-Banner
9 url-html ポップアップ
10 url-js ポップアップ
11 点滅 ポップアップ
12 image ポップアップ
13 raw-js ポップアップ
14 raw-html ポップアップ
15 iframe-html ポップアップ
6439 VAST、VPAID Standard VAST

展開可能なクリエイティブについては、展開 可能なクリエイティブとリッチ メディア のページを参照してください。

状態

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

ネイティブ属性

native_attribute オブジェクトには以下のフィールドがあります。 詳しくは、例の ネイティブクリエイティブの追加 を参照してください。

フィールド 種類 説明
data_assets オブジェクトの配列 ネイティブ クリエイティブの属性。 詳細については、以下の 「データ資産」 を参照してください。
image_assets オブジェクトの配列 個々の画像の属性。 詳しくは 、イメージアセット を参照してください。
image_trackers オブジェクトの配列 ネイティブ クリエイティブで使用することを目的とした第三者のインプレッション トラッキング URL のリスト。 詳細については、以下の 「画像トラッカー 」を参照してください。
javascript_trackers オブジェクトの配列 第三者インプレッション トラッキング URL のリスト。 詳細については、以下の「 JavaScript トラッカー 」を参照してください。 ${AUCTION_PRICE} と ${PRICE_PAID} を除くすべての OpenRTB マクロと Xandr マクロがこのフィールドでサポートされています。
link object ネイティブ クリエイティブに関連付けられている URL。 詳細については、以下の リンク を参照してください。
privacy_url string 要求にサポートが示されている場合、購入者のターゲティング アクティビティについてユーザーに通知するページの URL。 Xandr では、既定のプライバシー リンクは提供されません。
video_assets オブジェクトの配列 ビデオ アセットの属性。 詳細については、ビデオ アセットを参照してください。

注:

インプレッション トラッカーには image_trackers を使用し、クリック トラッカーには link.trackers を使用してください。

link オブジェクトには、ネイティブ クリエイティブに関連付けられているランディング ページ URL、フォールバック URL、トラッカーが含まれています。 link オブジェクトはネイティブ属性に必要です。

link オブジェクトには以下のフィールドがあります。

フィールド 種類 説明
fallback_url string メインのディープリンク URL がサポートされていない場合は、バックアップ URL。
trackers オブジェクトの配列 ネイティブ クリエイティブで使用することを目的とした第三者のトラッキング URL のリスト。 これはクリック トラッカーの配列である必要があります。 詳細については、以下の トラッカー を参照してください。
url string ネイティブ クリエイティブのランディング ページ。
必須 : POST,PUT

注:

すべてのネイティブ クリエイティブは、既定で安全な監査のために送信されます。

  • どのトラッカー (画像トラッカー、javascript トラッカー、クリエイティブ画像アセット トラッカー) に対してセキュリティで保護された URL も指定されていない場合、そのクリエイティブのセキュリティで保護された監査は無効になります。

  • セキュリティで保護された URL が指定されておらず、URL のプレフィックスが 'https' の場合、クリエイティブはセキュリティで保護された監査のために送信されます。

トラッカー

名前 型 説明
url string 第三者のインプレッション トラッキング URL。 このオブジェクトにはインプレッション トラッカーが含まれている必要があります。
url_secure string 第三者のインプレッション トラッキング URL (SSL を使用する)。 このオブジェクトにはインプレッション トラッカーが含まれている必要があります。

画像トラッカー

名前 型 説明
url string 第三者のインプレッション トラッキング URL。 このオブジェクトにはインプレッション トラッカーが含まれている必要があります。
url_secure string 第三者のインプレッション トラッキング URL (SSL を使用する)。 このオブジェクトにはインプレッション トラッカーが含まれている必要があります。

Javascript トラッカー

名前 型 説明
url string 第三者の JavaScript トラッキング URL。
url_secure string 第三者の JavaScript トラッキング URL (SSL を使用する)

データ資産

data_assets オブジェクトには以下のフィールドがあります。

フィールド 種類 説明
data_type string ネイティブ クリエイティブのアセットの種類。 使用可能な値:
- sponsored_by
- タイトル
- 説明
- 評価
- call_to_action
- display_url
- いいね
- ダウンロード
- 価格
- sale_price
- 電話
- 住所
- additional_description
value string 指定した data_type asset の説明。
- "sponsored_by" - スポンサーのブランド名
- "title" - クリエイティブのタイトル
- 「description」 - 宣伝されている製品またはサービスの説明
- "rating" - 提供されている製品の評価
- "call_to_action" - 次のステップの推奨アクション
- 「display_url」 - 表示するURL
- 「いいね!」 - ソーシャルメディアのいいね!
- "downloads" - この製品のダウンロード/インストール数
- "price" - 製品/アプリ/アプリ内購入の価格
- 「sale_price」 - 価格と組み合わせて使用して割引価格を示すことができるセール価格
- "phone" - 電話番号 "address" - 住所
- 「additional_description」 - 広告説明文の長いバージョン

画像アセット

image_assets オブジェクトには以下のフィールドがあります。

フィールド 種類 説明
creative_asset_image object クリエイティブ アセットの詳細を含むオブジェクト。 サードパーティのネイティブ クリエイティブに必須です。 詳しくは、以下の クリエイティブ アセット画像 をご覧ください。
image_type string 画像の形式。 次の値を指定できます。
- icon_image
- main_image

クリエイティブ アセット画像

フィールド 種類 説明
height int イメージの高さ。 値は 0 > にする必要があります
url string 画像の URL。
url_secure string 画像のセキュリティで保護された URL。
width int イメージの幅。 値は 0 > にする必要があります

ビデオアセット

video_assets オブジェクトには以下のフィールドが含まれます。

フィールド 種類 説明
video_creative_id int ネイティブ クリエイティブに関連付けられたビデオ アセットの Xandr クリエイティブ ID。 注: ネイティブ ビデオ クリエイティブを登録する前に、まず別のビデオ クリエイティブを登録する必要があります。

Pixels

この配列を使用して、最大 5 つの Xandr 承認済みカスタム ピクセルをクリエイティブに追加します。

Xandr が承認したピクセル は、信頼された一般的に使用されるプロバイダーからのものです。 ほとんどの場合、クリエイティブが監査のために再送信されることはありません。 Xandr 承認済みピクセルをクリエイティブに追加するには、ピクセルに必要なpixel_template_idとパラメーターの数だけを渡す必要があります。 詳細なガイダンスについては、以下の「Xandr 承認済みピクセルをクリエイティブに追加する」の例を参照してください。 ピクセル テンプレート サービスを使用すると、再監査をトリガーするかどうかなど、これらのピクセルに関する情報を取得できます。

カスタム ピクセルはユーザーによって定義されるため、クリエイティブが監査のために再送信されます。 カスタム ピクセルを追加するには、書式だけを渡す必要があり、書式に応じてコンテンツまたは URL も渡す必要があります。 詳細なガイダンスについては、以下の 「クリエイティブへのカスタム ピクセルの追加 」の例を参照してください。

フィールド 種類 説明
content string (255) ピクセル形式が "raw-js" の場合、クリエイティブと共に配信する HTML または JavaScript コンテンツ。
format 列挙 ピクセルのフォーマット。 指定可能な値: "raw-js"、"url-html"、"url-js"、または "url-image"。
id int 読み取り専用です。 ピクセルの ID。
param_1 string Xandr が承認したピクセルの場合: ピクセル コンテンツまたは URL の最初のパラメーターの値。 Xandr が承認したピクセルに必要なパラメーターの数を調べるには、[Pixel Template Service](pixel-template-service .md) を使用します。
param_2 string Xandr 承認ピクセルの場合: ピクセル コンテンツまたは URL の 2 番目のパラメーターの値。
param_3 string Xandr が承認したピクセルの場合: ピクセル コンテンツまたは URL の 3 番目のパラメーターの値。
param_4 string Xandr 承認ピクセルの場合: ピクセル コンテンツまたは URL の 4 番目のパラメーターの値。
param_5 string Xandr が承認したピクセルの場合: ピクセル コンテンツまたは URL の 5 番目のパラメーターの値。
pixel_template_id int Xandr が承認したピクセルの ID。 ピクセル テンプレート サービスを使用すると、この ID を取得できます。
url string (255) ピクセル形式が "url-html"、"url-js"、"url-image"、"raw-url" の場合、クリエイティブと共に配信する HTML、JavaScript、または画像ピクセルの URL。

セグメント

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

フィールド 種類 説明
action 列挙 セグメントに追加するためにユーザーが実行するアクション。 使用可能な値: 'add on view' または 'add on click'。
必須: POST、PUT
id int セグメントの ID。
必須: POST、PUT
name string セグメントの名前。
segment_id int セグメントの ID。 このフィールドには、id フィールドと同じ情報が含まれます。
フィールド 種類 説明
landing_page_url string 監査プロセス中に Xandr 管理者が入力したランディング ページの URL。
既定値: null
thirdparty_campaign_id int 読み取り専用です。 キャンペーンがサードパーティと同期されている場合、これはサードパーティ システムの ID になります。
既定値: null
thirdparty_creative_id int 読み取り専用です。 クリエイティブが Yahoo Ad Exchange などのサードパーティと同期されている場合、これはサードパーティ システムの ID になります。同期で問題が発生した場合は、次の PUT 呼び出しを使用して thirdparty_creative_id を null にリセットできます。 $ curl -b cookies -c cookies -X PUT -d '{"creative":{}}' 'https://api.adnxs.com/creative/MEMBER_ID/CREATIVE_ID&reset_thirdparty_creative_id'既定値: null

Re-Audit の原因となる変更

クリエイティブが Xandr の監査に合格した後 (audit_statusは「監査済み」)、次のいずれかのフィールドを変更すると、クリエイティブは監査のために再送信されます (allow_audit は「保留中」に設定されます)。

  • 幅
  • height
  • content
  • media_url
  • click_url
  • template
  • custom_macros
  • media_subtypes
  • language
  • categories
  • technical_attributes
  • brand_id
  • pixel_url
  • ピクセル (カスタム ピクセルまたは Xandr 承認ピクセルを追加または削除する場合)
  • text_title (テキストがクリエイティブの場合)
  • text_description (テキスト クリエイティブの場合)
  • text_display_url (テキスト クリエイティブの場合)
  • pop_window_maximize (ポップ クリエイティブの場合)
  • pop_is_tag_initiated (ポップ クリエイティブで、false から true に変更される場合)
  • video_attribute
  • media_assets

また、audit_statusが "no_audit" の場合は、allow_auditを "false" から "true" に変更すると、クリエイティブは Xandr の監査のために再提出されます。

例

クリエイティブの追加

$ cat creative
{
 "creative":
  {     "width" : 300,
        "height" : 250,
        "media_url" : "https://ad.doubleclick.net/adi/ABC.Advertising.com/DEF.40;sz=300x250;click0=",
        "template":{
           "id": 1
        },
       "is_political_and_eu_targeted": false,
       "is_political_and_non_eu_targeted": false
  }
}

$ curl -b cookies -c cookies -X POST -d @creative.json "https://api.adnxs.com/creative/5"
{
  "response": {
    "status": "OK",
    "count": 1,
    "id": 703355,
    "creative": {
      "id": 703355,
      "active": true,
      "member_id": 5,
      "description": null,
      "code": null,
      "code2": null,
      "media_url": "https:\/\/ad.doubleclick.net\/adi\/ABC.Advertising.com\/DEF.40;sz=300x250;click0=",
      "audit_status": "pending",
      "allow_audit": true,
      "size_in_bytes": 0,
      "last_checked": null,
      "not_found": 0,
      "added_by_bidder": null,
      "campaign": null,
      "placement": null,
      "format": null,
      "width": 300,
      "height": 250,
      "click_url": null,
      "landing_page_url": null,
      "flash_click_variable": null,
      "no_iframes": false,
      "content": null,
      "original_content": null,
      "track_clicks": true,
      "audit_feedback": null,
      "created_on": "2013-10-31 21:17:17",
      "flash_backup_url": null,
      "is_self_audited": false,
      "file_name": null,
      "is_prohibited": false,
      "last_activity": "2013-10-31 21:17:17",
      "passed_sherlock_audit": true,
      "is_expired": false,
      "creative_upload_status": null,
      "backup_upload_status": null,
      "filter": null,
      "is_suspicious": false,
      "suspicious_activity_timestamp": null,
      "media_subtypes": [
        "banner"
      ],
      "no_adservers": false,
      "is_blanking": false,
      "is_rotating": false,
      "text_title": null,
      "text_description": null,
      "text_display_url": null,
      "click_action": "click-to-web",
      "click_target": null,
      "ssl_status": "disabled",
      "allow_ssl_audit": false,
      "media_url_secure": null,
      "content_secure": null,
      "original_content_secure": null,
      "flash_backup_url_secure": null,
      "is_hosted": false,
      "content_source": "standard",
      "thirdparty_creative_id": null,
      "thirdparty_campaign_id": null,
      "custom_request_template": null,
      "categories": 
     [
        {
        "id": 37,
        "name": "Politics",
        "self declared": true,
        }
     ],
      "brand": {
       "id": 1,
       "name": "Unknown",
       "category_id": 8
      },
      "language": {
        "id": 1,
        "name": "English"
      },
      "template": {
        "id": 1
      },
      "segments": null,
      "pixels": null,
      "mobile": null,
      "brand_id": 1,
      "sla": "0",
      "sla_eta": "2013-11-01 11:18:17"
    }
  }
}

追加したクリエイティブを表示する

$ curl -b cookies -c cookies 'https://api.adnxs.com/creative/5/6'
{
   "response":{
        "status":"OK",
        "creative":{
                "id": 6,
                "active": true,
                "member_id": 5,
                "description": null,
                "code": null,
                "brand_id": 43,
                "media_url": "https:\/\/ad.doubleclick.net\/adi\/ABC.Advertising.com\/DEF.40;sz=300x250;click0=",
                "audit_status": "pending",
                "allow_audit": true,
                "size_in_bytes": 18467,
                "last_checked": null,
                "not_found": false,
                "added_by_bidder": 14,
                "campaign": null,
                "placement": null,
                "format": "url-html",
                "width": 300,
                "height": 250,
                "click_url": "",
                "flash_click_variable": null,
                "pixel_url": "",
                "no_iframes": false,
                "content": null,
                "original_content": null,
                "track_clicks": true,
                "pixel_type": "image",
                "audit_feedback": null,
                "created_on": "0000-00-00 00:00:00",
                "flash_backup_url": null,
                                "is_self_audited": false,
                "last_activity": "2008-08-26 05:41:04",
                                "passed_sherlock_audit": true,
                                "is_expired": false,
                                "creative_upload_status": null,
                                "backup_upload_status": null,
                        "filter": null,
                        "is_suspicious": false,
                        "suspicious_activity_timestamp": null,
                        "media_subtypes": [
                                "banner"
                        ],
                        "no_adservers": false,
                        "is_blanking": false,
                        "is_rotating": false,
                        "text_title": null,
                        "text_description": null,
                        "text_display_url": null,
                        "click_action": "click-to-web",
                        "click_target": null,
                        "ssl_status": "disabled",
                        "allow_ssl_audit": false,
                        "media_url_secure": null,
                        "content_secure": null,
                        "original_content_secure": null,
                        "flash_backup_url_secure": null,
                        "is_hosted": false,
                        "content_source": "standard",
                        "thirdparty_creative_id": null,
                        "thirdparty_campaign_id": null,
                        "custom_request_template": null,
                        "brand": {
                                "id": 5,
                                "name": "Adobe",
                                "category_id": 27
                        },
                        "language": {
                                "id": 16,
                                "name": "Norwegian"
                        },
                        "template": {
                                "id": 1
                                },
                        "segments": null,
                        "pixels": null,
                        "mobile": null,
                        "brand_id": 5,
                        "sla": null,
                        "sla_eta": null
                        }
  }
}

クリエイティブを変更する

レポート目的で、キャンペーン名 "Triple Play - October 2008" をクリエイティブに追加する場合:

$ cat creative_mod
{"creative" : {
        "campaign":"Triple Play - October 2008"
        }
}
$ curl -b cookies -c cookies -X PUT --data-binary @creative_mod 'https://api.adnxs.com/creative/5/6'
{
   "response":{
        "status":"OK",
        "id":6
}}

そして、変更を確認するには:

$ curl -b cookies -c cookies 'https://api.adnxs.com/creative/5/6'
{
    "response": {
        "creatives": [
            {
                "id": 6,
                "active": true,
                "member_id": 5,
                "description": null,
                "code": null,
                "brand_id": 43,
                "media_url": "https:\/\/ad.doubleclick.net\/adi\/ABC.Advertising.com\/DEF.40;sz=300x250;click0=",
                "audit_status": "pending",
                "allow_audit": true,
                "size_in_bytes": 18467,
                "last_checked": null,
                "not_found": 0,
                "added_by_bidder": 14,
                "campaign": "Triple Play - October 2008",
                "placement": null,
                "format": "url-html",
                "width": 300,
                "height": 250,
                "click_url": "",
                "flash_click_variable": null,
                "pixel_url": "",
                "no_iframes": false,
                "content": null,
                "original_content": null,
                "track_clicks": true,
                "pixel_type": "image",
                "audit_feedback": null,
                "created_on": "2008-08-26 05:41:04",
                "flash_backup_url": null,
                "last_activity": "2008-09-14 06:20:04"
            }
        ],
        "status": "OK"
    }
}

クリエイティブを監査のために送信する

クリエイティブの監査を要求する場合は、クリエイティブがアクティブであり、 allow_audit フィールドが「はい」に設定されている必要があります。

$ cat creative_mod
{"creative" : {
        "audit_status": "pending",
                "allow_audit" : true
        }
}
$ curl -b cookies -c cookies -X PUT --data-binary @creative_mod 'https://api.adnxs.com/creative/5/6'
{
   "response":{
        "status":"OK",
        "id":6
}}

クリエイティブの有効期限を解除し、監査のために再送信する

クリエイティブの有効期限が切れている場合は、これらの設定でクリエイティブを更新し、ステータスを "保留中" に設定し、クリエイティブを監査のために再送信できます。 2017 年 11 月以降、有効期限が 1 年以上経過したクリエイティブは完全に削除されることに注意してください。 詳細については、このページの上部にある "期限切れのクリエイティブ ポリシー" を参照してください。

$ cat unexpire_creative
{
    "creative": {
    "audit_status": "pending",
    "allow_audit": true,
    "status": {
        "user_ready": true
        }
    }
}

モバイル クリエイティブを監査のために送信する

この例では、新しい mobile オブジェクトを使用します。

$ cat mobile_creative
{
    "creative" : {
        "audit_status": "pending",
        "allow_audit" : true,
        "mobile" : {
                 "alternative_landing_page_url" : "https://..."
        }
    }
}
$ curl -b cookies -c cookies -X PUT --data-binary @creative_mod 'https://api.adnxs.com/creative/5/6'
{
   "response":{
        "status":"OK",
        "id":6
   }
}

クリエイティブを優先審査のために提出する

優先監査の申請を希望する場合。 "sla" を 2 に設定します (値 1 は現在使用されていません)。 契約に応じて優先監査手数料が請求されます。

$ cat creative_mod
{"creative" : {
        "audit_status": "pending",
        "sla": 2
        }
}
$ curl -b cookies -c cookies -X PUT --data-binary @creative_mod 'https://api.adnxs.com/creative/5/6'
{
   "response":{
        "status":"OK",
        "id":6
}}

クリエイティブの予測監査時間を表示する ('sla_eta')

$ curl -b cookies -c cookies 'https://api.adnxs.com/creative/5/6'
{
    "response": {
        "creatives": [
            {
                "id": 6,
                ...
                "audit_status": "pending",
                "sla": 0,
                "sla_eta": "2011-05-21 05:33:06"
            }
        ],
        "status": "OK"
    }
}

クリエイティブ (サードパーティの HTML タグ) の追加

$ cat creative
{
 "creative":
  { "width" : 300,
    "height" : 250,
    "media_url" : "https://ad.doubleclick.net/adi/ABC.Advertising.com/DEF.40;sz=300x250;click0=",
    "template":{
       "id": 1
    }
  }
}                       
$ curl -b cookies -c cookies -X POST -d @creative.json 'https://api.sand-08.adnxs.net/creative?member_id=1282'   
  
{
    "response":{
        "status":"OK",
        "count":1,
        "start_element":null,
        "num_elements":null,
        "id":816447,
        "creative":{
            "id":816447,
            "active":true,
            "member_id":1282,
            "description":null,
            "code":null,
            "code2":null,
            "media_url":"https:\/\/ad.dblclick.net\/adi\/ABC.Advertising.com\/DEF.40;sz=300x250;click0=",
            "audit_status":"pending",
            "allow_audit":true,
            "size_in_bytes":0,
            "last_checked":null,
            "not_found":0,
            "added_by_bidder":null,
            "campaign":null,
            "placement":null,
            "format":null,
            "width":300,
            "height":250,
            "click_url":null,
            "landing_page_url":null,
            "flash_click_variable":null,
            "no_iframes":false,
            "content":null,
            "original_content":null,
            "track_clicks":true,
            "audit_feedback":null,
            "created_on":"2014-01-24 16:02:31",
            "flash_backup_url":null,
            "is_self_audited":false,
            "file_name":null,
            "is_prohibited":false,
            "last_activity":"2014-01-24 16:02:31",
            "passed_sherlock_audit":true,
            "is_expired":false,
            "creative_upload_status":null,
            "backup_upload_status":null,
            "filter":null,
            "is_suspicious":false,
            "suspicious_activity_timestamp":null,
            "media_subtypes":[
                "banner"
            ],
            "no_adservers":false,
            "is_blanking":false,
            "is_rotating":false,
            "text_title":null,
            "text_description":null,
            "text_display_url":null,
            "click_action":"click-to-web",
            "click_target":null,
            "ssl_status":"disabled",
            "allow_ssl_audit":false,
            "media_url_secure":null,
            "content_secure":null,
            "original_content_secure":null,
            "flash_backup_url_secure":null,
            "is_hosted":false,
            "content_source":"standard",
            "thirdparty_creative_id":null,
            "thirdparty_campaign_id":null,
            "custom_request_template":null,
            "brand":{
                "id":1,
                "name":"Unknown",
                "category_id":8
            },
            "language":{
                "id":1,
                "name":"English"
            },
            "template":{
                "id":1
            },
            "segments":null,
            "pixels":null,
            "mobile":null,
            "brand_id":1,
            "sla":"0",
            "sla_eta":"2014-01-27 00:03:31"
        }

iframe-html クリエイティブの追加

クリエイティブ サービスでは、さまざまな種類のクリエイティブを作成できます。 たとえば、"iframe-html" というフォーマットでクリエイティブを作成するには、広告を提供するページの iframe に埋め込まれる生の HTML をアップロードします。

$ cat iframe-html-creative
{
   "creative" : {
        "content":"<script type=\"text/javascript\" language=\"javascript\">
                   var sample_var = 350;
                   </script>
                   <script type=\"text/javascript\" language=\"javascript\" src=\"https://sample_source.com/sample_id?ord=${CACHEBUSTER}\"</script>",
        "width":"300",
        "height":"250",
        "format":"iframe-html",
        "brand_id" : 43
        }
}
$ curl -b cookies -c cookies --data-binary @iframe-html-creative 'https://api.adnxs.com/creative/5'
{
   "response":{
        "status":"OK",
        "id":7
}}

Xandr 承認済みピクセルをクリエイティブに追加する

この例では、Xandr 承認の Evidon AdChoices アイコン ピクセルをクリエイティブに追加するプロセスについて説明します。

まず、ピクセルに定義する必要があるパラメーターのpixel_template_idと数を確認する必要があります。 この情報を取得するには、 ピクセル テンプレート サービス を使用します。

$ curl -b cookies -c cookies 'https://api.adnxs.com/pixel-template'
{
    "response": {
        "status": "OK",
        "count": 3,
        "start_element": 0,
        "num_elements": 100,
        "pixel-templates": [
            {
                "id": 1,
                "name": "Evidon AdChoices Icon",
                "format": "raw-js",
                "content": "(function() {document.write('<sc'+'ript type=\"text/javascript\"' + ((\"https:\"
                 == document.location.protocol) ? \"https://c.betrad.com\" : \"https://c.betrad.com\") +
                 '/surly.js?;ad_wxh=${CREATIVE_SIZE};coid=${P1};nid=${P2};${P3}\"></scr'+'ipt>');}());",
                "num_required_params": 2,
                "require_reaudit": false
            },
            {
                "id": 2,
                "name": "Brilig Impression Tracker",
                "format": "url-image",
                "num_required_params": 1,
                "require_reaudit": false,
                "url": "https://p.brilig.com/contact/bct?pid=${P1}&_ct=pixel&adid=${CP_ID}&action=1"
            },
            ...
        ],
        "dbg_info": {
            ...
        }
    }
}

Evidon AdChoices アイコン ピクセルは、応答の最初の部分です。 id が 1 であることに注目します。 また、num_required_paramsが 2 であることにも注意してください。 つまり、クリエイティブにピクセルを追加するときは、ピクセル コンテンツに {P1} と {P2} の値を指定する必要があります。

次に、クリエイティブにピクセルを追加するための JSON 形式のファイルを作成します。 このファイルでは、pixel_template_id を 2 に設定し、param_1 と param_2 をピクセル コンテンツの {P1} と {P2} の値に設定します。

注:

ピクセル配列は、このファイルの情報で完全に上書きされます。 そのため、クリエイティブに既にピクセルが含まれている場合は、ファイルでもピクセルを指定するようにしてください。

$ cat creative_update
{
    "creative": {
        "pixels": [
            {
                "pixel_template_id": 1,
                "param_1":"12",
                "param_2":"34"
            }
        ]
    }
}

最後に、PUT 呼び出しを実行してクリエイティブを更新します。 応答の pixels 配列は、ピクセルが追加されたことを示します。 2 つのパラメーターは定義されており、ピクセル コンテンツに入力されています。 Evidon AdChoices アイコンのピクセルによってクリエイティブの再監査が必要では ないため 、audit_statusは "保留中" には戻されていないことに注意してください。

$ curl -b cookies -c cookies -X PUT -d @creative_update 'https://api.adnxs.com/creative/3/503577'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": "503577",
        "start_element": 0,
        "num_elements": 100,
        "creative": {
            "name": null,
            "brand_id": 1,
            "media_url": "https://creative.com/300x250",
            "id": 503577,
            "code": null,
            "code2": null,
            "state": "active",
            "click_track_result": "not_tested",
            "member_id": 3,
            ...
            "audit_status": "audited",
            ...
            "pixels": [
                {
                    "id": 163,
                    "pixel_template_id": 1,
                    "param_1": "12",
                    "param_2": "34",
                    "param_3": null,
                    "param_4": null,
                    "param_5": null,
                    "format": "url-image",
                    "content": "(function() {document.write('<sc'+'ript type=\"text/javascript\"' +
                     ((\"https:\" == document.location.protocol) ? \"https://c.betrad.com\" :
                     \"https://c.betrad.com\") + '/surly.js?;ad_wxh=${CREATIVE_SIZE};coid=12;nid=34;
                     \"></scr'+'ipt>');}());"
                }
            ],
            ...
        },
        "dbg_info": {
            ...
        }
    }
}

クリエイティブへのカスタム ピクセルの追加

この例では、PUT 要求によってカスタム url-js ピクセルがクリエイティブ 503577に追加されています。 JSON 形式のファイルでは、形式は "url-js" に設定され、URL はクリエイティブで配信する JavaScript の場所に設定されます。 応答で、audit_status が "保留中" であることに注意してください。これは、クリエイティブにカスタム ピクセルを追加すると、そのクリエイティブが監査のために再送信されるためです。

注:

ピクセル配列は、このファイルの情報で完全に上書きされます。 そのため、クリエイティブに既にピクセルが含まれている場合は、ファイルでもピクセルを指定するようにしてください。

$ cat creative_update
{
    "creative": {
        "pixels": [
            {
                "format": "url-js",
                "url":"https://50.16.221.228/render_js?cb=${CACHEBUSTER}&uid=${USER_ID}&ref=${REFERER_URL}
                 &campaign_id=147"
            }
        ]
    }
}
$ curl -b cookies -c cookies -X PUT -d @creative_update 'https://api.adnxs.com/creative/3/503577'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": "503577",
        "start_element": 0,
        "num_elements": 100,
        "creative": {
            "name": null,
            "brand_id": 1,
            "media_url": "https://creative.com/300x250",
            "id": 503577,
            "code": null,
            "code2": null,
            "state": "active",
            "click_track_result": "not_tested",
            "member_id": 3,
            ...
            "audit_status": "pending",
            ...
            "pixels": [
                {
                    "id": 196,
                    "pixel_template_id": null,
                    "param_1": null,
                    "param_2": null,
                    "param_3": null,
                    "param_4": null,
                    "param_5": null,
                    "format": "url-js",
                    "url": "https://50.16.221.228/render_js?cb=${CACHEBUSTER}&uid=${USER_ID}
                     &ref=${REFERER_URL}&campaign_id=147"
                }
            ],
            ...
        },
        "dbg_info": {
            ...
        }
    }
}

ビデオ属性オブジェクトとラッパーを使用してビデオ クリエイティブを追加する

{
    "creative": {
        "id": 145,
        ...
        "template_id": 6439,
        "video_attribute": {
            "is_skippable": true,
            "duration_ms": 21000,
                        "wrapper": {
                "url": "http://www.doubleclick.net/...",
                "secure_url": "https://www.doubleclick.net/...",
                "elements": [
                    {
                                                "vast_element_type_id": 1,
                        "name": "linear",
                        "trackers": [
                            {
                                                                "name": "startTracker",
                                "vast_event_type_id": 2,
                                "url": "http://tracker.com/...",
                                "secure_url": "https://tracker.com/...",
                                                                "event_type": "start"
                            },
                                                        {
                                                                "name": "completionTracker",
                                "vast_event_type_id": 8,
                                "url": "http://tracker.com/...",
                                "secure_url": "https://tracker.com/...",
                                                                "event_type": "completion"
                            }
                        ]
                    }
                ]
            }
        }
    }
}

ネイティブ クリエイティブの追加

ネイティブ クリエイティブを追加する場合は、テンプレート ID 39461 を使用します。

cat native
{
        "creative": {
                "description": "native_test",
                "brand_id": 1,
                "media_url": "https://mediaurl.com",
                "code": "test",
                "code2": null,
                "member_id": 4,
                "state": "active",
                "template": {
                        "id": 39461
                },
                "native_attribute": {
                        "link": {
                                "url": "https://url.com",
                                "fallback_url": "https://fallback.com",
                                "trackers": [{
                                        "url": "http://url.com",
                                        "url_secure": "https://secureurl.com"
                                }]
                        },
                        "data_assets": [{
                                "data_type": "sponsored_by",
                                "value": "a value"
                        }, {
                                "data_type": "rating",
                                "value": "8"
                        }],
                        "image_assets": [{
                                "image_type": "icon_image",
                                "creative_asset_image": {
                                        "url": "http://url.com",
                                        "url_secure": "https://secureurl.com",
                                        "height": 1,
                                        "width": 1
                                }
                        }],
                        "image_trackers": [{
                                "url": "http://url.com",
                                "url_secure": "https://secureurl.com"
                        }],
                        "javascript_trackers": [{
                                "url": "http://url.com",
                                "url_secure": "https://secureurl.com"
                        }]
                },
                "thirdparty_viewability_providers": null,
                "status": {
                        "user_ready": true
                },
                "sla_eta": null
        }
}
$ curl -b cookies -c cookies -X POST -s @native 'https://api.adnxs.com/creative/4'
{
        "response": {
                "status": "OK",
                "count": 1,
                "id": 411,
                "start_element": 0,
                "num_elements": 100,
                "dbg_info": {
                        ...
                },
                "creative": {
                        "description": "native_test",
                        "brand_id": 1,
                        "media_url": "https://mediaurl.com",
                        "id": 411,
                        "code": "test",
                        "code2": null,
                        "member_id": 4,
                        "state": "active",
                        "click_track_result": "not_tested",
                        "format": "url-file",
                        "width": null,
                        "height": null,
                        "click_url": null,
                        "flash_click_variable": null,
                        "no_iframes": false,
                        "content": null,
                        "original_content": null,
                        "file_name": null,
                        "track_clicks": true,
                        "audit_status": "pending",
                        "macros": null,
                        "profile_id": null,
                        "audit_feedback": null,
                        "is_prohibited": false,
                        "is_suspicious": false,
                        "created_on": "2017-03-09 21:54:11",
                        "flash_backup_url": null,
                        "last_modified": "2017-03-09 21:54:11",
                        "is_control": false,
                        "allow_audit": true,
                        "is_expired": false,
                        "creative_upload_status": null,
                        "backup_upload_status": null,
                        "use_dynamic_click_url": false,
                        "media_subtypes": [
                                "popunder",
                                "popup",
                                "banner"
                        ],
                        "size_in_bytes": 0,
                        "is_self_audited": false,
                        "no_adservers": false,
                        "text_title": null,
                        "text_description": null,
                        "text_display_url": null,
                        "click_action": "click-to-web",
                        "click_target": null,
                        "ssl_status": "pending",
                        "allow_ssl_audit": true,
                        "media_url_secure": "https://MEDIAURL.appnexus.com",
                        "content_secure": "document.write(\\\"\\\")",
                        "original_content_secure": null,
                        "flash_backup_url_secure": null,
                        "is_hosted": false,
                        "content_source": "standard",
                        "lifetime_budget": null,
                        "lifetime_budget_imps": null,
                        "daily_budget": null,
                        "daily_budget_imps": null,
                        "enable_pacing": null,
                        "allow_safety_pacing": null,
                        "landing_page_url": null,
                        "thirdparty_creative_id": null,
                        "thirdparty_campaign_id": null,
                        "facebook_audit_status": null,
                        "facebook_audit_feedback": null,
                        "custom_request_template": null,
                        "language": {
                                "id": 1,
                                "name": "English"
                        },
                        "brand": {
                                "id": 1,
                                "name": "Unknown",
                                "category_id": null
                        },
                        "template": {
                                "id": 329,
                                "name": "native ad",
                                "media_subtype_id": 17,
                                "format_id": 11
                        },
                        "ios_ssl_audit": null,
                        "adx_audit": null,
                        "custom_macros": null,
                        "segments": null,
                        "folder": null,
                        "campaigns": null,
                        "line_items": null,
                        "competitive_brands": null,
                        "competitive_categories": null,
                        "pixels": null,
                        "mobile": null,
                        "video_attribute": null,
                        "media_assets": null,
                        "sla": null,
                        "thirdparty_pixels": null,
                        "native": null,
                        "native_attribute": {
                                "link": {
                                        "url": "https://url.com",
                                        "fallback_url": "https://fallback.com",
                                        "trackers": [{
                                                "url": "http://url.com",
                                                "url_secure": "https://secureurl.com"
                                        }]
                                },
                                "data_assets": [{
                                        "data_type": "sponsored_by",
                                        "value": "a value"
                                }, {
                                        "data_type": "rating",
                                        "value": "8"
                                }],
                                "image_assets": [{
                                        "image_type": "icon_image",
                                        "creative_asset_image": {
                                                "url": "https://vcdn.adnxs.com/sand/creative-image/ea/f5/30/28/eaf53028-e6c6-4ac0-bcbb-ce8fe14b73ab.png",
                                                "url_secure": "https://secureurl.com",
                                                "height": 12,
                                                "width": 34
                                        }
                                }],
                                "image_trackers": [{
                                        "url": "http://url.com",
                                        "url_secure": "https://secureurl.com"
                                }],
                                "javascript_trackers": [{
                                        "url": "http://url.com",
                                        "url_secure": "https://secureurl.com"
                                }]
                        },
                        "thirdparty_viewability_providers": null,
                        "status": {
                                "user_ready": true,
                        },
                        "sla_eta": null,
                        "currency": "USD",
                        "type": "standard"
                }
        }
}

クリエイティブに割り当てられるテクニカル アトリビュートの決定

技術属性は、現時点では自動レポートに追加できるものではありませんが、ビッダー API のクリエイティブ サービスを通じて取得することができます。 詳細については、技術属性サービスを参照してください

これにアクセスするには、クエリ文字列パラメーター "?attributes=true" を "adnxs.com/creative/MEMBER_ID/CREATIVE_ID?attributes=true" として追加します

"technical_attributes": [
{
 "id": 2,
 "name": "Flash"
},
{
 "id": 9,
"name": "Initial Load > 40kb"
},
 {
  "id": 13,
  "name": "Banner has AdChoices Icon"
 },
 {
  "id": 15,
  "name": "Animated: 15 seconds or less"
 }
 ]

Meta Service は、API 内のオブジェクトとのインターフェイスに関する最新の情報を提供します。

クリエイティブ マクロ

インプレッション バスは、リアルタイムで置換される 2 種類のクリエイティブ マクロをサポートします。定義済みの Xandrcreative マクロ と、入札者が定義できる カスタム マクロ です。 両者の主な違いは視点です。 例えば、リアルタイム入札が行われた場合、インプレッション バスはキャンペーンや広告掲載オーダーを認識しないため、入札者の内部オブジェクト モデルでサポートされ、マクロで必要なオブジェクトは、カスタム マクロを使用してサポートする必要があります。

警告

マクロの制限

  • クリエイティブを登録する際は、事前に定義された Xandr マクロとカスタム マクロのみがサポートされています。

  • クリエイティブを登録するときは、OpenRTB マクロを使用しないでください。 OpenRTB マクロは、 入札応答でのみ使用します。

  • カスタム マクロに、OpenRTB マクロの名前と一致する名前を付けないでください。

Xandr クリエイティブ マクロ

使用可能なクリエイティブ マクロの完全な一覧については 、「Xandr マクロ 」を参照してください。

クリック トラッキングの例:

"media_url": "https://ad.doubleclick.net/adi/N5364.Ivillage.com/B2965815.5;sz=728x90;click0=${CLICK_URL};ord=${CACHEBUSTER}?"

カスタム マクロ

入札応答のcustom_macro機能を使用して、事前に登録されたクリエイティブに動的にパスすることができます。 たとえば、特定のキャンペーンとレポート コードを常に返す場合は、次のようにクリエイティブを設定できます:

{
   "creative":{
       "media_url":"https://adserver.com/imp?z=300x250;camp=${CAMPAIGN_ID};int=${INT_CODE}",
       "format":"url-html",
       "width":"300",
       "height":"250"
}}

すると、入札者がオークションに応答すると、入札応答で置き換えるマクロの名前と値を指定できます。たとえば、次のような例が含まれます。

"custom_macros":[
{
   "name":"CAMPAIGN_ID",
   "value":"452346"
},
{
   "name":"INT_CODE",
   "value":"a352-45we-sdr3"
}]

注:

値が整数の場合でも、引用符 ( "42" など) で囲む必要があります。

<iframe src="https://adserver.com/sz=300x250;camp=452346;int=a352-45we-sdr3" width=300 height=250/>
  • Last updated on