ドキュメント

​
​

Development

User Acquisition

Monetization

産業

Grow

Unity Ads Android SDK

Unity Ads iOS SDK

LevelPlay SDK

Unity Dashboard を開く

Grow

Programmatic Ads
​
​
概要
  • Unity Exchange の概要
  • Unity Exchange の使用の準備
インテグレーション
  • インテグレーションガイドライン
  • 入札リクエスト
  • 入札レスポンス
    • 損失通知
クリエイティブフォーマット
  • クリエイティブ形式ガイドライン
  • 動画広告
  • ディスプレイ広告
  • バナー広告
  • Playable広告
広告体験
  • 広告体験のガイドライン
  • Auto StoreKit
  • SKOverlay
  • カスタムプロダクトページ
  • クリック可能な動画
  • ディープリンク
  • 呼び出しアクション テキストのサポート
Unity Ads パートナーポータル
  • パートナーポータルの概要
  • 使用の準備
  • 入札レスポンスのテスト
プライバシー
  • プライバシーの概要
  • データプライバシー
  • iOS SKAdNetwork サポート
参照情報
  • IAB カテゴリ マッピング
  • よくある質問
  1. ゲームの成長
  2. プログラマティック広告
  3. Unity Exchange の概要

入札レスポンス

デマンドパートナーがオークションと広告配信の要件を満たす有効なレスポンスを構造体できるようにヘルプします。
読み終わるまでの所要時間 37 分
最終更新 7日前

Unity は、入札反応データの JSON 形式をサポートしています。標準 JSON 表現の MIME タイプは
application/json
で、
HTTP
ヘッダーフィールドで次のように指定します。
contentType: application/json
アプリケーションは、専用エンドポイントへの入札リクエストを受信した後、最大 200 ミリ秒以内に入札反応を返すか、入札なしを示す必要があります。Unity はリクエストで承諾エンコード GZIP 圧縮を送信します。推奨されるベストプラクティスは、反応を圧縮することです。詳細については、OpenRTB 仕様のセクション 2.4 を参照してください。
注
推奨されるベストプラクティスは、ロードバランサなどの DSP サーバが HTTP 永続化された接続 (Keep-Alive とも呼ばれます) をアクティベートし、自動
IdleConnTimeout
を少なくとも 90 秒間行わないようにすることです。これは、接続管理のオーバーヘッドとインターフェースの両側のCPU使用率を削減することで、全体的なパフォーマンスに大きな影響を与えます。
反応オブジェクトとその属性については、次のセクションで説明します。Description (説明) フィールドは、必須の属性を示します。推奨されるベストプラクティスは、すべての属性を含めることです。

反応オブジェクト

入札リクエストに対する入札者の反応を示すオブジェクト クラス。

Attribute

型

例

説明

id
string
"id":"7jrUifdKuw3HDIR9dbqDVJ"
Unity が生成した ID。入札リクエストとともに渡され、入札反応とともに返されます。
重要
この属性は反応で必須です。
cur
string
"cur": "USD"
ISO 通貨コードを使用した通貨タイプUnity は米ドル (
USD
)、および
CNY
などの他の通貨をサポートしています。このフィールドが、
adsource
設定で定義された通貨フィールドと一致し、
exchange_rate
が空でないことを確認します。空でない場合、Unity は入札反応を無視します。
重要
この属性は反応で必須です。
bidid
string
"bidid": "CHYr9b0ODI8OGLpedtfCpuCH"
入札者が生成する反応 ID。ロギングと追跡に役立ちます。
nbr
int
"nbr": 6
入札を拒否した理由。サポートされている値の完全なリストについては、OpenRTB API ガイド の 表 5.24 を参照してください。入札への回答なしのセクションも参照してください。
seatbid
object array詳細は、
seatbid
オブジェクト
のセクションを参照してください。
Unity Exchange では、1 つの反応に複数の
seatbid
オブジェクトを使用できますが、現在、1 つの
seatbid
オブジェクト配列のみを使用します。選択された seatbid オブジェクトには、
impression.id
と等しい
bid.id
が含まれます。複数の
seatbid
オブジェクトがこの基準を満たす場合、Unity Exchange は 1 つをランダムに選択します。
重要
この属性は反応で必須です。

seatbid オブジェクト

パートナーが複数のアカウントを代理して入札できるようにする
bid
オブジェクト
配列を含むオブジェクト クラス。

