SP からの入札要求の受信

実装

エンドポイント

入札要求に使用できる 1 つ以上のエンドポイントを POST 受け取ります。 エンドポイントを受信するには、Xandr の担当者に問い合わせてください。 一般に、エンドポイントは次のようになります。

https://seller-region.adnxs.com/openrtb2?member_id=YOUR_MEMBER_ID

• member_id が必要です。これは Xandr プラットフォームのメンバー ID です。 この ID は、統合中に Xandr によって提供されます。
• 運用しているリージョンごとに 1 つのエンドポイントを受け取ります。 使用可能なリージョンは、 us-east、 us-west、 emea、および apacです。

その他のクエリ文字列値は無視されます。

Bid 要求オブジェクト

Xandr では、最上位レベルの入札要求オブジェクトの次のフィールドがサポートされています。

Bid request 拡張機能オブジェクト

Xandr は、Xandr 固有の拡張とサプライ チェーンシグナルをサポートするために、オブジェクト内 ext の次のオブジェクトをサポートします。

Xandr オブジェクト

Xandr では、拡張オブジェクトの次のフィールドが appnexus サポートされています。

Schain オブジェクト

Xandr では、(Supply Chain) オブジェクトの次のフィールドが schain サポートされています。

Impression オブジェクト

Xandr では、オブジェクト内の次のフィールドが imp サポートされています。これは、オークションされるインプレッションを表します。 1 つの入札要求に、複数 imp のオブジェクトを含む配列が含まれる場合があります。

インプレッション拡張オブジェクト

Xandr は、Xandr 固有の拡張機能を impression サポートするために、オブジェクトの ext オブジェクト内の 1 つのオブジェクトをサポートします。

Xandr オブジェクト

Xandr では、拡張オブジェクトで次のフィールドが appnexus サポートされています。

バナー オブジェクト

バナーインプレッションの場合、Xandr は次のフィールドをサポートします。

Format オブジェクト

Xandr では、 オブジェクトの オブジェクトで format 次のフィールドが banner サポートされています。

Video オブジェクト

ビデオインプレッションの場合、Xandr は次のフィールドをサポートします。

ビデオ拡張オブジェクト

Xandr は、Xandr 固有の拡張機能を video サポートするために、オブジェクトの ext オブジェクト内の 1 つのオブジェクトをサポートします。

Xandr オブジェクト

Xandr では、拡張オブジェクトで次のフィールドが appnexus サポートされています。

Audio オブジェクト

ネイティブ オブジェクト

ネイティブ インプレッションの場合、Xandr では次のフィールドがサポートされます。

request

型: 文字列
説明: 配信されるレンダリングされたクリエイティブ マークアップ。ネイティブ クリエイティブは、このフィールドで JSON でエンコードされた文字列として返すことができます。

ネイティブ 1.0 の例:

"native": {
        "request": "{\"native\":{\"ver\":\"1.0\",\"assets\":[{\"id\":3}}]}"
}

ネイティブ 1.1 の例:

"native": {
        "request": "{\"ver\":\"1.1\",\"assets\":[{\"id\":3}}]}"
}

ネイティブ 1.2 の例:

"native": {
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":3}}]}"
}

ver

型: 文字列
説明: 使用中のネイティブ マークアップ バージョンのバージョン。 Xandr では現在、次のネイティブ バージョンがサポートされています。

• 1.0
• 1.1
• 1.2

Request オブジェクト

Xandr では、 オブジェクト内の オブジェクト内の request 次のフィールドが native サポートされています。

Asset オブジェクト

Xandr では、オブジェクト内の 1 つ以上 asset のオブジェクトを定義するために、次のフィールドが native サポートされています。

Title オブジェクト

Xandr では、 オブジェクト内の オブジェクト内の title 次のフィールドが assets サポートされています。

画像オブジェクト

Xandr では、 オブジェクトの オブジェクトで img 次のフィールドが assets サポートされています。

