FAQ - Guide for Media Partners - Airbridge Help Center

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

How do I integrate with Airbridge?

Integration with Airbridge follows the steps below:

Step	Owner	Description
1. Submit the integration request form	Media partner	Fill out and submit the integration request form. See this article 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.

Can I review the integration request form after submitting it?

Yes. A copy of the form is sent to the email address you provided.

Configure tracking link template

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 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.

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` - `ip` - `user_agent`	- `click_id` - `ip` - `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.

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.

Can I include the hash symbol (#) in a tracking link template?

No, you should not include the hash symbol (#) in tracking link templates.

Configure postback URL

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 spreadsheet to find suitable parameters, and see this article for configuration instructions. Check with the advertiser whether any values, such as Transaction ID, need to be collected through the Airbridge SDK.

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.

During integration

How do I run a postback test?

See the Testing postback sending article.

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.

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 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 article.

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.

After integration

Postback

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. See the Postback spec spreadsheet for the list of supported parameters.

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 article.

How do I switch to the POST method?

Follow the steps below.

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

Item	Description	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}"}`

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

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.

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.

Can I receive web events via postback?

Yes. See the Web event postback section for details.

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.

Are attribution rules different for web and app?

Yes. Web attribution doesn’t apply the lookback window. See the Web attribution section for details.

Tracking link

Can I test a tracking link without a device ID?

You can, but it’s not recommended. Without a device ID, device ID matching cannot identify users, which means the test can’t reliably verify whether attribution is working correctly.

Troubleshooting

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.

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.

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.

{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.

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.

Dashboard access

Is there a dedicated dashboard for media partners?

As of February 2026, no. Ask the advertiser to grant you access to their apps. 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.

I want to be assigned the Agency role.

Contact the Airbridge integration team at integration@airbridge.io. See the App roles section for the access scope of that role.

Can I access the Airbridge Demo app dashboard?

Yes. The Airbridge Demo app offers a 30-day free trial.

Can I access the Ablog app dashboard?

No. Ablog is a test app and is only available for download from app stores.

Cross-platform measurement

Does Airbridge support cross-platform measurement?

Yes, it does. See the Cross-platform measurement article for details.

Does Airbridge support CTV campaign measurement?

Yes, it does. See the CTV campaign tracking article for details.

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 method to identify users for CTV campaign measurement.

Other

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. Note that the ad channel ID cannot be changed, since it’s the unique identifier that shows which ad channel a tracking link belongs to.

How can I ask about an advertiser's campaigns?

Contact the Airbridge integration team at integration@airbridge.io with the advertiser’s app information.

​Request integration

​Configure tracking link template

​Configure postback URL

​During integration

​After integration

​Postback

​Tracking link

​Troubleshooting

​Dashboard access

​Cross-platform measurement

​Other