次の方法で共有

Bidders - クリエイティブ サービス

  • [アーティクル]

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

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

注:

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

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

アクセス許可

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

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 (クリエイティブ 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 (クリエイティブ JSON) https://api.adnxs.com/creative/MEMBER_ID?code=CODE

JSON 構造体

フィールド [Set By]\(設定\ 必須 型 説明
active 国内 いいえ ブール型 読み取り専用。 クリエイティブの現在の状態。
added_by_bidder 国内 いいえ int このクリエイティブを追加した入札者の ID。
adservers 国内 いいえ オブジェクトの配列 読み取り専用。 クリエイティブを配信する広告サーバー、またはクリエイティブの配信中にデータ収集のために呼び出される広告サーバー。
adx_audit 国内 いいえ object 読み取り専用。 このオブジェクトには、クリエイティブの Google Ad Exchange 監査に関連する状態とフィードバックに関する情報が含まれます。 クリエイティブが承認されたかどうかに関する情報は、[ audit_status ] フィールドに返されます。
allow_audit クライアント いいえ ブール型 クリエイティブを監査プロセスにオプトインする場合は、true に設定します。
allow_ssl_audit クライアント いいえ ブール型 true の場合、クリエイティブはセキュリティで保護された (https) 監査のために送信されます。 false の場合、クリエイティブは送信されません。 true の場合は、media_url_secureまたはcontent_secureも必要です。
既定値: false
audit_feedback 国内 いいえ 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 監査チーム いいえ int の一覧 クリエイティブに関連付けられているカテゴリの ID - カテゴリ サービスに関するページを参照してください。 GET の場合、これらは要求 URL で flag 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) Bidder クライアントでは機能しません。
code クライアント いいえ string (100) クリエイティブのメンバー コード。外部 ID マッピングのみを目的として使用されます (「 Bidders からの入札応答の受信」を参照)。
content クライアント いいえ (media_urlが存在する場合) テキスト media_urlの代わりに使用されるクリエイティブの生の javascript または html コンテンツ。
content_secure クライアント いいえ (media_url_secureが存在する場合) テキスト "format" が "raw-js" または "iframe-html" の場合の Javascript または HTML コンテンツは、セキュリティで保護された広告呼び出しで提供されます。
created_on 国内 いいえ timestamp クリエイティブが最初に Xandr にアップロードされたときのタイムスタンプ
creative_upload_status 非推奨。
description いいえ string (400) クリエイティブに関連付けられている省略可能な説明。
filter 非推奨。
flash_backup_url いいえ string フラッシュ形式のクリエイティブのバックアップ。これは、ユーザーのブラウザーがフラッシュをサポートしていない場合に提供されます。
flash_click_variable クライアント いいえ string フラッシュ クリエイティブの場合のみ。 フラッシュ以外のクリエイティブに対してこのフィールドに POST または PUT しようとすると、有効になっていません。 これは、Xandr がクリック追跡 URL (クリック追跡が有効な場合) を挿入する Flash clickTAG 変数の名前で、ユーザーがクリエイティブをクリックしたときに続きます。 clickTAG 変数を使用するように Flash ファイルを設定する方法については、 Adobe のデザイナーガイド を参照してください。
format 非推奨。
height クライアント ○ int クリエイティブの高さ (ピクセル単位)。
id 国内 はい (更新時) int クリエイティブの ID。内部照合目的でのみ使用されます。
impression_trackers 非推奨。
is_expired 国内 いいえ ブール値 クリエイティブが過去 15 日間に配信または変更されたかどうかを示します。
is_prohibited 国内 いいえ ブール値 True を指定すると、Xandr 内部監査システムでクリエイティブの分析中に悪意のある動作が検出されました。 True の場合、このクリエイティブは配信資格がありません。
is_suspicious 国内 いいえ ブール値 True を指定すると、Xandr 内部監査システムでクリエイティブの分析中に疑わしい動作が検出されました。 True の場合、このクリエイティブは配信資格がありません。
language_id 監査チーム いいえ int クリエイティブの言語の ID - 言語サービスに関するページを参照してください
last_activity 国内 いいえ timestamp クリエイティブが最後に変更された日時。 タイムゾーンは UTC です。 読み取り専用。
last_checked 国内 いいえ timestamp URL が最後に存在するかどうかを確認したタイムスタンプ。
media_subtypes 非推奨。
media_url クライアント いいえ (コンテンツが存在する場合) string(1000) クリエイティブの URL - 画像、フラッシュ、html、javascript を指定できます。 URL は存在する必要があり、CDN または同等の URL に存在する必要があります。
media_url_secure クライアント いいえ (content_secureが存在する場合) string(1000) セキュア (https) クリエイティブの URL - イメージ、フラッシュ、HTML、javascript を使用して、セキュリティで保護された広告通話で配信できます。 URL は存在する必要があり、CDN または同等の URL に存在する必要があります。
member_id クライアント いいえ int このクリエイティブが属するメンバーの ID。 これは API 呼び出しの URI で指定され、JSON に含める必要はありません。
mobile クライアント いいえ object モバイル クリエイティブがクリエイティブ監査に合格するために必要な情報。 以下の 「モバイル」 を参照してください。
native 非推奨。
native_attribute クライアント はい (テンプレート 39461 のネイティブ広告に必要) object これは、ネイティブ広告に必要な要素を含むネイティブ オブジェクトです。 詳細については、以下の Native Attribute オブジェクトの説明を参照してください。
no_iframes 非推奨。
no_iframes 非推奨。
not_found 国内 いいえ ブール値 URL の読み込みに失敗した回数。 一定の数のチェックを行うと、クリエイティブは非アクティブ化されます。
original_content 国内 いいえ string このフィールドは参照専用です。 サード パーティのコンテンツを含むタグが Xandr にアップロードされると、クリエイティブでアップロードされた元のコンテンツがこのフィールドに保存されます。
既定値:
必須: type raw-htmlとして送信する場合は POST。
original_content_secure 国内 いいえ string 「original_content」を参照してください。 これは、このコンテンツのセキュリティで保護されたバージョンです。
passed_sherlock_audit 国内 いいえ ブール値 Xandr 自動クリエイティブ監査システム ("Sherlock") によってクリエイティブが最近チェックされたかどうかを示します。
pixel_type 非推奨。 代わりに pixels フィールドを使用してください。
pixel_url 非推奨。 代わりに pixels フィールドを使用してください。
pixel_url_secure 非推奨。 代わりに pixels フィールドを使用してください。
pixels クライアント いいえ オブジェクトの配列 クリエイティブで提供するピクセル。 これらは、外部インプレッショントラッキング、外部クリックトラッキング、または広告の広告のアイコンをクリエイティブに追加するなどの目的で使用できます。 詳細については、以下の ピクセル を参照してください。
placement クライアント いいえ string(50) このクリエイティブの配置の名前 (省略可能) - レポート/管理目的で使用されます。
pop_values 非推奨。
segments クライアント いいえ 配列 このクリエイティブを表示またはクリックしたときにユーザーが追加するセグメントの一覧。 詳細については、以下 の「セグメント 」を参照してください。 例: "segments": [ { "id": 11111, "action": "add_on_view" }, { "id": 22222, "action": "add_on_click" } ]
size_in_bytes 国内 いいえ int メディア ファイルのサイズ (バイト単位)。
sla クライアント いいえ integer プラットフォーム監査を要求するときのターゲット期間。 値 0 は標準、2 は優先度/ラッシュです。 既定値は 0 です。
注: 標準監査を要求すると、api はこのフィールドに null の値を設定します。
ssl_status 監査チーム いいえ enum('disabled','pending','approved','failed') ssl_status = 承認済みのクリエイティブのみが、安全な在庫で配信できます。 注: クリエイティブが ssl Sherlock 監査に失敗した場合は、このフィールドを "保留中" に変更することで、(ダウンストリームのセキュリティで保護されていないコンテンツを修正したら) 再テストのために送信できます。
既定値: 'disabled'
state 国内 いいえ 列挙 クリエイティブの状態。 使用可能な値は"アクティブ" または "非アクティブ" です
status クライアント いいえ object クリエイティブが配信する準備ができているかどうかを説明するクリエイティブの状態。 詳細については、以下の 「状態」 を参照してください。
technical_attributes 監査チーム いいえ int の一覧 クリエイティブに関連付けられている技術属性の ID - 技術属性サービスに関するページを参照してください。 GET の場合、これらは要求 URL で flag 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) ビデオ クリエイティブの属性。 詳細については、以下の 「ビデオ属性 」を参照してください。
width クライアント ○ int クリエイティブの幅 (ピクセル単位)。