Assets データ オブジェクト

Xandr では、 オブジェクトの オブジェクトで data 次のフィールドが assets サポートされています。

Video オブジェクト (assets オブジェクト)

Xandr では、 オブジェクトの オブジェクトで video 次のフィールドが assets サポートされています。

プライベート マーケットプレース オブジェクト

Xandr は、このインプレッションに適用される可能性がある買い手と売り手の間のimpプライベート マーケットプレース (取引) をサポートするために、オブジェクトのオブジェクト内pmpの次のフィールドをサポートします。

Deal オブジェクト

Xandr では、 オブジェクトの オブジェクトで deal 次のフィールドが pmp サポートされています。

Site オブジェクト

Xandr では、 オブジェクト内の次のフィールドが site サポートされています。

アプリ オブジェクト

Xandr では、 オブジェクト内の次のフィールドが app サポートされています。

Publisher オブジェクト

Xandr では、 オブジェクトで次のフィールドが publisher サポートされています。

Content オブジェクト

Xandr では、Content オブジェクトの次のフィールドがサポートされています。

コンテンツ拡張オブジェクト

Xandr では、 オブジェクト内の次のフィールドが ext サポートされています。

Xandr は、コンテンツ オブジェクトの appnexus 拡張オブジェクトの次のフィールドをサポートします

Device オブジェクト

Xandr では、 オブジェクト内の次のフィールドが device サポートされています。 このオブジェクトのデバイス ID は、 Bid Request Extension オブジェクト内のすべてのデバイス ID をオーバーライドする必要があることに注意してください。

ユーザー オブジェクト

Xandr では、 オブジェクト内の次のフィールドが user サポートされています。

eid オブジェクト

Geo オブジェクト

Xandr では、 オブジェクト内の次のフィールドが geo サポートされています。

ユーザー拡張オブジェクト

Xandr では、 オブジェクトで次のフィールドが user.ext サポートされています。

Regs オブジェクト

Xandr では、regs オブジェクトで次のフィールドがサポートされています。

Regs 拡張オブジェクト

Xandr では、 オブジェクトで次のフィールドが regs.ext サポートされています。

入札要求の例

バナー入札要求

{
    "id": "3456789098765432",
    "imp": [{
        "banner": {
            "h": 200,
            "w": 750
        },
        "bidfloor": 0.0779016539,
        "bidfloorcur": "USD",
        "id": "a5974205-4a2d-43e1-b346-693b0dad1372",
        "pmp": {
            "deals": [{
                "bidfloor": 1.03868878,
                "bidfloorcur": "USD",
                "id": "123456789"
            }],
            "private_auction": 1
        }
    }, {
        "banner": {
            "h": 300,
            "w": 750
        },
        "bidfloor": 0.0779016539,
        "bidfloorcur": "USD",
        "id": "5a123e7a-e72e-4503-912e-03fdad931da4",
        "pmp": {
            "deals": [{
                "bidfloor": 1.03868878,
                "bidfloorcur": "USD",
                "id": "654321234"
                ]
            }],
            "private_auction": 1
        }
    }, {
        "banner": {
            "h": 60,
            "w": 468
        },
        "bidfloor": 0.0779016539,
        "bidfloorcur": "USD",
        "id": "912308dd-6643-4bfd-8ff6-4b14f8799dad",
        "pmp": {
            "deals": [{
                "bidfloor": 1.03868878,
                "bidfloorcur": "USD",
                "id": "432123456"
            }],
            "private_auction": 1
        }
    }, {
        "banner": {
            "h": 250,
            "w": 970
        },
        "bidfloor": 0.0779016539,
        "bidfloorcur": "USD",
        "id": "1123c57b-464e-4b6d-87ce-89f501dadfb9",
        "pmp": {
            "deals": [{
                "bidfloor": 1.03868878,
                "bidfloorcur": "USD",
                "id": "543234567"
            }],
            "private_auction": 1
        }
    }],
    "site": {
        "domain": "https://example.com",
        "id": "456789",
        "name": "example.com",
        "page": "https://example.com/example",
        "publisher": {
            "id": "123",
            "name": "mypublisher"
        }
    },
    "user": {
        "id": "6543212345654"
    },
    "bcat": [
        "IAB24",
        "IAB26"
    ],
    "cur": [
        "USD"
    ],
    "device": {
        "devicetype": 2,
        "ext": {
            "is_app": 0
        },
        "ip": "198.51.100.1",
        "language": "pl",
        "ua": "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:41.0) Gecko/20100101 Firefox/41.0"
    }
}

