落札通知マクロ

DSP
Last Updated: 4月 23, 2026•

DSPはBid objectのadmまたはburlフィールドに、${AUCTION_PRICE}落札通知マクロおよびオプションで${SUPPLY_FEE}マクロを含める必要があります。落札通知マクロのない入札は拒否されます。オークションで落札し、クリエイティブがユーザーに提供された場合にのみマクロが置き換えられます。

Index Exchange (Index) に送信するクリエイティブに以下の落札通知マクロを含めます。

マクロ範囲詳細

${AUCTION_PRICE}

必須

広告インプレッションの落札価格（単位：米ドル）。

${SUPPLY_FEE}

オプション

The revenue share percentage (%) that Index takes as margin from the buyer's bid.
個別の取引に対するIndexの収益シェアをリアルタイムで受け取るために、${SUPPLY_FEE}マクロを含めます。例えば、5%のシェアの場合、値は「5.0」になります。デフォルトでは、このマクロは、全てのDSPに対して無効となっています。有効にするには、Index担当者にお問い合わせください。

Note: If the seller does not allow fee disclosure, Index will not substitute the ${SUPPLY_FEE} macro with the Index revenue share and will return an empty macro.

DSPがオークションで落札をする場合、落札通知マクロが評価され、広告マークアップまたはburlがブラウザ、動画プレーヤー、または広告SDKによって消費される際に入札価格がDSPに送信されます。If the Media Owner supports OMID, the burl is sent to the DSP when at least one pixel of the mobile app banner is painted into the device's viewport. If the Media Owner allows fee disclosure and the ${SUPPLY_FEE} macro is included, the Index revenue share for that transaction is also provided. 詳細については、落札通知の例を参照してください。

清算価格の暗号化

Some Media Owners require that any pricing information that is visible on the page to be encrypted. We support encryption of the clear price embedded in DSP win notifications using Google's encryption algorithm, HMAC_SHA1.

入札レスポンス

暗号化に対応するには、OpenRTB標準を以下のフォーマットで使用して、IEXなどのカスタムサフィックスを入札レスポンスの清算価格通知マクロに追加する必要があります。

price=${AUCTION_PRICE:IEX}

Indexは、清算価格の暗号化に対応するよう、全てのDSPパートナーに推奨します。これに対応しない入札レスポンスは、パブリッシャーが暗号化を求めるすべてのオークションから除外されます。

落札通知

Use Google's algorithm to decrypt an encrypted clear price. 詳細は、Googleの認証されたバイヤー向け料金の確認の復号をご確認ください。Indexが、HEXエンコード暗号化とインテグリティキー（32バイト）を提供します。明確な価格を復号化するには、キーをHEXで復号する必要があります。復号化された価格は、マイクロ単位のUSDで表示されます。以下の復号化出力の例を参照してください。

Integrity Key: ed81b2e9466ec5fa4f1384272f634a0cb5262d2085e3b5262810eabc96051537
Value to Decode: Vs3pLAAAAADhyo6uRlLOWOL_BrmQYsSx-Uinbw
Decoded Value: 4534896 micro dollars = 4.534896 dollars

DSPには、各広告インプレッションが提供された後に落札（およびその結果）が通知されます。

クリエイティブのテストと監査に関するシグナル

Index Exchangeの広告品質基準の一環として、Indexはクリエイティブが当社のエクスチェンジ基準を満たしていることを確認するために、定期的にテストおよび監査を実施します。この期間、Indexはインプレッションをカウントせず、クリエイティブがテストまたは監査中であることをDSPに通知します。

OpenRTB 2.6仕様書における Substitution Macrosの規定に基づき、Indexは DSP から提供されたadm またはburl内の${AUCTION_PRICE}マクロを「"0.00"」または「"AUDIT"」などのカスタムバリューに置換し、当該クリエイティブがテストまたは監査の対象であることを示します。カスタムバリューの詳細は、Index担当者までお問い合わせください。

If a DSP has price encryption enabled with Index, the value "0.00" is replaced with its encrypted equivalent to maintain compatibility with the DSP's decryption process. カスタムバリューは、暗号化されません。