> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ - Guide for Media Partners

This FAQ covers the most common questions media partners have when integrating with Airbridge, including the integration process, postback configuration, testing, and troubleshooting.

## Request integration

<AccordionGroup>
  <Accordion title="How do I integrate with Airbridge?">
    Integration with Airbridge follows the steps below:

    | Step                                                                                            | Owner                    | Description                                                                                                                       |
    | ----------------------------------------------------------------------------------------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
    | 1. Submit the [integration request form](https://partner.airbridge.io/en/supports/integrations) | Media partner            | Fill out and submit the integration request form. See [this article](/en/guides/airbridge-partner-registration) for instructions. |
    | 2. Review the submitted form                                                                    | Airbridge                | Airbridge reviews the submitted form. This takes approximately 5 business days.                                                   |
    | 3. Prepare for testing                                                                          | Airbridge                | Airbridge provides the tracking link and postback templates for testing.                                                          |
    | 4. Run tests                                                                                    | Media partner, Airbridge | Using the provided templates, you and Airbridge verify that the tracking link and postback work correctly.                        |
    | 5. Complete integration                                                                         | Airbridge                | Once testing is complete, Airbridge registers your ad channels on the Airbridge dashboard.                                        |
  </Accordion>

  <Accordion title="Can I review the integration request form after submitting it?">
    Yes. A copy of the form is sent to the email address you provided.
  </Accordion>
</AccordionGroup>

### Configure tracking link template

<AccordionGroup>
  <Accordion title="What's the difference between “Client-to-Server (C2S) clicks” and “Server-to-Server (S2S) clicks” under the [What to track with tracking links]?">
    The two options differ in who redirects users to the final destination after they click the ad. With **C2S clicks**, Airbridge handles the redirect. With **S2S clicks**, the ad channels do. See [this article](/en/guides/airbridge-partner-registration#difference-between-s2s-click-and-click) for details.

    If you select **S2S clicks**, the ad channels need to implement the redirect. We recommend using **C2S clicks**, which requires no extra implementation, unless you have a specific reason to use **S2S clicks**.
  </Accordion>

  <Accordion title="What are the [Parameters] marked as required under [Tracking Link Template]?">
    They are parameters that must be included in your tracking link template. They're automatically added based on what you selected under **\[What to track with tracking links]**.

    |                     | C2S clicks   | S2S clicks                                   | Impressions                                  |
    | ------------------- | ------------ | -------------------------------------------- | -------------------------------------------- |
    | Required parameters | - `click_id` | - `click_id`<br />- `ip`<br />- `user_agent` | - `click_id`<br />- `ip`<br />- `user_agent` |

    We also recommend including `sub_id`, `ad_id`, `ifa_raw`, and `gaid_raw`, plus as many other parameters as possible. For more details, see [this article](/en/guides/airbridge-partner-registration#parameters).
  </Accordion>

  <Accordion title="Can I send impression IDs to Airbridge through a tracking link?">
    Yes. To send impression IDs, select **Impression** under **\[What to track with tracking links]**. Airbridge then provides impression tracking links for the ad channel, and the impression ID will be populated as the `click_id` parameter value whenever an impression event occurs.
  </Accordion>

  <Accordion title="Can I include the hash symbol (#) in a tracking link template?">
    No, you should not include the hash symbol (`#`) in tracking link templates.
  </Accordion>
</AccordionGroup>

### Configure postback URL

<AccordionGroup>
  <Accordion title="I want to receive specific data like event name or device model via postback. Which parameters should I use?">
    For event name and device model, add the following parameters to the postback URL:

    * Event name: select `{@postback.eventName}` as the parameter value.
    * Device model: for Android, select `{device.manufacturer}` or `{device.deviceModel}` as the parameter value. For iOS, select `{device.deviceIdentifier}`.

    For any other data you want to receive, add suitable parameters to the postback URL. Refer to the parameter descriptions in the [Postback spec](https://docs.google.com/spreadsheets/d/e/2PACX-1vQgBzJwN3jnWEYCfaFOFmdabVjwhXQU9_L6U9ef053mm7OPJe6uFR2pWEhtKHCFrjBRrJIvsc2nlMbT/pubhtml?gid=299237245\&single=true\&airbridge_referrer=airbridge%3Dtrue%26client_id%3D640c4290-6c23-48f1-a282-ff76a8a18934%26event_uuid%3D74be1564-6da0-429c-8e68-c0eb1d6b6787%26referrer_timestamp%3D1759222827912%26short_id%3D077upd%26channel%3Duser_guide%26campaign%3Dintegration%26tracking_template_id%3Da878823ddc7692609b99f9a7cc4caa7e%26ad_group%3Dpartner_guide%26content%3Dpartner_guide_postback_macro_sheet%26og_tag_id%3D237917694%26routing_short_id%3D8ahj9p\&utm_source=user_guide\&utm_campaign=integration\&utm_content=partner_guide_postback_macro_sheet) spreadsheet to find suitable parameters, and see [this article](/en/guides/airbridge-partner-registration#configuring-postback-urls-by-event) for configuration instructions. Check with the advertiser whether any values, such as Transaction ID, need to be collected through the Airbridge SDK.
  </Accordion>

  <Accordion title="How do I set up postback authentication credentials?">
    Go to **\[Postback URL]>\[Credentials for advertiser authentication]** and check the **We assign credentials to advertisers** checkbox. Enter a credential name, which will be used as the parameter key in the postback URL. The `{@postback.apiKeySet}` macro will be added as the value of that key. The advertiser will then need to register the credentials on the Airbridge dashboard to send postbacks.
  </Accordion>
</AccordionGroup>

## During integration

<AccordionGroup>
  <Accordion title="How do I run a postback test?">
    See the [Testing postback sending](/en/guides/integration-testing-for-partners) article.
  </Accordion>

  <Accordion title="I ran the postback test but didn't receive the data as expected.">
    Check the possible causes below. If you’ve checked everything but the issue persists, contact the Airbridge integration team at [integration@airbridge.io](mailto:integration@airbridge.io).

    | Possible cause                     | What to do                                                                                                                                                                        |
    | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Endpoint error                     | Check that the endpoint URL you entered in the integration request form is correct and that the receiving endpoint is working.                                                    |
    | Missing required parameters        | Check that all required parameters, including `click_id`, are included in the postback URL. See [this article](/en/guides/airbridge-partner-registration#parameters) for details. |
    | Missing authentication credentials | Check that all required credentials are registered in Airbridge.                                                                                                                  |
    | Test procedure not followed        | Check that the test was run correctly following the [Testing postback sending](/en/guides/integration-testing-for-partners) article.                                              |
  </Accordion>

  <Accordion title="The data received during the postback test is flagged as ad fraud.">
    This is expected during testing. In live campaigns, fraud validation rules are only applied if the advertiser has set them up under **\[Fraud Validation Rules]** on the Airbridge dashboard. We recommend checking the advertiser's fraud validation rules before campaigns go live.
  </Accordion>
</AccordionGroup>

## After integration

### Postback

<AccordionGroup>
  <Accordion title="I want to add parameters to the postback URL in addition to what I added in the integration request form.">
    Contact the Airbridge integration team at [integration@airbridge.io](mailto:integration@airbridge.io). See the [Postback spec](https://docs.google.com/spreadsheets/d/e/2PACX-1vQgBzJwN3jnWEYCfaFOFmdabVjwhXQU9_L6U9ef053mm7OPJe6uFR2pWEhtKHCFrjBRrJIvsc2nlMbT/pubhtml?gid=299237245\&single=true\&airbridge_referrer=airbridge%3Dtrue%26client_id%3D640c4290-6c23-48f1-a282-ff76a8a18934%26event_uuid%3D74be1564-6da0-429c-8e68-c0eb1d6b6787%26referrer_timestamp%3D1759222827912%26short_id%3D077upd%26channel%3Duser_guide%26campaign%3Dintegration%26tracking_template_id%3Da878823ddc7692609b99f9a7cc4caa7e%26ad_group%3Dpartner_guide%26content%3Dpartner_guide_postback_macro_sheet%26og_tag_id%3D237917694%26routing_short_id%3D8ahj9p\&utm_source=user_guide\&utm_campaign=integration\&utm_content=partner_guide_postback_macro_sheet) spreadsheet for the list of supported parameters.
  </Accordion>

  <Accordion title="I want to receive postbacks from only a specific set of Airbridge postback server IP addresses.">
    See the [Postback server IP addresses for media partners](/en/guides/postback-server-ip-address-ad-channels) article.
  </Accordion>

  <Accordion title="How do I switch to the POST method?">
    Follow the steps below.

    1. Confirm that your ad channel server can receive data via POST.
    2. Reach out to your Airbridge contact to request the change, and provide your endpoint URL, headers, and body following the example below.

    | <span style={{ display: 'inline-block', minWidth: '125px' }}>Item</span> | <span style={{ display: 'inline-block', minWidth: '175px' }}>Description</span> | Example                                                                                                                                                                                |
    | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Endpoint URL                                                             | Server address that will receive the data                                       | `https://api.your-media-domain.com/postback`                                                                                                                                           |
    | Headers                                                                  | Media type of the resource                                                      | `Content-Type: application/json`                                                                                                                                                       |
    | Body                                                                     | Structure of the data to receive                                                | `{"click_id": "{attributionResult.attributedClickID}", "event_name": "{@postback.eventName}", "payout": "{attributionResult.rewardAmount}", "device_id": "{device.deviceIdentifier}"}` |

    3. Run tests with Airbridge to verify that postbacks are sent via POST.
    4. Once testing is complete, Airbridge will switch the postback method for the ad channel to POST.
  </Accordion>

  <Accordion title="Can I receive Custom Events via postback?">
    Yes. First, the advertiser needs to set up the Airbridge SDK to collect the Custom Event, so confirm the setup with the advertiser. Once the Custom Event is collected by Airbridge, it will automatically be sent via postback.
  </Accordion>

  <Accordion title="Can I receive Semantic Attributes via postback?">
    Yes. Note that ad channels can only receive Semantic Attributes that the advertiser is collecting through the Airbridge SDK.
  </Accordion>

  <Accordion title="Can I receive web events via postback?">
    Yes. See the [Web event postback](/en/guides/airbridge-partner-registration#web-event-postback) section for details.
  </Accordion>

  <Accordion title="Can I use the same postback URL for both app and web events?">
    Yes. Note that some app-only parameters, such as `deviceId` and `deviceIdType`, aren't supported for web events.
  </Accordion>

  <Accordion title="Are attribution rules different for web and app?">
    Yes. Web attribution doesn't apply the lookback window. See the [Web attribution](/en/guides/attribution-scenario#web-attribution) section for details.
  </Accordion>
</AccordionGroup>

#### Tracking link

<Accordion title="Can I test a tracking link without a device ID?">
  You can, but it’s not recommended. Without a device ID, [device ID matching](/en/guides/identity-matching#device-id-matching) cannot identify users, which means the test can’t reliably verify whether attribution is working correctly.
</Accordion>

### Troubleshooting

<AccordionGroup>
  <Accordion title="I didn't receive a Custom Event via postback.">
    Check the possible causes below. If you’ve checked everything but the issue persists, contact the Airbridge integration team at [integration@airbridge.io](mailto:integration@airbridge.io).

    | Possible cause                         | What to do                                                                                                                                             |
    | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
    | Airbridge SDK not collecting the event | Ask the advertiser to confirm that the Airbridge SDK is collecting the event.                                                                          |
    | Event rules not followed               | Confirm that the advertiser is following the event rules agreed upon between the ad channel and Airbridge, such as event name and postback URL format. |
    | Postback sending disabled              | Ask the advertiser to confirm that postback sending is enabled on the Airbridge dashboard.                                                             |
  </Accordion>

  <Accordion title="My tracking link doesn’t redirect to the app store.">
    Check whether you've selected **Server-to-Server (S2S) clicks** under **\[Tracking Link Template]>\[What to track with tracking links]** in the integration request form. This option requires the ad channel to handle redirection. Without that implementation, the tracking link can't redirect users. To change your selection, contact the Airbridge integration team at [integration@airbridge.io](mailto:integration@airbridge.io).
  </Accordion>

  <Accordion title="{device.clientIPCountryCode} and {device.country} return different values.">
    This happens because the two values are determined by different sources. Use whichever fits your needs.

    * `{device.country}`: based on the language and region set on the device.
    * `{device.clientIPCountryCode}`: based on the IP address the device is connecting from.
  </Accordion>

  <Accordion title="Do I need to ask the advertiser to configure [Events for Attribution] for retargeting campaigns?">
    No, you don't need to. **\[Events for Attribution]** is not related to retargeting campaigns.

    The default option, **All Events**, makes all events eligible for attribution, including **Installs (App)**, **Deeplink Opens (App)**, **Deeplink Pageviews (App)**, and their subsequent events. Switching to **Specific Events** excludes some events from the attribution process. We recommend keeping **All Events** unless the advertiser wants to either:

    * Exclude **Installs (App)** and their subsequent events from attribution.
    * Exclude **Deeplink Opens (App)**, **Deeplink Pageviews (App)**, and their subsequent events from attribution.
  </Accordion>
</AccordionGroup>

## Dashboard access

<AccordionGroup>
  <Accordion title="Is there a dedicated dashboard for media partners?">
    As of February 2026, no. Ask the advertiser to grant you [access to their apps](/en/guides/app-access-management#app-role-media-partner). Once they grant access, you'll receive an invitation link that you must accept within 72 hours. By default, you'll only have access to the data attributed to your ad channels.
  </Accordion>

  <Accordion title="I want to be assigned the Agency role.">
    Contact the Airbridge integration team at [integration@airbridge.io](mailto:integration@airbridge.io). See the [App roles](/en/guides/user-management#app-roles) section for the access scope of that role.
  </Accordion>

  <Accordion title="Can I access the Airbridge Demo app dashboard?">
    Yes. The Airbridge Demo app offers a 30-day free trial.
  </Accordion>

  <Accordion title="Can I access the Ablog app dashboard?">
    No. Ablog is a test app and is only available for download from app stores.
  </Accordion>
</AccordionGroup>

## Cross-platform measurement

<AccordionGroup>
  <Accordion title="Does Airbridge support cross-platform measurement?">
    Yes, it does. See the [Cross-platform measurement](/en/guides/cross-platform-measurement) article for details.
  </Accordion>

  <Accordion title="Does Airbridge support CTV campaign measurement?">
    Yes, it does. See the [CTV campaign tracking](/en/guides/ctv-tracking) article for details.
  </Accordion>

  <Accordion title="Is there a required parameter for the CTV campaign tracking link template?">
    Yes. The parameter that carries the IP address is required, since Airbridge uses the [IP Matching Only](/en/guides/ctv-tracking#how-airbridge-measures-ctv-campaigns) method to identify users for CTV campaign measurement.
  </Accordion>
</AccordionGroup>

## Other

<AccordionGroup>
  <Accordion title="Can I change the name of an ad channel already registered on the Airbridge dashboard?">
    Yes. To request a change, contact the Airbridge integration team at [integration@airbridge.io](mailto:integration@airbridge.io). Note that the [ad channel ID](/en/guides/airbridge-partner-registration#ad-channel-id) cannot be changed, since it's the unique identifier that shows which ad channel a tracking link belongs to.
  </Accordion>

  <Accordion title="How can I ask about an advertiser's campaigns?">
    Contact the Airbridge integration team at [integration@airbridge.io](mailto:integration@airbridge.io) with the advertiser's app information.
  </Accordion>
</AccordionGroup>

<link rel="alternate" hrefLang="en" href="https://help.airbridge.io/en/guides/airbridge-for-partners-faq" />

<link rel="alternate" hrefLang="ko" href="https://help.airbridge.io/ko/guides/airbridge-for-partners-faq" />