SKAdNetwork Integration

POST Method

The SKAN postbacks can be sent to Airbridge using the POST method.

HTTP Protocol

Method	POST
Endpoint	`https://postback.airbridge.io/skadnetwork/v1`
Content-Type	application/json
Response	200: OK 400: Validation Error

Body

The body must include the information listed below. Campaign parameters are optional.

All information included in the SKAN postback
The channel name that received the attribution credit (attributed-channel)
IP address and postback timestamp provided by the iOS device

Refer to the table below for details about the required parameters.

Parameter	Is it required?	Description	Source	Type
version	true	SKAdNetwork Documentation (* Send NULL for versions earlier than 2.0)	SKAdNetwork Postback	string (nullable)
ad-network-id	true	SKAdNetwork Documentation	SKAdNetwork Postback	string
campaign-id	true (* version 3.0 and earlier)	SKAdNetwork Documentation	SKAdNetwork Postback	integer
source-identifier	true (* version 4.0 and later)	SKAdNetwork (* Send NULL for versions earlier than 4.0)	SKAdNetwork Postback	string
transaction-id	true	SKAdNetwork Documentation	SKAdNetwork Postback	string
app-id	true	SkAdNetwork Documentation	SKAdNetwork Postback	integer
attribution-signature	true	SKAdNetwork Documentation	SKAdNetwork Postback	string
redownload	true (* version 2.0 and later)	SKAdNetwork Documentation (* Send NULL for versions earlier than 2.0)	SKAdNetwork Postback	boolean
fidelity-type	true (* version 2.2 and later)	SKAdNetwork Documentation (* Send NULL for versions earlier than 2.2)	SKAdNetwork Postback	Integer
did-win	true (* version 3.0 and later)	SKAdNetwork Documentation (* Send NULL for versions earlier than 3.0)	SKAdNetwork Postback	boolean
postback-sequence-index	true (* version 4.0 and later)	SKAdNetwork (* Send NULL for versions earlier than 4.0)	SKAdNetwork Postback	integer
source-app-id	false	SKAdNetwork Documentation	SKAdNetwork Postback	integer
conversion-value	false	SKAdNetwork Documentation	SKAdNetwork Postback	integer
coarse-conversion-value	false	SKAdNetwork	SKAdNetwork Postback	string
attributed-channel	true	Ad channel that received the attribution credit(Ad channel name registered with Airbridge)	Ad Network	string
attributed-campaign	false	Attributed Campaign	Ad Network	string
attributed-campaign-id	false	Attributed Campaign ID	Ad Network	string
attributed-ad-group	false	Attributed Ad Group	Ad Network	string
attributed-ad-group-id	false	Attributed Ad Group ID	Ad Network	string
attributed-ad-creative	false	Attributed Ad Creative	Ad Network	string
attributed-ad-creative-id	false	Attributed Ad Creative ID	Ad Network	string
attributed-sub-publisher	false	Attributed Sub Publisher	Ad Network	string
attributed-sub-sub-publisher-1	false	Attributed Sub Sub Publisher 1	Ad Network	string
attributed-sub-sub-publisher-2	false	Attributed Sub Sub Publisher 2	Ad Network	string
attributed-sub-sub-publisher-3	false	Attributed Sub Sub Publisher 3	Ad Network	string
ip	false	Device Public IP	Ad Network	string
timestamp	true	The time the ad network received the postback in the iOS device. Provide a 13-digit UNIX timestamp.	Ad Network	integer

Example

cURL

curl --location --request POST 'https://postback.airbridge.io/skadnetwork/v1' \
--header 'Content-type: application/json' \
--data-raw '{
    "version":"2.0",
    "ad-network-id": "abcabcabc.skadnetwork",
    "campaign-id": 99,
    "transaction-id": "68eb3d91-15f5-44ee-9267-25c7655c20b6",
    "app-id": 888707086,
    "attribution-signature": "MDYCGQCsQ4y8d4BlYU9b8Qb9BPWPi+ixk/OiRysCGQDZZ8fpJnuqs9my8iSQVbJO/oU1AXUROYU=",
    "redownload": false,
    "source-app-id": 888707074,
    "conversion-value": 63,
    "attributed-channel": "adnetwork_abc",
    "attributed-campaign": "test_campaign",
    "attributed-campaign-id": "test_campaign_id",
    "ip": "192.0.2.0",
    "timestamp": 1607678183995
}'

307 Redirect

The SKAN postbacks can be sent to Airbridge using the 307 Redirect method.

Checklist for Ad NetworksTransmit the payload containing the required parameters and parameters related to the ad campaign that received the attribution credit to the Airbridge postback server (postback.airbridge.io). Upon successful transmission, a 200 response is expected.

HTTP Protocol

Method	307 Redirect
Endpoint	`https://postback.airbridge.io/skadnetwork/v1`
Response	200: OK 400: Validation Error

Redirect URL

Refer to the table below and add information to the GET parameter in the Redirect URL. The ad channel that received the attribution credit (attributed-channel) must be included. Campaign parameters are optional.

Parameter	Is it required?	Description	Source
attributed-channel	true	Ad channel that received the attribution credit (Ad channel name registered with Airbridge)	Ad Network
attributed-campaign	false	Attributed Campaign	Ad Network
attributed-campaign-id	false	Attributed Campaign ID	Ad Network
attributed-ad-group	false	Attributed Ad Group	Ad Network
attributed-ad-group-id	false	Attributed Ad Group ID	Ad Network
attributed-ad-creative	false	Attributed Ad Creative	Ad Network
attributed-ad-creative-id	false	Attributed Ad Creative ID	Ad Network
attributed-sub-publisher	false	Attributed Sub Publisher	Ad Network
attributed-sub-sub-publisher-1	false	Attributed Sub Sub Publisher 1	Ad Network
attributed-sub-sub-publisher-2	false	Attributed Sub Sub Publisher 2	Ad Network
attributed-sub-sub-publisher-3	false	Attributed Sub Sub Publisher 3	Ad Network

Example

https://postback.airbridge.io/skadnetwork/v1?attributed-channel=adnetwork_abc&attributed-campaign=test_campaign&attributed-campaign-id=test_campaign_id

Implementing SKAN Integration

Sending SKAN conversion values from the ad channel to Airbridge

HTTP Protocol

Body

Example

HTTP Protocol

Redirect URL

Example

Sending SKAN data from Airbridge to ad channels

​Implementing SKAN Integration

​Sending SKAN conversion values from the ad channel to Airbridge

HTTP Protocol

Body

Example

HTTP Protocol

Redirect URL

Example

​Sending SKAN data from Airbridge to ad channels

Implementing SKAN Integration

Sending SKAN conversion values from the ad channel to Airbridge

Sending SKAN data from Airbridge to ad channels