Mobile

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

オーディオ

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

Video 属性

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

注:

Audio ビデオ属性オブジェクトは、オーディオ クリエイティブの作成にも使用されます。 オーディオのテンプレート 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_hosted を falseする必要があります。
wrapper object elements配列とtrackers配列を含む VAST ドキュメント ラッパー。

ビデオ属性ラッパー

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

フィールド 種類 説明
elements 配列 VAST ラッパーの要素。
secure_url string VAST ドキュメントのセキュリティで保護された URL。
url string VAST ドキュメントの URL。

Video 属性ラッパー要素

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 ブール値 ピクセルをセグメント ピクセルとして定義し、デバイスの種類に関係なく、そのイベントの userid がセグメントに確実に追加されるようにします。 既定値 = 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 標準バナー
2 url-js 標準バナー
3 フラッシュ 標準バナー
4 image 標準バナー
5 raw-js 標準バナー
6 raw-html 標準バナー
7 iframe-html 標準バナー
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

エキスパンド クリエイティブの詳細については、「 Expandables and Rich Media 」ページを参照してください。

状態

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

ネイティブ属性

native_attribute オブジェクトには、次のフィールドが含まれています。 詳細については、「例」の 「ネイティブ クリエイティブの追加 」を参照してください。

フィールド 種類 説明
data_assets オブジェクトの配列 ネイティブ クリエイティブの属性。 詳細については 、以下の「データ資産 」を参照してください。
image_assets オブジェクトの配列 個々のイメージの属性。 詳細については、「 イメージアセット 」を参照してください。
image_trackers オブジェクトの配列 ネイティブ クリエイティブで使用することを目的としたサード パーティのインプレッション トラッキング URL の一覧。 詳細については、以下の 「イメージ トラッカー 」を参照してください。
javascript_trackers オブジェクトの配列 サード パーティのインプレッション トラッキング URL の一覧。 詳細については、以下の 「Javascript Trackers 」を参照してください。 このフィールドでは、${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 のプレフィックスが wit '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" - クリエイティブのタイトル
- "説明" - アドバタイズされる製品またはサービスの説明
- "rating" - 提供されている製品の評価
- "call_to_action" - 次の手順で推奨されるアクション
- "display_url" - 表示する URL
- "likes" - ソーシャル メディアのいいね
- "downloads" - この製品のダウンロード/インストール数
- "価格" - 製品/アプリ/アプリ内購入の価格
- "sale_price" - 割引価格を示すために価格と共に使用できる販売価格
- "phone" - 電話番号 "address" - 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

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

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

カスタム ピクセルはユーザーによって定義され、クリエイティブが監査のために再送信されます。 カスタム ピクセルを追加するには、形式と、形式に応じてコンテンツまたは 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 .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。 Pixel Template Service を使用して、この ID を取得できます。
url string (255) ピクセル形式が "url-html"、"url-js"、"url-image"、または "raw-url" の場合は、クリエイティブで配信する HTML、JavaScript、または Image ピクセルの URL。

セグメント

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

フィールド 種類 説明
action 列挙 ユーザーがセグメントに追加するアクション。 使用可能な値: [ビューに追加] または [クリック時に追加] です。
必須: 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'Default: 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 
        }
  }
}

