iOS 14+

Introduction

Due to the IDFA changes Apple is implementing in iOS 14 and later, BidMachine is adding support for Apple's SKAdNetwork attribution. This integration enables our programmatic demand buyers to track installs and conversions on iOS 14+ when IDFA is unavailable. In addition to SKAdNetwork, BidMachine will provide contextual advertising data to help partners enhance targeting and modeling.

Below is an overview of how the integration works at the app/publisher level and the data flow during the auction.

SKAdNetwork Integration Overview

SKAdNetwork IDs

Partners who wish to use BidMachine's SKAdNetwork solution should share their SKAdNetwork ID with their account manager. If you don’t have an account manager, register with Apple here.

BidMachine will provide publishers with an integration guide listing all SKAdNetwork IDs to add to their Info.plist.

SKAdNetwork IDs in Info.plist format

<key>SKAdNetworkItems</key>
<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>wg4vff78zm.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>737z793b9f.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>ydx93a7ass.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>prcb7njmu6.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>mls7yz5dvl.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>7ug5zh24hu.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>44jx6755aq.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>2u9pt9hc89.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>w9q455wk68.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>yclnxrl5pm.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>p78axxw29g.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>4fzdc2evr5.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>4pfyvq9l8r.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>v72qych5uu.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>6xzpu9s2p8.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>mlmmfzh3r3.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>c6k4g5qg8m.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>g28c52eehv.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>523jb4fst2.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>ggvn48r87g.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>3sh42y64q3.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>f38h382jlk.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>24t9a8vw3c.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>hs6bdukanm.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>9nlqeag3gk.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>cj5566h2ga.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>ejvt5qm6ak.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>cstr6suwn9.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>wzmmz9fp6w.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>4468km3ulz.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>5lm9lj6jb7.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>zmvfpc5aq8.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>9rd848q2bz.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>7rz58n8ntl.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>feyaarzu9v.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>9t245vhmpl.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>n9x2a789qt.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>tl55sbb4fm.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>5a6flpkh64.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>8s468mfl3y.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>glqzh8vgby.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>424m5254lk.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>5l3tpt7t6e.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>uw77j35x4d.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>gta9lk7p23.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>av6w8kgt66.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>t38b2kh725.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>s39g8k73mm.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>m8dbw4sv7c.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>lr83yxwka7.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>kbd757ywx3.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>cg4yq2srnc.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>ludvb6z3bs.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>22mmun2rn5.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>su67r6k2v3.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>4w7y6s5ca2.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>klf5c3l5u5.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>dzg6xy7pwj.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>y45688jllp.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>hdw39hrw9y.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>ppxm28t8ap.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>4dzt52r2t5.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>mtkv5xtk9e.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>5tjdwbrq8w.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>3rd42ekr43.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>32z4fx6l9h.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>xy9t38ct57.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>54nzkqm89y.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>9b89h5y424.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>pwa73g5rt2.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>79pbpufp6p.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>294l99pt4k.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>s69wq72ugq.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>k674qkevps.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>578prtvx9j.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>2fnua5tdw4.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>f73kdq92p3.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>e5fvkxwrpn.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>n6fk4nfna4.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>x44k69ngh6.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>mp6xlyr22a.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>rx5hdcabgc.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>6g9af3uyq4.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>u679fj5vs4.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>qqp299437r.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>275upjj5gd.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>3qcr597p9d.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>97r2b46745.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>g2y4y55b64.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>44n7hlldy6.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>6p4ks3rnbw.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>rvh3l7un93.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>kbmxgpxpgc.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>74b6s63p6l.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>a7xqa6mtl2.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>zq492l623r.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>r45fhb6rf7.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>84993kbrcf.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>pwdxu55a5a.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>6964rsfnh4.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>24zw6aqk47.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>cs644xg564.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>9vvzujtq5s.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>c3frkrj4fj.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>8r8llnkz5a.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>WZMMZ9FP6W.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>vhf287vqwu.skadnetwork</string>
    </dict>
</array>

Bid Request

BidMachine adds the following fields to BidRequests on iOS 14+ versions, categorized below:

SKAdNetwork Request Data

Object	Attribute	Description	Type	Example
`imp.ext.skadn`	`version`	SKAdNetwork SDK version (`"2.0"` or higher). Deprecated in favor of `versions` since 2.1.	`string`	`"2.0"`
`imp.ext.skadn`	`versions`	Supported SKAdNetwork versions (array of strings).	`string[]`	`["2.0","2.1","2.2"]`
`imp.ext.skadn`	`sourceapp`	Publisher app ID in Apple App Store (matches `app.bundle`).	`string`	`"1232526187"`
`imp.ext.skadn`	`overlay`	Flag indicating SKOverlay support (`0` or `1`).	`integer`	`1`
`imp.ext.skadn`	`autostore`	Flag indicating AutoStore support (`0` or `1`).	`integer`	`1`
`imp.ext.skadn`	`skadnetids`	Subset of SKAdNetwork IDs (from `Info.plist`) relevant to the DSP.	`string[]`	`["87yhbnd3gg.skadnetwork", ...]`

Example