Attribute

型

例

説明

bid
object array詳細については、
bid
オブジェクト
のセクションを参照してください。
1 つ以上の入札。複数の入札を行う場合は、オークション落札の可能性を最大限に高めるために、最も高いオファーを含めます。
重要
この属性は反応で必須です。
seat
string
"seat": "1234"
購入者シート、または入札を行う広告主または代理店の ID。
重要
この属性は反応で必須です。

bid objects

購入者の入札に関する情報を含むオブジェクトクラス。

Attribute

型

例

説明

id
string
"bidid": "1234567890123456789"
入札者が生成する入札 ID。ログ記録とトラッキングに役立ちます。
重要
この属性は反応で必須です。
impid
string
"impid": "1"
この入札に関連付けられているインプレッションの ID。この値は、入札リクエストで指定されたインプレッション ID と一致します。
重要
この属性は反応で必須です。
price
float
"price": 0.78
入札価格(インプレッション 1000 回あたりの単価、CPM)。Unity Exchange では、ゼロ以下の値や暗号化された値は無視されます。
重要
この属性は反応で必須です。
注
Unity は小数点以下 3 桁まで入力できますが、2 桁が推奨されます。
adid
string
"adid": "12345678"
落札した場合に配信される、プリロードされた広告の入札者生成 ID。
nurl
string
"nurl":"https://bidder.com/win?${AUCTION_PRICE}"
広告がユーザーにレンダリングされるときに Unity が ping する獲得通知 URL。この属性は、課金対象のインプレッションカウンターとしても機能します。
注
Unity は配信時に
nURL
を起動し、Bid Price macro(
${AUCTION_PRICE}
; 入札価格マクロ)を入札がクリアされた実際の価格に置き換えます。
重要
この属性は、反応に
bURL
がない場合の一意の Unity Exchange 要件です。
burl
string
"burl": "https://fake-test.com/imp?${AUCTION_PRICE}"
落札者に課金が発生するときに Unity Exchange によって呼び出される課金通知 URL。これは取引所固有のビジネスポリシーに基づいています。置換マクロを含めることができます。
重要
この属性は、反応に
imptrackers
属性がない場合の一意の Unity Exchange 要件です。
注
Unity は配信時に
bURL
に ping を実行し、Bid Price macro(
${AUCTION_PRICE}
; 入札価格マクロ)を入札がクリアされた実際の価格に置き換えます。
iurl
string
"iurl": "https://secure-datacenter.dsp.com/cr?id=12345678"
キャンペーンのコンテンツを表す画像へのキャッシュ バーストなしのURL(広告品質と安全性のチェック用)。
cid
string
"cid": "1234"
入札者が生成するキャンペーン ID。広告品質チェックに役立ちます。
iURL
画像は、このコンテンツのコレクションを代表するものでなければなりません。
crid
string
"crid": "12345678"
広告の品質チェックを支援するためにパートナーから提供されるクリエイティブ ID。
dealid
string
"dealid": "Unity-MM-0034"
直接取引の一意の識別子(該当する場合)。
注
この ID は、入札リクエストで送信された 取引 ID と一致する必要があります。
cat
string array
"cat": ["IAB3-12", "IAB21-2", "IAB10-9" "NEX3-102"]
クリエイティブに適用される IAB コンテンツカテゴリ。サポートされている値の完全なリストは、OpenRTB API ガイド の表 5.1 を参照してください。
重要
この属性は反応で必須です。
adm
stringその他の例については、入札レスポンスの例 を参照してください。
入札が落札された場合に広告マークアップを伝える手段。
重要
この属性は反応で必須です。
adomain
string 配列
正解:
  • "adomain": ["yourgame.com"]
  • "adomain": ["studio.yourgame.com"]
不正解:
  • "adomain": ["yourgame.com/something"]
  • "adomain": ["www.yourgame.com"]
ブロック リスト チェックの広告主ドメイン。クリエイティブはローテーションできず、1 つのドメインのみが許可されます。形式はルートドメインのみで、プロトコルは指定しないでください("www" でない場合はサブドメインを含めることができます)。
重要
この属性は反応で必須です。
bundle
string
Google の例:
  • "bundle": "com.unityexample.game"
Apple の例:
  • "1198634425"
