iOS 14+ & SKAdNetwork Attribution

Overview 🔗

With the recent Apple announcement of the IDFA change on iOS 14+, Chartboost Exchange is planning to support SKAdNetwork attribution for DSP partners and also pass additional parameters in OpenRTB bid requests to help our partners augment modeling and targeting when IDFA is absent.

SKAdNetwork Support 🔗

• Chartboost has added SKAdNetwork version 2.0 support in our iOS SDK 8.3.0+, version 2.2 & 3.0 support in iOS SDK 8.4.2+, and version 4.0 support in iOS SDK 9.2.0+. If you plan to use SKAdNetwork attribution on Chartboost Exchange, please remember to share your SKAdNetwork ID(s) with the Chartboost Exchange team.
  • For SKAdNetwork 4.0+ in the Bid Response, use sourceidentifier as campaign is deprecated.
• Chartboost provides integration instructions for publishers to include the related SKAdNetwork IDs in their Info.plist file.
• Chartboost Exchange will include SKAdNetwork related parameters in the bid requests, so DSPs can identify which bid requests support SKAdNetwork and submit bid responses accordingly (see the detailed specs for bid request and bid response below).
  • If the publisher app’s Info.plist includes at least one SKAdNetworkItem matching a given DSP’s id(s), Chartboost Exchange will add imp.ext.skadn object in the bid request to the DSP. This object will only be present if the bid request is from iOS 14+ and an SKAN v2.0+ compatible SDK.
• The Chartboost Monetization SDK will show a StoreKit Rendered Ad if the bid response indicates that one is required in bidresponse.seatbid.bid.ext.skadn.

Note: If the response is "version":"2.2" or "version":"3.0", fidelities field is required (refer to the 2.2 example below). If the response is "version":"2.2" and there is only one object in the fidelities array, fidelity must be set to 1. If the response is "version":"2.0", fidelities should not be used (refer to the 2.0 example below).

BidRequest.imp.ext.skadn (Object) 🔗

Example

{
  "imp": [
    {
      "ext": {
        "skadn": {
          "versions": ["2.0","2.2","3.0","4.0"],
          "sourceapp": "1499118002",
          "skadnetids": [
            "dsp1.skadnetwork",
            "dsp2.skadnetwork"
          ],
          "productpage": 1
        }
      }
    }
  ]
}

BidResponse.seatbid.bid.ext.skadn (version 4.0) (Object) 🔗

Example

{
  "seatbid": [
    {
      "bid": [
        {
          "ext": {
            "skadn": {
              "version": "4.0",
              "network": "dsp1.skadnetwork",
              "sourceidentifier": "4321",
              "itunesitem": "487847188",
              "sourceapp": "1499118002",
              "productpageid": "45812c9b-c296-43d3-c6a0-c5a02f74bf6d",
              "fidelities": [
                {
                  "fidelity": 0,
                  "signature": "MEQCIEQlmZRNfYzKBSE8QnhLTIHZZZWCFgZpRqRxHss65KoFAiAJgJKjdrWdkLUOCCjuEx2RmFS7daRzSVZRVZ8RyMyUX1==",
                  "nonce": "68753a44-4d6f-1226-9c60-0050e4c00067",
                  "timestamp": "1600214400"
                },{
                  "fidelity": 1,
                  "signature": "MEQCIEQlmZRNfYzKBSE8QnhLTIHZZZWCFgZpRqRxHss65KoFAiAJgJKjdrWdkLUOCCjuEx2RmFS7daRzSVZRVZ8RyMyUX2==",
                  "nonce": "68753a44-4d6f-1226-9c60-0050e4c00068",
                  "timestamp": "1600214401"
                }
              ]
            }
          }
        }
      ]
    }
  ]
}

BidResponse.seatbid.bid.ext.skadn (version 2.2 & 3.0) (Object) 🔗

Example

{
  "seatbid": [
    {
      "bid": [
        {
          "ext": {
            "skadn": {
              "version": "2.2",
              "network": "dsp1.skadnetwork",
              "campaign": "18",
              "itunesitem": "487847188",
              "sourceapp": "1499118002",
              "productpageid": "45812c9b-c296-43d3-c6a0-c5a02f74bf6d",
              "fidelities": [
                {
                  "fidelity": 0,
                  "signature": "MEQCIEQlmZRNfYzKBSE8QnhLTIHZZZWCFgZpRqRxHss65KoFAiAJgJKjdrWdkLUOCCjuEx2RmFS7daRzSVZRVZ8RyMyUX1==",
                  "nonce": "68753a44-4d6f-1226-9c60-0050e4c00067",
                  "timestamp": "1600214400"
                },{
                  "fidelity": 1,
                  "signature": "MEQCIEQlmZRNfYzKBSE8QnhLTIHZZZWCFgZpRqRxHss65KoFAiAJgJKjdrWdkLUOCCjuEx2RmFS7daRzSVZRVZ8RyMyUX2==",
                  "nonce": "68753a44-4d6f-1226-9c60-0050e4c00068",
                  "timestamp": "1600214401"
                }
              ]
            }
          }
        }
      ]
    }
  ]
}

BidResponse.seatbid.bid.ext.skadn (version 2.0) (Object) 🔗

Example

{
  "seatbid": [
    {
      "bid": [
        {
          "ext": {
            "skadn": {
              "version": "2.0",
              "network": "dsp1.skadnetwork",
              "campaign": "18",
              "itunesitem": "487847188",
              "nonce": "68753a44-4d6f-1226-9c60-0050e4c00067",
              "sourceapp": "1499118002",
              "timestamp": "1600214400",
              "signature": "MEQCIEQlmZRNfYzKBSE8QnhLTIHZZZWCFgZpRqRxHss65KoFAiAJgJKjdrWdkLUOCCjuEx2RmFS7daRzSVZRVZ8RyMyUXg=="
            }
          }
        }
      ]
    }
  ]
}

BidResponse.seatbid.bid.ext.skadn.fidelities (2.2, 3.0, & 4.0) (Object Array) 🔗

OpenRTB Bid Request Parameters for Contextual Advertising 🔗

• Chartboost Exchange will start passing additional parameters in bid requests to help partners enhance contextual advertising targeting. These parameters will be included in bid requests coming from Chartboost iOS SDK 8.2.1 and above. They will be available across all iOS OS versions. See Bid Request for specifications.
• Updated fields include user.id, user.ext.sessionduration, user.ext.impdepth, device.ext.ifv, and device.ext.atts.

iOS 14+ SKAdNetwork Attribution - Changes to click-through behavior 🔗

When an ad response contains SKAdNetwork parameters and a user clicks through the ad, click-through URLs (via VAST ClickThrough or CompanionClickThrough, mraid.open(), or standard HTML <a href="..."></a> links) will trigger HTTP GET requests by the SDK immediately & asynchronously in the background, following all HTTP 302 redirects to a final destination, while the SDK calls the iOS loadProduct API to open the itunesitem in the App Store. Note: VAST ClickTracking and CompanionClickTracking will continue to operate without change.