HTTP-based API for Ad Implementing Introduction

Our platform provides a straightforward HTTP-based API for retrieving ad content, including banner webpage ads and offerwall ads. This method offers flexibility and full control over how ad content is fetched and displayed on your website or application.

The flowchart for the HTTP-based API ad content retrieval process:

API Endpoint

https://ads.datplatform.com/adx-dir-m/appads?aid=110036&adx_nid=7

Accessing the API

  • Send an HTTP GET request to the above URL.
  • The API returns a JSON response containing ad content and related information.

JSON Response Example

The JSON response contains all the necessary information to display banner ads or offerwall ads, including the ad markup, image URL, and click-through URL. Banner ads typically include an image and a link, while offerwall ads may include additional details about the offer and the reward associated with it.

{
    "id": "9b1afb9d-008f-4ee4-9966-8b42895105cb",
    "bidid": "",
    "cur": "USD",
    "network_mediation": [],
    "session_info": {
        "s_5": "-1",
        "s_4": "-1",
        "s_3": "-1",
        "s_2": "-1",
        "s_1": "-1"
    },
    "seatbid": [
        {
            "seat": "123",
            "bid": [
                {
                    "id": "1",
                    "impid": "1",
                    "price": null,
                    "adid": "1",
                    "nurl": "https://i.datplatform.com/adx-dir-d/view?ids=110038,12508,410025,310089,210000,108,2,12502,7,0&price=undefined,undefined&GUIDs=2e0dff06-f11b-47b6-83a3-1751f4e0dc56,9b1afb9d-008f-4ee4-9966-8b42895105cb,9b1afb9d-008f-4ee4-9966-8b42895105cb,&info=3,1,CN,WB&ta=1&cb=1749751891&vd=112.122.233.44,14,8&adx_custom=&adx_custom_ex=~~~-1&ds=,,&ref=http%3A%2F%2Fads.datplatform.com%2Fadx-dir-m%2Fappads",
                    "adm": "<A HREF=\"https://r.datplatform.com/adx-dir-d/click?qs=H4sIAAAAAAAAAw2RxxEAMAjDVqKXcQKB/UdIvr4DZOEptWPqLsl89ao547nGY9kq1aRwtSutlHeUDxCWNAdds1DxBsiC24QpNgm2EZMpwAtQdHivn407OKHzM/RhPjYFHgs3/+FZpw6Nw2E5FG187idbRt2fyNk9izoNrheYZmPKDHF1J83oGNEFIbDolOhgm5XggNQhJu/C0xtquOBoVa5aKwJhFWSYfVJmKFtu2oj+lsmkprkH7ab7Z7ih7OfqzJQqVCNMyd90jsii/J6feUvHTnYjD8Dy34EGFy5zdYbr90ii1KNWlFzTl86JSoxfA8XltlGIRRyVqfn2BQdQ+s/6vTA0Rg6evnA+G9bXT0f4F5RtGY+vqe78Z3hR1fA3zx86zVGVTOOjP279W9MAAgAA\" TARGET=\"_blank\"><img src=\"https://cdn.datplatform.com/7_310089_1.png\" height=\"50\" width=\"320\"></A>",
                    "iurl": "https://cdn.datplatform.com/7_310089_1.png",
                    "linkurl": "https://r.datplatform.com/adx-dir-d/click?lid=9b1afb9d-008f-4ee4-9966-8b42895105cb~410025~310089~210000~108~2~12502~12508~110038~7~nourl~CN~Direct~undefined~1~undefined~WB~0&adx_txn_id=9b1afb9d-008f-4ee4-9966-8b42895105cb&cb=1749751891&adx_custom=~~~&visi=wifi~~~~~~demo~~~&safeweb=undefined",
                    "beacon": "",
                    "adomain": [
                        "dat.network"
                    ],
                    "ext": {
                        "advertiser": "direct",
                        "agency": "direct",
                        "adwidth": "320",
                        "adheight": "50",
                        "adcat": "null",
                        "adtype": "2"
                    },
                    "cid": 410025,
                    "crid": 310089
                }
            ]
        }
    ]
}

Next Steps After Fetching the JSON

  1. Render the Ad: Use the adm field to render the ad on your webpage or application.
  2. Track Impressions: Send a request to the nurl to report an impression.
  3. Handle Clicks: Redirect users to the linkurl when they click on the ad.

🚀 For more information, custom ad solutions, or assistance with offerwall rendering development, feel free to contact our Business Team.

Scroll to Top