プラットフォーム固有のアプリケーション識別子(Apple App Store または Google 再生のストア ID)。宣伝対象のアプリケーションに一意のもので、エクスチェンジとは無関係です。この特徴は広告品質にも使用できます。
重要
この属性は、アプリケーション広告に対する一意の Unity Exchange 要件です。
attr
int 配列
"attr": [1, 13]
クリエイティブを説明する属性の配列。サポートされている値の完全なリストは、OpenRTB API ガイド の表 5.3 を参照してください。
w
int
"h": 568
デバイス非依存ピクセル(DIPS)でのクリエイティブの幅。
重要
この属性はバナー広告に必須であり、すべての形式に推奨されます。
h
int
"w": 320
クリエイティブの高ささ (デバイス非依存ピクセル、DIPS)。
重要
この属性はバナー広告に必須であり、すべての形式に推奨されます。
api
int
"api":7
このインプレッションでサポートされる API フレームワーク。値 は、Open Measurement (OM) のサポートを
7
示します。詳細については、OM 拡張機能 に関するドキュメントを参照してください。

bid.ext objects

bid
オブジェクトを拡張するオブジェクトサブクラス。
重要
iOS14でSKAdNetworkをサポートするには、ext属性をオブジェクトとして追加する必要があります。

Attribute

型

例

説明

appid
string
"appid": "1234567890123"
宣伝対象のアプリケーションのアプリストア ID (該当する場合)。アプリストア ID の確認方法の詳細については、Unity Ads 収益化ダッシュボードのドキュメント ストア ID を参照してください。
appname
string
"appname": "Example Game"
宣伝対象のアプリケーション名(該当する場合)。
storeurl
string
"storeurl": "https://itunes.apple.com/us/app/trash-dash/id1198634425?mt=8"
宣伝対象のアプリケーションのアプリストア URL(該当する場合)。
重要
この属性は、アプリケーション広告に対する一意の Unity Exchange 要件です。
imptrackers
string array
["https://ad.doubleclick.net/ddm/trackimp","https://dsp.com/amet?et=show&id=60e47b64b59Q"]
Unity が課金対象のインプレッションイベントを記録するときに一貫しサードパーテ。入札
bURL
の代わりに使用できます。
重要
この属性は、反応に
burl
属性がない場合の一意の Unity Exchange 要件です。
length
int
"length": 15
ビデオの長さ(秒)(該当する場合)。
crtype
string
"crtype": "VAST 3.0"
広告アセットのクリエイティブタイプ。以下のタイプが有効です。
  • VAST
  • VAST 2.0
  • VAST 3.0
  • VAST 4.0
  • VAST VPAID
  • MRAID playable
  • MRAID 2.0
  • BANNER
  • HTML
  • HTML5
  • JS
重要
これらの値は大文字と小文字を区別しません。この属性は反応で必須です。
ext.skadn.skoverlay.show
整数
1
SKOverlay を表示するかどうかを示します。
  • 1
    は「はい」を示します。
  • 0
    は no を示します。
重要
Unity は、show = 1 の場合にデフォルト値を表示し、残りの属性は空です。
ext.skadn.skoverlay.position
整数
1
SKOverlay の位置を示します。
  • 0
    底を示します。
  • 1
    bottomRaised を示します。
  • デフォルト値は 0
ext.skadn.skoverlay.dismissable
整数
1
ユーザーがSKOverlayを削除できるかどうかを示します。
  • 0
    なし (静的) を示します。
  • 1
    は、はい (解除可能) を示します。
  • デフォルト値は 1
ext.skadn.skoverlay.video_delay
整数
1
SKOverlay が表示されるまでの遅延時間を秒単位で示します。0 は即時を意味します。
  • デフォルト値は 5 で、最大値は 60 です。
ext.skadn.productpageid
String
00d00d1e-ff93-67fc-653f-8ggd1eeghcdf
詳細については、Apple の 複数のプロダクトページバージョンの設定 を参照してください。
ext.skadn.ext.ask
整数
1
自動 Storekit の異なるバージョンを示します。
  • 1
    ユーザーがビデオをスキップしたときに Storekit を表示することを示します。スキップアクションからストアキットを開くときに Click イベントは送信されません。
  • 2
    ユーザーがビデオをスキップしたり、ビデオの視聴を終了したときに Storekit を表示することを示します。スキップアクションからストアキットを開くときに Click イベントは送信されません。
  • 3
    ユーザーがビデオをスキップしたときに Storekit を表示することを示します。Click イベントは、スキップアクションからストアキットを開くときに送信されます。
  • 4
    ユーザーがビデオをスキップするか、ビデオの視聴を終了したときに Storekit を表示することを示します。Click イベントは、スキップアクションから Storekit を開くときに送信されます。