ビデオ入札要求

{
    "id": "951_1470171234556050-40",
    "imp": [{
        "bidfloor": 13.768,
        "bidfloorcur": "USD",
        "displaymanager": "DisplayManager",
        "displaymanagerver": "1.0",
        "id": "1",
        "pmp": {
            "deals": [{
                "bidfloor": 4.3506,
                "bidfloorcur": "USD",
                "id": "STI-VER-00004"
            }],
            "private_auction": 0
        },
        "secure": 0,
        "video": {
            "api": [
                1,
                2
            ],
            "ext": {
                "sticky_viewability_score": 10
            },
            "h": 250,
            "maxduration": 3600,
            "mimes": [
                "video/mp4",
                "video/x-flv",
                "application/x-shockwave-flash",
                "application/javascript"
            ],
            "minduration": 0,
            "playbackmethod": [
                1
            ],
            "protocol": 2,
            "protocols": [
                2,
                5
            ],
            "startdelay": 0,
            "w": 300
        }
    }],
    "badv": [
        "example.com",
        "example2.com"
    ],
    "cur": [
        "EUR",
        "JPY",
        "USD",
        "AUD",
        "GBP"
    ],
    "device": {
        "devicetype": 2,
        "ip": "198.51.100.10",
        "ipv6": "::ffff:198.51.100.10",
        "language": "en",
        "os": "windows",
        "ua": "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36"
    },
    "site": {
        "cat": [
            "IAB1"
        ],
        "domain": "example.com",
        "id": "456789",
        "page": "https://www.example.com/example-page",
        "publisher": {
            "id": "123"
        }
    },
    "user": {
        "buyeruid": "87654332122234",
        "id": "5123dab34d2fe47f225b2fd8dad97ec"
    }
}

ネイティブ 1.1 入札要求

{
    "id": "333a8888abcd47e98cb69de19999egad",
    "imp": [{
        "id": "1",
        "native": {
            "request": "{\"ver\":\"1.1\",\"context\":1,\"contextsubtype\":10,\"plcmttype\":11,\"plcmtcnt\":1,\"assets\":[{\"id\":1,\"required\":1,\"video\":{\"minduration\":10,\"maxduration\":60,\"protocols\": [2],\"mimes\":[\"video/mp4\"]}},{\"id\":2,\"required\":0,\"title\":{\"len\":140}},{\"id\":3,\"required\":1,\"img\":{\"w\":428,\"h\":240,\"type\":3}}]}",
            "ver": "1.1"
        },
        "tagid": "PC1111IAG0.0000011ABC"
    }],
    "app": {
        "domain": "dashboard.example.com",
        "bundle": "bundle1.example.dashboard"
    },
    "device": {
        "ua": "XBoxSAS/1",
        "ip": "126.149.60.85",
        "language": "us"
    },
    "user": {
        "id": "1234567899B74ABCDEFB783E2BE0987653DF70D0"
    },
    "ext": {
        "appnexus": {
            "ext_inv_code": "100"
        }
    }
}

モバイル入札要求

