Load Tracking

FAQ

1. What is load tracking?

• MoPub has introduced a new extension field in the bid response called loadtrackers that offers DSPs greater visibility into the the ad delivery lifecycle – the ability to measure when an ad has been successfully loaded onto the device.

• Important note: This feature is OPTIONAL. MoPub is not requiring DSP’s build support for loadtrackers.

• The loadtrackers field is an array of tracking URL’s that MoPub will dispatch when an ad has been successfully loaded/pre-cached on the device, before an impression has been shown. (A successful ‘load’ will not necessarily have a corresponding impression.)

2. Why was this built?

• Support for loadtrackers was added in order to increase transparency in the exchange by tracking all points of an impression, from request to load to show (impression). This helps both internal and external analysis and troubleshooting.

3. What is the benefit for DSPs?

• Funnel Visibility - This tracking ability and visibility into the ad lifecycle will allow DSP’s to compare the relative drop-offs from win-to-load (suggesting technical issues) and from load-to-show (suggesting a user not reaching an ad experience). A tracker submitted as part of loadtrackers should also align closely with any other trackers that are despatched within the HTML of a creative, as these are fetched as part of the pre-caching process.

• This will allow the DSP to find opportunities of potential efficiency improvements by finding areas of large drop offs between load and show. It will also be a critical piece to troubleshooting discrepancies between MoPub and DSP’s.

4. Where should the DSP pass loadtrackers?

• The loadtrackers array should be passed inside the bid extension object, in the same place as the imptrackers array: seatbid.bid.ext.loadtrackers

• This field is optional, but if present, must be an object array of urls. We will invalidate any value that is not an array of strings, and they will be ignored as part of the bid response.

5. When will the loadtrackers fire?

• Tracking URL’s submitted in this field will be fetched once an ad has been successfully loaded/pre-cached onto the device.

6. Which formats/sizes are supported?

• SDK 4.19 - 5.3: HTML and MRAID for banners, MREC and fullsceen ads. VAST and Native are not supported.
• SDK 5.4+: All sizes and formats.
• Note: Partners wishing to only use this feature on fully supported versions and formats should look for the MoPub SDK version in the bidrequest.imp.displaymanagerver field of the bid request, and omit loadtrackers in their bid response if below 5.4.

7. How many loadtrackers can a DSP include in a bid response?

• DSP’s can submit one or more trackers.

Sample Response

{
  "bidid": "abc1234",
  "cur": "USD",
  "id": "1234567890",
  "seatbid": [
    {
      "seat": "xyz12345",
      "bid": [
        {
          "ext": {
            "crtype": "Image Ad",
            "imptrackers": [              "https://imptrackers1.com/mopub/win/${AUCTION_ID}/${AUCTION_BID_ID}/${AUCTION_IMP_ID}/${AUCTION_SEAT_ID}/${AUCTION_AD_ID}/${AUCTION_PRICE}/0.999",             "https://imptrackers2.com/mopub/win/${AUCTION_ID}/${AUCTION_BID_ID}/${AUCTION_IMP_ID}/${AUCTION_SEAT_ID}/${AUCTION_AD_ID}/${AUCTION_PRICE}/0.999"
            ],
            "loadtrackers": [             "https://loadtrackers1.com/${AUCTION_ID}/${AUCTION_BID_ID}/${AUCTION_IMP_ID}/${AUCTION_SEAT_ID}/${AUCTION_AD_ID}/${AUCTION_PRICE}/0.999"
            ],
            "nurls": [              "http://nurl1.com/mopub/win/${AUCTION_ID}/${AUCTION_BID_ID}/${AUCTION_IMP_ID}/${AUCTION_SEAT_ID}/${AUCTION_AD_ID}/${AUCTION_PRICE}/0.999",
              "http://nurl2.com/mopub/win/${AUCTION_ID}/${AUCTION_BID_ID}/${AUCTION_IMP_ID}/${AUCTION_SEAT_ID}/${AUCTION_AD_ID}/${AUCTION_PRICE}/0.999"
            ]
          },
          "id": "12345678",
          "adid": "314",
          "cat": [
            "IAB1-6"
          ],
          "adm": "",
          "adomain": [
            "advertiserdomain.com"
          ],
          "bundle": "com.foo.mygame",
          "attr": [
            4,
            7
          ],
          "cid": "campaign111",
          "crid": "101409",
          "h": 50,
          "w": 320,
          "impid": "1",
          "iurl": "http://adserver.com/pathtosampleimage.jpg",
          "price": 0.999
        }
      ]
    }
  ]
}