ext.clickablevideo
整数
1
クリック可能な動画体験を有効にするかどうかを指定します。
  • 1
    はいを示します。
  • 0
    いいえを示します。

入札レスポンスの例

Playable 反応

{ "id": "7jrUifdKuw3HDIR9dbqDVJ", "seatbid": [{ "bid": [{ "id": "1234567890123456789", "impid":"1", "price":0.78, "adid":"12345678", "nurl": "https://secure-datacenter.dsp.com/ab?e=wqT_3FL5gUgASotCQAAAQZjkxNjQ.\\u0026referrer=play.google.com%2Fstore%2Fapps%2Fdetails%3Fid%3Dcom.any.game\\u0026pp=${AUCTION_PRICE}\\u0026label=nurl", "burl": "https://secure-datacenter.dsp.com/ab?e=wqT_3FL5gUgASotCQAAAQZjkxNjQ.\\u0026referrer=play.google.com%2Fstore%2Fapps%2Fdetails%3Fid%3Dcom.any.game\\u0026pp=${AUCTION_PRICE}\\u0026pplabel=burl", "adm": "<img src=\"https://my.impression.com/custom/pixel?1234%3D\" style=\"ディスプレイ: none;\">\n <a href=\"https:/my.custom.click/event?&partner=myDSP\"><div style=\"position: fixed; top:0; left:0; width:100vw; 高さ:100vh; 背景位置: center; 背景画像: URL('https://ex_assets.com/ad_assets/files/000/897/403/original/.jpg?c=1595511733'); 背景サイズ: contain;\"> </Important>ript type=\"アプリケーション/JavaScript\"> bmTrackViewableChange=機能(e){mraid.addEventListener(\"viewableChange\",機能(){コンソール.log(\"空のviewableChange....イベント\")},e&bmSendImpression()},bmSubscribeViewableEvent=機能(){bmSendFill(),bmSubscribeClickEvent(),mraid.addEventListener(\"ready\",機能(){コンソール.log(\"空の準備完了イベント\")}),mraid.isViewable()?bmSendImpression():(mraid.addEventListener(\"viewableChange\",機能)(}),mraid.addEventListener(\"viewableChange\",機能), mbmSubscribeViewableEvent(), msubscribeViewableEvent=機能(){bmSendClickEvent(), mSubscribeViewer.addEvent=機能(), mmSendClickEvent(), msubscribeSubscribeViewableEvent(), msubscribeViewer.addEventListener(\"mClickEvent(), mbmSendEvent(), mSendEvent(), mAddEvent.AddEvent(), mmSendEvent(!); mraid.isViewable(), mraid.addEventListener(\"viewable\", msubscribeViewableEventListener\", mbmClickEvent(), msubscribeViewableEvent(!); mSendEvent(), mSendEvent(), mSendEvent.addEvent(), mraid.AddEvent(\");\n</script>", "adomain": ["viaplay.fi"], "bundle": "com.unityexample.game", "iurl": "https://secure-datacenter.dsp.com/cr?id=12345678", "cid":"1234", "crid":"12345678", "cat": ["IAB3-12"、"IAB3-8"、"IAB21-2"、"IAB10-9"、"IAB3"、"NEX3-101"、"IAB3-11"、"IAB3-10"、"NEX3-102"、"IAB3-5"、"IAB3-6"], "attr": [], "h":320, "w":480, "appcategory": ["Games"], "appsubcategory": ["Adventure", "Action"], "ext": { "appname":"サンプルゲーム", "storeurl": "https://play.google.com/store/apps/details?id=com.unityexample.game", "crtype":"PLAYABLE" } }], "seat":"1234" }], "bidid":"CHYr9b0ODI8OGLpedtfCpuCH", "cur":"USD",}

VAST response

