Handling Click Events in iOS

DT handles click event logic for video and display ads, as well as Custom Product Pages for iOS. Demand Partner feedback is highly encouraged. If you have any questions or recommendations, contact your DT Account Manager

Tracking Click Events with the SKAdNetwork

When a Demand Partner returns the BidResponse.seatbid.bid.ext.skadn object with a valid itunesitem attribute from a click, DT uses the iOS StoreKit controller to display the App's App Store product page. For more information about the specifications for the BidResponse.seatbid.bid.ext.skadn object, see the DT Exchange Open RTB Specs.

In parallel, the DT SDK iterates the click redirect chain until it reaches a final URL that leads to the App Store or a non-redirect URL, such as a browser link. The device user is unaware of any of the redirects and only sees the iOS StoreKit app content, which loads while the redirects occur in the background.

Tracking Click Events for VAST Video

DT uses the following VAST elements to track clicks:

• VAST Videos:

  • <ClickThrough>

  • <ClickTracking>

• VAST CompanionAds (including static, iFrame, and HTML end cards):

  • <CompanionClickThrough>

  • <CompanionClickTracking> (starting with VAST 3.0)

Tracking Click Events for Display Ads

Display Ad creatives may use various methods to send a click event to the DT SDK:

• For MRAID creatives, call mraid.open().

• For JavaScript creatives, call window.open() and update window.location.

• For HTML creatives, use a hyperlink such as <a href="https://someurl"></a>.

The following diagram shows how DT handles a click event from an MRAID Display Ad. DT uses the same flow to handle all Display Ad click events.

Handling Custom Product Pages

The DT Exchange SDK supports Apple's Custom Product Pages (CPP). CPP allows app developers to create up to 35 versions of their App Store product page to emphasize different features or content within their application. Each CPP has a unique Product Page ID (PPID) that you can append to the app's App Store URL. For more information, see Custom Product Pages.

The following sample App Store URL shows an appended PPID for a specific CPP:

https://apps.apple.com/us/app/my-fun-game/id12345678?ppid=45812c9b-c296-43d3-c6a0-c5a02f74bf6e

Pass back the entire App Store URL with appended PPID to leverage CPP as a DT demand partner. When received in the bid response, for example, in bid.ext.skadn.productpageid, the DT SDK parses the click URL and uses the PPID and the StoreKit controller to display the specific CPP instead of the default App Store page.