OpenRTB Integration

This guide describes how to send OpenRTB requests using the PixFuture exchange.

1. OpenRTB Endpoint

All OpenRTB requests should be sent to the following endpoint:

https://exchange.pixfuture.com/openrtb?pix_id=...

Replace ... with the pix_id provided to you by PixFuture.

For example:

https://exchange.pixfuture.com/openrtb?pix_id=12345

2. HTTP Request

Send the OpenRTB payload as a POST request with the Content-Type header set to application/json.

POST https://exchange.pixfuture.com/openrtb?pix_id=YOUR_PIX_ID Content-Type: application/json

3. Example OpenRTB Payload

The following is an example of an OpenRTB request for an App placement:

{ "id": "omid-test-request-001", "at": 1, "tmax": 1000, "cur": ["USD"], "imp": [ { "id": "imp-001", "instl": 1, "tagid": "omid-test-placement", "bidfloor": 0.01, "bidfloorcur": "USD", "secure": 1, "banner": { "w": 320, "h": 50 }, "ext": { "prebid": { "bidder": {} } } } ], "app": { "id": "com.example.omidtest", "name": "OMID Test App", "bundle": "com.example.omidtest", "domain": "example.com", "storeurl": "https://play.google.com/store/apps/details?id=com.example.omidtest", "publisher": { "id": "publisher-001", "name": "Test Publisher" } }, "device": { "ua": "Mozilla/5.0 (Linux; Android 13)", "ip": "203.0.113.10", "devicetype": 1, "os": "Android", "osv": "13", "make": "Google", "model": "Pixel 7", "ifa": "00000000-0000-0000-0000-000000000001", "geo": { "country": "GBR" } }, "user": { "id": "test-user-001" }, "regs": { "coppa": 0, "ext": { "gdpr": 0, "us_privacy": "1---" } }, "source": { "fd": 1, "tid": "omid-transaction-001", "omidpn": "Unity3d", "omidpv": "1.3.0" }, "test": 0 }

4. Important Parameters

5. Request Example

For example, if your PixFuture identifier is 123456, the request URL would be:

https://exchange.pixfuture.com/openrtb?pix_id=123456

The request should be sent using HTTP POST with the JSON payload in the request body.

6. Summary

1. Obtain your pix_id from PixFuture.
2. Send an HTTP POST request to https://exchange.pixfuture.com/openrtb?pix_id=YOUR_PIX_ID.
3. Replace YOUR_PIX_ID with the pix_id assigned to you.
4. Set Content-Type: application/json.
5. Send the OpenRTB request payload in the request body.