{ "id": "7jrUifdKuw3HDIR9dbqDVJ", "bidid":"CHYr9b0ODI8OGLpedtfCpuCH", "cur":"USD", "seatbid": [{ "seat":"パートナーの例", "bid": [{ "impid":"1", "adomain": ["examplegame.com"], "iurl": "https://secure-datacenter.dsp.com/cr?id=12345678", "crid":"12345678", "cid":"1234", "adid":"87654321", "cat": ["IAB9-25", "IAB9-25"], "bundle": "com.unityexample.game", "attr": [], "h":568, "w":320, "id": "unrtb-com.unityexample.game-320x568-1ADJE5D8721B3-453S-9DYA-B0AVD69AA1A1", "price":15.04, "nurl": "https://secure-datacenter.dsp.com/ab?e=wqT_3FL5gUgASotCQAAAQZjkxNjQ.\\u0026referrer=play.google.com%2Fstore%2Fapps%2Fdetails%3Fid%3Dcom.any.game\\u0026pp=${AUCTION_PRICE}\\u0026label=nurl", "burl": "https://secure-datacenter.dsp.com/ab?e=wqT_3FL5gUgASotCQAAAQZjkxNjQ.\\u0026referrer=play.google.com%2Fstore%2Fapps%2Fdetails%3Fid%3Dcom.any.game\\u0026pp=${AUCTION_PRICE}\\u0026pplabel=burl", "adm": "<?xml version=\"1.0\"?><VAST version=\"2.0\"><Ad id=\"179e7ee9\"><InLine><AdSystem>yourdsp<![CDA</AdSystem><Error>TA[https://ads.yourdsp.com/ads/vast.php?appkey=unrtb-com.catchall.game-320x568&adid=179e7ee9&appid=1139609950&aid=1ABAE8D8-21B3-453D-9DEA-B9ABD69AA1A1&partnerkey=unrtb&campaignID=123184311&adgroupID=180968&ra=&code=err]]><!</Error><Impression>[CDATA[https://ads.yourdsp.com/ads/vast.php?appkey=unrtb-com.catchall.game-320x568&adid=179e7ee9&appid=1139609950&aid=1ABAE8D8-21B3-453D-9DEA-B9ABD69AA1A1&partnerkey=unrtb&campaignID=1234567890&adgroupID=180968&ra=&code=impression]]>00</Impression><Creatives><Creative AdID=\"179e7ee9\"><Linear><Duration>:00:15<![CDA</Duration><TrackingEvents><Tracking event=\"skip\">TA[https://ads.yourdsp.com/ads/vast.php?appkey=unrtb-com.catchall.game-320x568&adid=179e7ee9&appid=1139609950&aid=1ABAE8D8-21B3-453D-9DEA-B9ABD69AA1A1&partnerkey=unrtb&campaignID=123456789&adgroupID=180968&ra=&code=skip&s=]]><!</Tracking><Tracking event=\"engagedView\">[CDATA[https://ads.yourdsp.com/ads/vast.php?appkey=unrtb-com.catchall.game-320x568&adid=179e7ee9&appid=1139609950&aid=1ABAE8D8-21B3-453D-9DEA-B9ABD69AA1A1&partnerkey=unrtb&campaignID=123456789&adgroupID=180968&ra=&code=engagedView&s=]]><!</Tracking><Tracking event=\"creativeView\">[CDATA[https://ads.yourdsp.com/ads/vast.php?appkey=unrtb-com.catchall.game-320x568&adid=179e7ee9&appid=1139609950&aid=1ABAE8D8-21B3-453D-9DEA-B9ABD69AA1A1&partnerkey=unrtb&campaignID=123184311&adgroupID=180968&ra=&code=creativeView&s=]]><!</Tracking><Tracking event=\"start\">[CDATA[https://ads.yourdsp.com/ads/vast.php?appkey=unrtb-com.catchall.game-320x568&adid=179e7ee9&appid=1139609950&aid=1ABAE8D8-21B3-453D-9DEA-B9ABD69AA1A1&partnerkey=unrtb&campaignID=123184311&adgroupID=180968&ra=&code=start&s=]]><!</Tracking><Tracking event=\"firstQuartile\">[CDATA[https://ads.yourdsp.com/ads/vast.php?appkey=unrtb-com.catchall.game-320x568&adid=179e7ee9&appid=1139609950&aid=1ABAE8D8-21B3-453D-9DEA-B9ABD69AA1A1&partnerkey=unrtb&campaignID=123184311&adgroupID=180968&ra=&code=firstQuartile&s=]]><!</Tracking><Tracking event=\"midpoint\">[CDATA[https://ads.yourdsp.com/ads/vast.php?appkey=unrtb-com.catchall.game-320x568&adid=179e7ee9&appid=1139609950&aid=1ABAE8D8-21B3-453D-9DEA-B9ABD69AA1A1&partnerkey=unrtb&campaignID=123184311&adgroupID=180968&ra=&code=midpoint&s=]]><!</Tracking><Tracking event=\"thirdQuartile\">[CDATA[https://ads.yourdsp.com/ads/vast.php?appkey=unrtb-com.catchall.game-320x568&adid=179e7ee9&appid=1139609950&aid=1ABAE8D8-21B3-453D-9DEA-B9ABD69AA1A1&partnerkey=unrtb&campaignID=123184311&adgroupID=180968&ra=&code=thirdQuartile&s=]]><!</Tracking><Tracking event=\"complete\">[CDATA[https://ads.yourdsp.com/ads/vast.php?appkey=unrtb-com.catchall.game-320x568&adid=179e7ee9&appid=1139609950&aid=1ABAE8D8-21B3-453D-9DEA-B9ABD69AA1A1&partnerkey=unrtb&campaignID=123184311&adgroupID=180968&ra=&code=complete&s=]]><!</Tracking></TrackingEvents><VideoClicks><ClickThrough>[CDATA[https://c.yourdsp.com/ads/c.php?a=unrtb&b=unrtb-com.catchall.game-320x568&c=179e7ee9&d=1ABAE8D8-21B3-453D-9DEA-B9ABD69AA1A1&ct=0&nb=0&its=1499375139&gf=https%3A%2F%2Fcdngs.yourdsp.com%2F1028%2F768x1024_Unsub_NewGame_Video_All_ZHCN_MZCA02xbqA4.ipad_20170629_09_44_11_.mp4&f=&ra=&aid=1ABAE8D8-21B3-453D-9DEA-B9ABD69AA1A1&campaignID=123184311&adgroupID=180968&adgroup=NewGame_iOS_NL&defcpa=0&defcpc=0&appid=1186994231&creativeID=329c8ef3&adType=5&countrycode=NL&ccimpid=X96142d9408c8a40179e7ee907061405&accountid=1028&siteaccountid=4917655231945&pubappid=&sg=&it=&inf=0&price=0.04800847457627119&cg=New,Set&creativeID=329c8ef3]]><![</ClickThrough><ClickTracking>CDATA[https://ads.yourdsp.com/ads/vast.php?appkey=unrtb-com.catchall.game-320x568&adid=179e7ee9&appid=1139609950&aid=1ABAE8D8-21B3-453D-9DEA-B9ABD69AA1A1&partnerkey=unrtb&campaignID=123184311&adgroupID=180968&ra=&code=click]]><!</ClickTracking></VideoClicks><MediaFiles><MediaFile delivery=\"progressive\" type=\"video/mp4\" bitrate=\"500\" width=\"768\" height=\"1024\" scalable=\"true\" maintainAspectRatio=\"true\">[CDATA[https://cdngs.yourdsp.com/1028/768x1024_Unsub_NewGame_Video_All_ZHCN_MZCA02xbqA4.ipad_20170629_09_44_11_.mp4]]><!</MediaFile></MediaFiles></Linear></Creative><Creative AdID=\"179e7ee9\"><CompanionAds><Companion width=\"768\" height=\"1024\"><StaticResource creativeType=\"image/jpeg\"><![CDATA[]]></StaticResource><TrackingEvents><Tracking event=\"creativeView\">[CDATA[https://ads.yourdsp.com/ads/vast.php?appkey=unrtb-com.catchall.game-320x568&adid=179e7ee9&appid=1139609950&aid=1ABAE8D8-21B3-453D-9DEA-B9ABD69AA1A1&partnerkey=unrtb&campaignID=123184311&adgroupID=180968&ra=&code=engagedView]]><!</Tracking></TrackingEvents><CompanionClickThrough>[CDATA[https://c.yourdsp.com/ads/c.php?a=unrtb&b=unrtb-com.catchall.game-320x568&c=179e7ee9&d=1ABAE8D8-21B3-453D-9DEA-B9ABD69AA1A1&ct=0&nb=0&its=1499375139&gf=https%3A%2F%2Fcdngs.yourdsp.com%2F1028%2F768x1024_Unsub_NewGame_Video_All_ZHCN_MZCA02xbqA4.ipad_20170629_09_44_11_.mp4&f=&ra=&aid=1ABAE8D8-21B3-453D-9DEA-B9ABD69AA1A1&campaignID=123184311&adgroupID=180968&adgroup=NewGame_iOS_NL&defcpa=0&defcpc=0&appid=1186994231&creativeID=329c8ef3&adType=5&countrycode=NL&ccimpid=X96142d9408c8a40179e7ee907061405&accountid=1028&siteaccountid=4917655231945&pubappid=&sg=&it=&inf=0&price=0.04800847457627119&cg=New,Set&creativeID=329c8ef3]]>", </CompanionClickThrough></Companion></CompanionAds></Creative></Creatives></InLine></Ad></VAST>. "ext": { "advertisername":"One Cool Advertiser" "appid":"1234567890123", "appname":"サンプルゲーム", "storeurl": "https://itunes.apple.com/us/app/trash-dash/id1198634425?mt=8", "length":15, "crtype":"VAST" "clickablevideo":1, "deeplinking":1, "cta_text":"Shop Now" "skadn": { "ext": { "ask":2 }, "productpageid":"00d00d1e-ff93-67fc-653f-8ggd1eeghcdf", "skoverlay": { "show":1, "position":0, "dismissable":0, "video_delay":5, } } } }] }] }

