Deeplink Protocol

1. Overview

Deeplink is a specialized hyperlink that directs users to a specific screen or piece of content deep within a mobile application. Demand-Side Platforms (DSPs) strategically use deeplinks in e-commerce campaigns to dramatically boost user engagement by creating a seamless customer journey. For instance, when a user clicks on an ad for a specific product, a deeplink transports them directly to that product's page inside the retailer's app. This experience reduces user drop-off and significantly shortens the path to purchase.

2. Bid Request Params

As part of our Bid request, we added the flags for deeplink and fallback to signal that we support both parameters.

Request fieldTypeValueRequiredDescription
imp.ext.deeplinkint1 or 0Yes1 = support deeplink
0 = no support deeplink
imp.ext.fallbackint1 or 0Yes1 = support fallback
0 = no support fallback

Bid Request Sample:

"ext":
{    
  "deeplink": 1,
  "fallback": 1
}

3. Ad Response Params

Both Deeplink and Fallback URLs must be sent as string inside the bid.ext object:

Response fieldTypeDescription
seatbid.bid.ext.deeplinkstringdeeplink url
seatbid.bid.ext.fallbackstringfallback url

📘

Important Note

Both deeplink and fallback params are mandatory for Deeplink to work properly; if any of these fields are missing, the Deeplink workflow will not work

Ad Response Sample:

"seatbid": [
  {
    "bid": [
      {
        "ext": {
          "deeplink": "deeplinkURL",
          "fallback": "fallbackURL"
        }
      }
    ]
  }
]