ネイティブ 1.2 ADM を使用するための要件
ネイティブ広告マークアップ入札 (ADM) を使用すると、入札者は OpenRTB 入札応答の [ adm ] フィールドを介してネイティブ広告マークアップを送信できます。 すべてのクリエイティブを Microsoft 収益化に登録する代わりに、次の組み合わせごとに 1 つのクリエイティブを登録します。
- あなたが代表する一意の広告キャンペーンまたはブランド
- サポートされている一意の言語
重要
adomain フィールドが必要です。 指定された URL のブランド化は、 adm フィールドのコンテンツと登録済みのクリエイティブのブランド化と一致している必要があります。
注:
収益化サーバー側では、支出とインプレッションの追跡に BURL を使用することを強くお勧めします。
ネイティブ ADM の概要
この機能に対して入札者が 有効になっている 必要があります。 入札者が有効になっているかどうかわからない場合は、収益化アカウントの担当者にチェックするか、製品サポート チケットを開いてください。
有効にしたら、次の 2 つの手順に従って ADM 経由でインベントリを購入します。
- 個別ブランドのクリエイティブを登録する – このブランドに 関連付けられているすべてのクリエイティブアセットは、登録されたクリエイティブを通じて配信されます。
- 動的クリエイティブアセットによる入札 – 入札 応答で送信された広告マークアップは、登録されたクリエイティブと一致する必要があります。
注:
この機能では、ネイティブのビデオ広告マークアップによる入札はサポートされていません。 ビデオネイティブ以外の広告マークアップのみが受け入れられます。
ネイティブ クリエイティブを登録する
クリエイティブ サービスを使用して、ブランドと言語の組み合わせごとに 1 つのクリエイティブを登録します。 クリエイティブを登録するときは、次の点を考慮してください。
- クリエイティブは、このブランドの入札応答で動的に渡される実際の広告の 1 つを表す必要があります。
- 登録のために選択された特定の広告は関係ありません。
- クリエイティブは収益化広告枠で配信する資格が必要です。
- クリエイティブはプラットフォーム監査を受ける必要があります。
- ネイティブ クリエイティブを登録する場合、いくつかの OpenRTB マクロと Microsoft マクロがサポートされます。
admでサポートされているマクロの一覧については、以下の「追跡マクロ」セクションを参照してください。 -
brand_idフィールドを指定する必要はありません。収益化は、監査中にこれを設定します。 - 入札では OpenRTB プロトコルを使用する必要があります。
- クリエイティブを登録するときに、インプレッショントラッカーとクリックトラッカーを含めます。 入札応答の広告マークアップでは、クリエイティブに登録されたのと同じベンダー (または少ない) セットを使用する必要があります。
ネイティブ ADM での入札
仕様
注:
ネイティブ v1.2 IAB の仕様を参照してください。
考慮事項
- ネイティブ クリエイティブ テンプレート
39461を使用します。 - ネイティブ クリエイティブアセットは、
seatbid.bid.admオブジェクトを介して渡す必要があります。- 画像資産、データ資産、イベント トラッカーを含めます。
- これらのアセットは、最初に登録したクリエイティブ アセットの代わりに機能します。
入札応答の入札オブジェクト
- 他の入札応答オブジェクトはここに一覧表示されません。 詳細については、 入札応答に関するドキュメントを参照してください。
- 入札者は、標準の OpenRTB
seatbid.bid.admフィールドで広告マークアップを送信する必要があります。 - 登録したクリエイティブ ID は、次のいずれかの入札応答フィールド (
adid、crid) に含める必要があります。 -
cridまたはadidの値は、対応するブランドのクリエイティブ オブジェクトと一致する必要があります。
入札応答フィールド
| フィールド | 種類 | 説明 |
|---|---|---|
adm |
string | 入札が勝利した場合に広告マークアップを伝える手段。は、両方にマークアップが含まれている場合、win 通知よりも優先されます。 形式は JSON でエンコードされた文字列にする必要があります。 |
adomain |
string |
必須: 入札応答で送信された adm コンテンツのブランドを表す URL。 |
adid |
string | 登録されている収益化クリエイティブ ID。 クリエイティブ サービスを使用して API を介して表示できます。 |
crid |
string | 入札者のシステムからのクリエイティブ ID。
クリエイティブ サービスを介して設定されたクリエイティブ コードに基づいて収益化クリエイティブを参照するために使用されます。 注: 両方の値が送信される場合、 adid は cridよりも優先され、 crid は無視されます。 |
ADM オブジェクト
| フィールド | 種類 | 説明 |
|---|---|---|
assets |
オブジェクトの配列 | 必須: ネイティブ広告のアセットの一覧。 以下の「Asset Object」を参照してください。 |
link |
object | 必須: ネイティブ広告の既定の宛先リンク。 個々のアセットには、独自のリンク オブジェクトを含めることができます。 アセット リンクにリンク オブジェクトがない場合は、親リンク オブジェクトが使用されます。 以下の「リンク オブジェクト」を参照してください。 |
eventtrackers |
オブジェクトの配列 | 追跡オブジェクトの配列。 「イベント トラッカー応答オブジェクト」を参照してください。 |
privacy |
string | 要求でサポートが示された場合は、購入者のターゲティング アクティビティについてユーザーに通知するページの URL。 |
ext |
object | OpenRTB 入札応答に対する収益化固有の拡張機能を識別するために使用されます。 |
ver |
string | ネイティブ バージョン。
1.2のみがサポートされています。 |
イベント トラッカー応答オブジェクト
| フィールド | 種類 | 説明 |
|---|---|---|
event |
integer | 追跡するイベントの種類。サポートされている型: 1. インプレッション – インプレッション トラッキング 2. Viewable-mrc50 – MRC 定義を使用した表示インプレッション (1 秒間のビューの 50%) 3. Viewable-mrc100 – 1 秒間 100% 表示 4. Viewable-video50 – MRC 定義を使用したビデオの表示インプレッション (50% 2 秒間表示) |
method |
integer | 要求された追跡の種類: 1. img – 画像ピクセル追跡 (指定された URL は、イベントの時点で 1x1 ピクセルとして挿入されます)2. js – JavaScript ベースの追跡 (指定された URL はイベントの時点で JS タグとして挿入されます) |
url |
string | イメージまたは JS トラッカーの URL。 このフィールドでは、次の OpenRTB マクロがサポートされています。 - ${AUCTION_ID} – auction_id_64を収益化します。 - ${AUCTION_BID_ID} – 入札応答の [ bidid ] フィールドで指定された入札の ID。 - ${AUCTION_IMP_ID}– インプレッションの ID。seatbid オブジェクトの bid オブジェクトのimpid フィールドから。 - ${AUCTION_SEAT_ID}– seatbidオブジェクトのseatフィールドからの当選席の ID。 - ${AUCTION_AD_ID} – 購入者のクリエイティブの ID。シートビッド オブジェクトの bid オブジェクトの adid フィールドから。 - ${AUCTION_CURRENCY} – 入札応答の [ cur ] フィールドで指定された決済価格の通貨。 |
ネイティブ ext オブジェクト
収益化では、収益化固有の拡張機能に対して 1 つのネイティブ ext オブジェクトがサポートされます。
フィールド定義
| フィールド | 種類 | 説明 |
|---|---|---|
appnexus |
object | OpenRTB 入札応答に対する収益化固有 (旧称 AppNexus) 拡張機能を指定します。 |
Asset オブジェクト
収益化では、次のフィールドをサポートして、1 つ以上のネイティブアセット オブジェクトを定義します。これは、bid オブジェクトの adm フィールドに JSON でエンコードされた文字列として含まれます。
フィールド定義
| フィールド | 種類 | 説明 |
|---|---|---|
id |
integer | 必須: 一意の資産 ID。 要求の資産 ID と一致する必要があります。 |
required |
integer | 入札者がアセットを表示する必要がある場合は、 1 に設定します。 |
title |
object | タイトル アセットのタイトル オブジェクト。 以下の 「Title オブジェクト」を参照してください。 |
img |
object | イメージ アセットのイメージ オブジェクト。 以下の 「Image オブジェクト」を 参照してください。 |
data |
object | 評価や価格などのデータ資産のデータ オブジェクト。 以下の 「データ オブジェクト」を 参照してください。 |
Title オブジェクト
ネイティブ adm オブジェクトのタイトル アセットを定義します。
| フィールド | 種類 | 説明 |
|---|---|---|
text |
string | 必須: title 要素のテキスト。 |
len |
integer | 指定されているタイトルの長さ。 |
画像オブジェクト
| フィールド | 種類 | 説明 |
|---|---|---|
url |
string | 必須: イメージ資産の URL。 |
w |
integer | 推奨: イメージの幅 (ピクセル単位)。 |
h |
integer | 推奨: イメージの高さ (ピクセル単位)。 |
ext |
object | OpenRTB 入札応答に対する収益化固有の拡張機能を識別するために使用されます。 |
イメージ ext オブジェクト
収益化では、収益化固有 (旧称 AppNexus) 拡張機能の 1 つのネイティブ ext オブジェクトがサポートされています。
フィールド定義
| フィールド | 種類 | 説明 |
|---|---|---|
appnexus |
object | OpenRTB 入札応答に対する収益化固有 (旧称 AppNexus) 拡張機能を指定します。 |
AppNexus オブジェクト ext イメージ
収益化では、 appnexus 拡張オブジェクトの次のフィールドがサポートされています。
| フィールド | 種類 | 説明 |
|---|---|---|
prevent_crop |
ブール値 | 購入者は、イメージをトリミングできるかどうかを指定できます。 注: これはアイコンとメインイメージに適用できます。 - 1に設定すると、イメージをトリミング (塗りつぶし) することはできません 。- 0に設定すると、画像をトリミング (フィット) できます 。 - フラグが pr で渡されない場合、 既定の動作: 0。 特に明記されていない限り、イメージは変更を許可するものと見なされます。 |
データ オブジェクト
IAB OpenRTB Native Ads Specification 1.2 で見つかったすべてのデータ資産の種類がサポートされています。
Link オブジェクト
ネイティブ資産のリンクを定義します。 クリックすると、ユーザーは指定した URL に転送されます。 このオブジェクトは、親 adm オブジェクトでのみ定義できます。
フィールド定義
| フィールド | 種類 | 説明 |
|---|---|---|
url |
string | (必須) クリック可能なリンクのランディング URL。 マクロはサポートされていません。 |
clicktrackers |
文字列の配列 | リンクがクリックされたときにトリガーされるサード パーティの追跡 URL の配列。 |
fallback |
string | プライマリ URL がデバイスでサポートされていない場合のフォールバック URL。 |
カスタム マクロ
有効な入札者が広告マークアップを送信すると、 seatbid.bid.ext.appnexus.custom_macros 拡張フィールドは無視されます。
- [
admarkup] フィールドがまったく返されない場合、登録されたクリエイティブ コンテンツは既定で配信されます。 この場合、seatbid.bid.ext.appnexus.custom_macrosは通常どおりサポートされます。
フィールド定義
| フィールド | 種類 | 説明 |
|---|---|---|
custom_macros |
オブジェクトの配列 | カスタム マクロ オブジェクトを識別します。 |
入札応答の例
{
"seatbid": [
{
"bid": [
{
"nurl": "https://rtb-fakeurl.com/lax/wintrk=CwE&wp=${AUCTION_PRICE}&curr=${AUCTION_CURRENCY}&aid=${AUCTION_AD_ID}",
"adid": "12345",
"crid": "test_code",
"price": 2.50,
"adm": {
"link": {
"url": "https://rtb-fakeurl.com"
},
"ver": "1.2",
"assets": [
{
"id": 1,
"img": {
"w": 1200,
"h": 627,
"url": "https://rtb-fake-image-url.com",
"ext": {
"appnexus": {
"prevent_crop": 1
}
}
}
},
{
"id": 2,
"title": {
"text": "AD"
}
},
{
"id": 3,
"data": {
"value": "abc.com"
}
}
],
"privacy": "https://rtb-fake-privacy-url.com",
"eventtrackers": [
{
"event": 1,
"method": 1,
"url": "https://rtb-fakeurl.com/price=${AUCTION_PRICE}"
}
]
},
"impid": "3226285750417000001",
"id": "6ab34155-c960-1111-abcd-52b7321adbbb"
}
],
"seat": "123"
}
],
"id": "3",
"cur": "USD"
}
サーバー側のインプレッショントラッキング
ネイティブ ADM を使用する入札者の場合は、seatbid.bid.nurlで win 通知 URL を送信します。 入札者は、この URL に ${PRICE_PAID} または ${AUCTION_PRICE} マクロを含め、Win 価格情報を受け取ることが予想されます。
フィールド定義
| フィールド | 種類 | 説明 |
|---|---|---|
nurl / burl |
integer | Win 通知 URL。Web ブラウザーまたは SDK にピクセルとしてドロップされます。 サーバーは、デバイスからクライアント側の通知を受け取ると、この URL に ping を実行し、オークションに落札したことを示します。 応答はサーバー側で送信されます。 これは、インプレッションを記録している間に同時に発生します。 最大長は、マクロが展開された 2000 文字です。 ネイティブ admを使用する入札者の場合、入札者は、この URL に ${PRICE_PAID} または ${AUCTION_PRICE} マクロを含めて、Win 価格情報を受け取ることが予想されます。 |
追跡マクロ
一部のパブリッシャーは、クリエイティブを定期的に監査します。これにより、誤ったインプレッションが生成され、クリックトラッキング イベントが発生する可能性があります。 Microsoft が監査イベントを検出した場合:
-
admの URL でエンコードされた${AUCTION_PRICE}マクロは、文字列"AUDIT"に展開されます。 - URL でエンコードされた
${AN_IS_AUDIT}マクロは、1に展開されます。
次のマクロでは、インプレッションとクリックの追跡がサポートされています。 使用の詳細については、以下の ADM マクロの例を参照してください。
マクロ参照
| マクロ | 説明 |
|---|---|
${AN_IMP_URL} |
Microsoft インプレッショントラッキング URL に拡張され、入札者のインプレッショントラッキングピクセルの前に追加することを目的としています。 広告がレンダリングされると、展開された URL が入札者のピクセルにリダイレクトされ、 ${AUCTION_PRICE} マクロが正しく展開されます。 bidder のピクセル内のすべてのマクロは、 admで URL エンコードされている必要があります。 |
${AN_CLICK_URL} |
Microsoft のクリック追跡 URL に展開され、入札者のクリック追跡ピクセルの前に追加することを目的としています。 広告がクリックされると、展開された URL が入札者のピクセルにリダイレクトされ、 ${AUCTION_PRICE} マクロが正しく展開されます。 入札者のピクセルと ${AUCTION_PRICE} は、 admで URL エンコードされている必要があります。 |
${AN_IS_AUDIT} |
監査イベント (インプレッションとクリック) が発生したときに 1 に展開され、それ以外の場合は 0 に展開されます。
${AN_IMP_URL}または${AN_CLICK_URL}に続く URL に含まれる場合は、URL でエンコードする必要があります。 |
${AUCTION_ID} |
オークション (auction_id_64) の一意識別子を表します。 |
${AUCTION_BID_ID} |
入札応答の [ bidid ] フィールドで指定された入札の一意識別子を表します。 |
${AUCTION_IMP_ID} |
seatbid オブジェクトの bid オブジェクトのimpid フィールドからのインプレッションの一意識別子を表します。 |
${AUCTION_SEAT_ID} |
seatbid オブジェクトのseat フィールドからの当選シートの一意識別子を表します。 |
${AUCTION_AD_ID} |
seatbid オブジェクトの bid オブジェクトのadid フィールドから購入者のクリエイティブの一意識別子を表します。 |
${AUCTION_PRICE} |
入札応答の [ cur ] フィールドで指定した通貨でのインプレッションのクリアリング価格を表します。 |
${AUCTION_PRICE:HMAC-SHA1-XOR} |
オークション価格の安全なバージョンを表します。 入札応答の [ cur ] フィールドで指定された通貨でのインプレッションの決済価格。 |
${AUCTION_CURRENCY} |
入札応答の [ cur ] フィールドで指定した決済価格の通貨を表します。 |
${CREATIVE_CODE} |
クリエイティブを登録するときに、API を使用してクリエイティブ オブジェクトに設定された code フィールドを表します。 |
${AN_PAYMENT_TYPE} |
入札応答の [ bid_payment_type ] フィールドで指定された、入札の支払いタイプの ID を表します。 |
${AUCTION_LOSS} |
オークションの損失理由コードを表します。 サポートされている損失理由コードの完全な一覧については、「 損失理由コード」を参照してください。 |
${AN_SOURCE_FD} |
最終的なインプレッション販売決定を担当するエンティティを表します。 - 0: Exchange (既定値)。 Microsoft 収益化は、最終的なオークションを開催します。- 1: アップストリーム ソース。 入札はヘッダー入札オークションまたは外部供給に渡されます。 |
エンコードと通知
すべての OpenRTB マクロは URL でエンコードする必要があります。 これらのマクロを使用するには、上記のようにピクセル単位で適切にエンコードされていることを確認します。
Microsoft では、サーバー側の win 通知の seatbid.bid.nurl と seatbid.bid.burl の両方がサポートされています。 これらは、それぞれの入札応答フィールドで送信する必要があります。
クリエイティブな例
この例では、4 つのデータ資産と 2 つの画像資産を使用しますが、登録する資産に応じて別の組み合わせを使用することもできます。 (各種類の少なくとも 1 つの資産が必要です。ネイティブ クリエイティブアセットの詳細については、 クリエイティブ サービスに関するページを参照してください。