入札レスポンスなし(NBR)

Unity Exchange は、入札なしの場合に複数の反応タイプをサポートします。これらの反応のいずれかを使用して、インプレッションに入札しないことを明示的に信号にすることが重要です。そうしないと、反応がタイムアウトエラーとして解釈される可能性があります。

Response

例

コンテンツなし
HTTP 204 No Content
空の JSON オブジェクト
{}
適切な形式の入札反応(理由コードあり/なし)
{"id": "1234567890", "seatbid": {}, "nbr": 2}
その他
  • 200 OK
  • 302 Redirect
詳細については、OpenRTB 仕様のセクション 7.1 を参照してください。

NBR reason codes

値

説明

0
不明なエラー
1
テクニカル エラー
2
無効なリクエスト
3
既知のウェブ スパイダー
4
非人的トラフィックの疑い
5
クラウド、データセンター、またはプロキシ IP
6
サポートされないデバイス
7
ブロックされたパブリッシャーまたはサイト
8
不一致ユーザー

価格難読化

nURL
の送信時に推奨されるベストプラクティスは、
${AUCTION_PRICE:BF}
値に難読化を実装して、クライアント側で機密性の高い価格情報を安全に保つことです。これは任意の特徴です。

方法論

データを難読化するために、Unity は ECB モードで Blowfish を使用し、PKCS5 パディング(8 バイトのブロック サイズの PKCS7 パディング)を入力データに適用します。データは base64 URL エンコードされ、バイナリデータは URL で有効になります。ソースコードは、トラブルシューティングのリクエストに応じて入手できます。
base64_URLEncode(blowfish_ecb_encrypt_pkcs5_padding(plaintext))