{
  "imp": [
    {
      "ext": {
        "skadn": {
          "version": "2.0",
          "versions": ["2.0","2.1","2.2"],
          "sourceapp": "880047117",
          "overlay": 1,
          "skadnetids": [
            "cdkw7geqsh.skadnetwork",
            "qyjfv329m4.skadnetwork"
          ]
        }
      }
    }
  ]
}

Bid Response

SKAdNetwork Response Data

If the DSP receives imp.ext.skadn in the bid request, they must include seatbid.bid.ext.skadn in the bid response. This enables BidMachine to submit click data and signatures for attribution.

Properties of seatbid.bid.ext.skadn:

Attribute	Description	Type	Example
`version`	SKAdNetwork SDK version (`"2.0"` or higher).	`string`	`"2.0"`
`network`	SKAdNetwork ID matching one in `skadnetids` from the request.	`string`	`"87yhbnd3gg.skadnetwork"`
`campaign`	Campaign ID (1–100), as a string.	`string`	`"1"`
`itunesitem`	Advertiser app ID (matches `bid.bundle`).	`string`	`"1232526187"`
`fidelities`	Array of fidelity objects (introduced in SKAdNetwork v2.2).	`object[]`	See example below
`nonce`	Unique identifier per ad response. Deprecated in favor of `fidelities[n].nonce` since 2.2.	`string`	`"a9ff03c2-d7ef-11ea-87d0-0242ac130003"`
`sourceapp`	Publisher app ID (matches request `sourceapp`).	`string`	`"123456789"`
`overlay`	Flag indicating SKOverlay display.	`integer`	`1`
`timestamp`	Unix time (ms) at signature time. Deprecated in favor of `fidelities[n].timestamp` since 2.2.	`string`	`"1596723499812"`
`signature`	SKAdNetwork signature. Deprecated in favor of `fidelities[n].signature` since 2.2.	`string`	`"MZHKJHKhKJH…"`

seatbid.bid.ext.skadn.fidelities object:

Attribute	Description	Type	Example
`fidelity`	Fidelity type of the attribution.	`integer`	`0`
`nonce`	Unique identifier per ad response.	`string`	`"473b1a16-b4ef-43ad-9591-fcf3aefa82a7"`
`timestamp`	Unix time (ms) at signature time.	`string`	`"1594406341232"`
`signature`	SKAdNetwork signature.	`string`	`"MEQCIEQlmZRNfYzK…"`

Examples

v2.2
v2.2 with fidelities
v2.0

{
  "seatbid": [
    {"bid": [
      {"ext": {"skadn": {
        "version": "2.2",
        "network": "cdkw7geqsh.skadnetwork",
        "campaign": "45",
        "itunesitem": "123456789",
        "sourceapp": "880047117",
        "overlay": 1,
        "fidelities": [
          {
            "fidelity": 0,
            "signature": "MEQCIEQlmZRNfYzK…",
            "nonce": "473b1a16-b4ef-43ad-9591-fcf3aefa82a7",
            "timestamp": "1594406341232"
          }
        ]
      }}}
    ]}
  ]
}

{
  "seatbid": [
    {"bid": [
      {"ext": {"skadn": {
        "version": "2.2",
        "network": "cdkw7geqsh.skadnetwork",
        "campaign": "45",
        "itunesitem": "123456789",
        "sourceapp": "880047117",
        "overlay": 1,
        "fidelities": [
          {
            "fidelity": 0,
            "signature": "MEQCIEQlmZRNfYzK…",
            "nonce": "473b1a16-b4ef-43ad-9591-fcf3aefa82a7",
            "timestamp": "1594406341232"
          },
          {
            "fidelity": 1,
            "signature": "GRlMDktMmE5Zi00Z…",
            "nonce": "e650de09-2a9f-4dc3-a4d1-544c402e9095",
            "timestamp": "1594406341233"
          }
        ]
      }}}
    ]}
  ]
}

{
  "seatbid": [
    {"bid": [
      {"ext": {"skadn": {
        "version": "2.0",
        "network": "cdkw7geqsh.skadnetwork",
        "campaign": "45",
        "itunesitem": "880047117",
        "nonce": "473b1a16-b4ef-43ad-9591-fcf3aefa82a7",
        "sourceapp": "123456789",
        "overlay": 1,
        "timestamp": "1594406341232",
        "signature": "MEQCIEQlmZRNfYzKBSE8QnhLTIHZZZWCFgZpRqRxHss65KoFAiAJgJKjdrWdkLUOCCjuEx2RmFS7daRzSVZRVZ8RyMyUXg=="
      }}}
    ]}
  ]
}

Click Through & Click Tracking

When SKAdNetwork is enabled and a valid skadn object is in the bid response:

iOS SDK opens a SKStoreProductViewController with the skadn values.
VAST ClickThrough, CompanionClickThrough, MRAID.open(), and standard HTML <a href=> links are processed in the background. HTTP redirects are followed; non-redirect responses are ignored.
VAST ClickTracking and CompanionClickTracking continue to function as usual.

If no skadn object is found, the SDK falls back to normal click-through behavior.

Introduction​

SKAdNetwork Integration Overview​

SKAdNetwork IDs​

Bid Request​

SKAdNetwork Request Data​

Example​

Bid Response​

SKAdNetwork Response Data​

Examples​

Click Through & Click Tracking​