$ 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,
      "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 フィールドを true に設定する必要があります。

$ 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とパラメーターの数を調べる必要があります。 この情報を取得するには、 Pixel Template Service を使用します。

$ 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 に設定し、ピクセル コンテンツの {P1} と {P2} の値にparam_1とparam_2を設定します。

注:

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

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

最後に、PUT 呼び出しを行ってクリエイティブを更新します。 応答のピクセル配列は、ピクセルが追加されたことを示します。 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"
                }
        }
}

クリエイティブに割り当てられている Technical Atttributes の決定

技術的な属性は、今日の自動レポートに追加できるものではありませんが、これは bidder API の Creative サービスを通じて取得できます。 詳細については、技術属性サービスに関するページを参照してください。

これは、クエリ文字列パラメーター "?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 内のオブジェクトとのインターフェイスに関する最新の情報を提供します。

クリエイティブ マクロ

インプレッション バスでは、事前に定義された Xandrcreative マクロ と、入札者によって定義できる カスタム マクロ の 2 種類のクリエイティブ マクロがリアルタイムで置き換えられます。 2 つの主な違いは、パースペクティブです。 たとえば、リアルタイム入札が行われると、インプレッション バスにはキャンペーンや挿入順序に関する知識がないため、入札者の内部オブジェクト モデルでサポートされ、マクロで必要なオブジェクトは、カスタム マクロを使用してサポートする必要があります。

警告

マクロの制限

  • クリエイティブを登録する場合は、定義済みの 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/>