パラメーター

値の例

key
"encryption_key"
plaintext
"10.20"
暗号化された、base64 URL エンコードされた
"z5eznndAkpE="
注
Unity は実稼働環境で別の暗号化キーを使用します。

暗号解読

データを解読するには、入力文字列は base64 URL デコードされます。その後、暗号化されたデータから PKCS5 パディングが削除され、Blowfish ECB 暗号化が元に戻されます。
blowfish_ecb_decrypt_pkcs5_padding(base64_URLDecode(encodedtext))

Copyright © 2026 Unity Technologies
法規事項プライバシーポリシークッキーDocumentation Terms of Use私の個人情報を販売または共有しないプライバシーに関する選択 (クッキー設定)

"Unity" の名称、Unity のロゴ、およびその他の Unity の商標は、米国およびその他の国における Unity Technologies またはその関係会社の商標または登録商標です (詳しくはこちら)。その他の名称またはブランドは該当する所有者の商標です。

一部のページは利便性向上のため機械翻訳を使用しており、内容に不正確な表現が含まれる場合があります。内容に齟齬または不一致が生じた場合は、英語版を正本とします。

  • このページ
    • 反応オブジェクト

    • seatbid オブジェクト

    • bid objects

      • bid.ext objects

    • 入札レスポンスの例

      • Playable 反応

      • VAST response

    • 入札レスポンスなし(NBR)

      • NBR reason codes

    • 価格難読化

      • 方法論

      • 暗号解読


このページの問題を報告する