入札者 - 通貨サービス

警告

API通貨サービスは、Xandrプラットフォームを介した取引の結果としてクライアントが支払ったまたは受け取った金額を調整するためにのみ利用でき、クライアントが他の目的で使用することはできません。

これは、使用するライン アイテムまたは広告掲載オーダーを設定できる通貨のリストを表示する読み取り専用サービスです。

購入側の Open RTB をビッダーにする場合、送信入札要求で USD 以外の通貨を入札者に送信し、応答で他の通貨を受け入れることができます。 入札者が入札通貨を変更するには、 "cur" フィールドを送信する必要があります。 "cur" フィールドが指定されていない場合は、既定で USD になります。 入札者は、既定の通貨で設定されている値に関係なく、任意の通貨で応答できます。 [ "cur" ] フィールドに通貨を指定するだけでよく、追加の有効化は必要ありません。

sell side Open RTB の場合、既定では USD が通貨として使用され、 "cur" フィールドは無視されます。 販売者メンバーが明示的に設定された seller_bid_currency のメンバー資格を持っている場合、入札要求の "cur" フィールドが尊重されます。

為替レートは、1 日 1 回午前 3:00 頃 (UTC) にリフィニティブから取得されます。

REST API

HTTP メソッド エンドポイント 説明
GET https://api.appnexus.com/currency 使用可能なすべての通貨を表示
GET https://api.appnexus.com/currency?code=CURRENCY_CODE 特定の通貨を表示する
GET https://api.appnexus.com/currency?code=CURRENCY_CODE&show_rate=true 今日の通貨の為替レートを表示する
GET https://api.appnexus.com/currency?show_rate=true&code=CURRENCY_CODE&ymd=2012-03-01 過去 1 日の通貨の為替レートを表示する

JSON フィールド

フィールド 型 説明
as_of string Refinitiv が最後に為替レートを更新した日時 (UTC)。 毎日午前 3:00 UTC に Refinitiv からレートを取得します。 これは、クエリ文字列で show_rate=true を渡した場合にのみ返されます。
code string 通貨のコード。
description string 通貨の説明。
is_exposed ブール値 true の場合、通貨が表示されます。
last_modified string 通貨が最後に変更された日時。 ( 注 * を参照してください)
name string 通貨の完全な名前。
position 列挙 通貨記号が金額の前と後に表示されるかどうか。 使用可能な値: "before" または "after"。
rate_per_usd double 為替レート。 これは、クエリ文字列で show_rate=true を渡した場合にのみ返されます。
symbol string 通貨の記号 (例: 米国ドルの場合は "$"

コンバージョン率を表示するには、URL で show_rate=true を渡します。 また、URL 経由で ymd=YYYYMMDD を渡すことで、過去 1 日のレートを取得することもできます。

注:

*通貨 API (例: rate_per_usd) をクエリする場合、サービスは現在、 last_modified を除き、すべての正しい値を返しています。 実際の為替レートは正確で、API は更新された為替レートを返しています。 現在、返される為替レートのバージョンを知るには、last_modifiedではなく as_of 列が使用されています。

例

使用可能なすべての通貨を表示

curl -b cookies -c cookies 'https://api.adnxs.com/currency'
{
    "response": {
        "status": "OK",
        "currencies": [
            {
                "code": "ARS",
                "symbol": "₱",
                "name": "Argentine Peso (ARS)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-16 23:07:23",
                "is_exposed": true
            },
            {
                "code": "AUD",
                "symbol": "AUD$",
                "name": "Australian Dollar (AUD)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-24 19:29:04",
                "is_exposed": true
            },
            {
                "code": "BRL",
                "symbol": "R$",
                "name": "Brazilian Real (BRL)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-16 23:07:23",
                "is_exposed": true
            }
                        ...
        ],
        "count": 17,
        "start_element": null,
        "num_elements": null
    }
}

2020 年 3 月 1 日の EUR 為替レートを表示する

$ curl -b cookies -c cookies  'https://api.adnxs.com/currency?show_rate=true&code=EUR&ymd=2020-03-01'
{
    "response": {
        "status": "OK",
        "currency": {
            "code": "EUR",
            "symbol": "€",
            "name": "Euro (EUR)",
            "description": null,
            "position": "before",
            "last_modified": "2020-02-16 23:07:23",
            "rate_per_usd": 0.7506,
            "as_of": "2020-03-01 11:24:00",
            "is_exposed": true
        },
        "count": 1,
        "start_element": null,
        "num_elements": null
    }
}
  • Last updated on