SKAdNetwork Integration

    注意

    本ガイドは、メディアパートナー（広告媒体）向けの内容です。
    Airbridgeをご利用中の広告主様で、現在ご利用中の広告媒体との連携をご希望の場合は、管理画面の [Integrations] ＞ [Ad Channel Integration] に進み、右上の 「Request integration」 をクリックしてリクエストを送信してください

    SKAN integration is required per ad channel to view SKAN data in Airbridge. It is a different integration module from the integration using tracking links.

    Implementing SKAN Integration

    Below is the general SKAN data flow.

    1. The advertiser provides the conversion values from the iOS device to the ad channel.

    2. The ad channel sends the conversion values to Airbridge.

    3. Airbridge sends the event data as per conversion value mapping to the ad channel.

    SKAN integration is required to support the second and third steps of the above process.

    Sending SKAN conversion values from the ad channel to Airbridge

    The ad channel needs to forward the received SKAN postbacks to the Airbridge SKAN Postback API. Choose one of the following methods for transmission.

    The data transmission method differs by parameter. If the source is SKAdNetwork Postback, it needs to be forwarded as is without any additional processing. If the source is an ad network, it needs to be decoded by the ad channel, or additional information needs to be added before transmission.

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

    HTTP Protocol

    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.

    Example

    cURL
    123456789101112131415161718
    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
}'

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

    Checklist for Ad Networks

    Transmit 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

    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.

    Example

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

    Sending SKAN data from Airbridge to ad channels

    The ad channel utilizes the SKAdNetwork Conversion Value Config API to retrieve the advertiser-provided conversion value settings and subsequently decodes the conversion value using those settings.