{
    "id": "05FD4E3A-BFCB-4E5E-8D63-14DB77250C32",
    "imp": [
        {
            "id": "1",
            "tagid": "987654",
            "banner": {
                "w": 300,
                "h": 250,
                "pos": 3,
                "topframe": 1,
                "battr": [
                    12,
                    44
                ]
            }
        }
    ],
    "app": {
        "id": "2490165635",
        "name": "GO Keyboard - Emoji, Wallpaper",
        "bundle": "com.jb.gokeyboard",
        "domain": "https://play.google.com",
        "cat": [
            "IAB3"
        ],
        "publisher": {
            "id": "123456"
        }
    },
    "device": {
        "ip": "27.55.84.146",
        "lmt": 0,
        "ua": "Mozilla/5.0 (Linux; Android 4.4.2; Z520 Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/30.0.0.0 Mobile Safari/537.36",
        "carrier": "Truemove",
        "language": "th",
        "make": "Acer",
        "model": "Z520",
        "os": "Android",
        "osv": "4.4",
        "js": 1,
        "devicetype": 1,
        "ifa": "528b4158-67d6-475d-b29f-6d62c8adbbce"
    },
    "user": {
        "id": "389FB549-4D41-456D-AA3C-5AF980683652"
    },
    "bcat": [
        "IAB7-45",
        "IAB7-31",
        "IAB26",
        "IAB7-30",
        "IAB25",
        "IAB23",
        "IAB7-39"
    ]
}

アウトストリーム入札要求

{
    "site": {
        "domain": "https://example.com",
        "page": "https://www.example.com/movies",
        "id": "ChTqkJcUbhNNTW4RPYdWYALE",
        "publisher": {
            "id": "654321"
        },
        "content": {
            "language": "en"
        },
        "cat": [
            "IAB1",
            "IAB24"
        ]
    },
    "id": "6fb5623c-f88e-462f-b679-a902db6deff4",
    "imp": [
        {
            "native": {
                "plcmtcnt": 1,
                "request": "{\"native\":{\"plcmtcnt\":1,\"assets\":[{\"id\":4,\"required\":0,\"img\":{\"hmin\":315,\"wmin\":600,\"type\":3}},{\"id\":3,\"required\":0,\"img\":{\"hmin\":48,\"wmin\":48,\"type\":2}},{\"id\":11,\"required\":0,\"data\":{\"len\":2000,\"type\":501}},{\"id\":12,\"required\":0,\"data\":{\"len\":2000,\"type\":502}},{\"id\":1,\"required\":1,\"title\":{\"len\":90}},{\"id\":2,\"required\":1,\"img\":{\"hmin\":0,\"wmin\":0,\"type\":1}},{\"id\":5,\"required\":1,\"data\":{\"len\":140,\"type\":1}},{\"id\":6,\"required\":1,\"data\":{\"len\":200,\"type\":2}}],\"adunit\":2,\"ver\":\"1.0\",\"layout\":3}}",
                "adunit": 2,
                "ver": "1.0",
                "layout": 3
            },
            "id": "1",
            "bidfloor": 1.01,
            "video": {
                "protocols": [
                    2,
                    3,
                    7
                ],
                "playbackmethod": [
                    2
                ],
                "minduration": 3,
                "ext": {
                    "appnexus": {
                        "context": 4
                    }
                },
                "maxduration": 300,
                "h": 250,
                "w": 300,
                "mimes": [
                    "video/mp4"
                ]
            },
            "secure": 0
        }
    ],
    "user": {
        "buyeruid": "2905333698551584116"
    },
    "device": {
        "connectiontype": 0,
        "devicetype": 4,
        "ip": "101.177.51.245",
        "model": "SM-G920I",
        "ua": "Mozilla/5.0 (Linux; Android 6.0.1; SM-G920I Build/MMB29K; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/57.0.2987.132 Mobile Safari/537.36 [FB_IAB/FB4A;FBAV/116.0.0.17.69;]",
        "os": "Android",
        "osv": "4",
        "language": "en",
        "make": "Samsung",
        "js": 1,
        "dnt": 0
    }
}