Overview

This article covers the attribution link templates (Impression Link and Click Tracking Link) and the postback URL setup for integrating Kochava with Swaarm.

The templates below are suggested starting points — you can add or remove parameters based on your requirements. Once integrated with Kochava, ask their team for the current integration details and replace them with the links populated by Swaarm parameters and macros.

ℹ️

For Swaarm's click and impression tracking macros → Advertiser Tracking Details
For Kochava's attribution link parameters → Integrate with Kochava as a Network/Publisher
For Kochava's postback macros → Create a Custom Postback
For Swaarm's ATT macros → ATT Privacy Macros & Parameters

Attribution Link Templates

ℹ️ The templates below are suggested starting points - you're free to add or remove parameters and macros based on your company's specific needs.

Impression Link iOS

https://imp.control.kochava.com/track/impression?campaign_id=sample&network_id=XXXX&ad_platform={kochava_ad_platform}&bid_type=CPI&bid_won={offer.weGet}&creative_id={publisher.creative}&device_id={device.ids.idfa}&device_id_type=idfa&device_ua={user.ua}&impression_id={id}&ip_address={user.ip}&language={user.language}&partner_campaign_name={offer.name}&site_id={publisher.id}&sub_site_id={publisher.subId}

Impression Link Android

https://imp.control.kochava.com/track/impression?campaign_id=sample&network_id=XXXX&ad_platform={kochava_ad_platform}&bid_type=CPI&bid_won={offer.weGet}&creative_id={publisher.creative}&device_id={device.ids.gaid}&device_id_type=adid&device_ua={user.ua}&impression_id={id}&ip_address={user.ip}&language={user.language}&partner_campaign_name={offer.name}&site_id={publisher.id}&sub_site_id={publisher.subId}

Click Tracking Link iOS

https://control.kochava.com/v1/cpi/click?campaign_id=sample&network_id=XXXX&ad_platform={kochava_ad_platform}&ad_type=non_incent&bid_type=CPI&bid_won={offer.weGet}&click_id={id}&creative_id={publisher.creative}&device_id={device.ids.idfa}&device_id_type=idfa&device_os={user.os}&device_os_version={user.os_version}&device_ua={user.ua}&goal_id=EVENT_ID&ip_address={user.ip}&language={user.language}&site_id={publisher.id}&sub_site_id={publisher.subId}

Click Tracking Link Android

https://control.kochava.com/v1/cpi/click?campaign_id=sample&network_id=XXXX&ad_platform={kochava_ad_platform}&ad_type=non_incent&bid_type=CPI&bid_won={offer.weGet}&click_id={id}&creative_id={publisher.creative}&device_id={device.ids.gaid}&device_id_type=adid&device_os={user.os}&device_os_version={user.os_version}&device_ua={user.ua}&goal_id=EVENT_ID&ip_address={user.ip}&language={user.language}&site_id={publisher.id}&sub_site_id={publisher.subId}

Postback URLs

⚠️ Replace {yournetwork} with your own Swaarm postback domain.

Global install postback (iOS)

https://track.{yournetwork}.swaarm-clients.com/postback?click_id={click/imp_id}&impression_based={is_viewthrough}&idfa={idfa}&tracker_name={tracker_name}&status={traffic_validated}

Global install postback (Android)

https://track.{yournetwork}.swaarm-clients.com/postback?click_id={click/imp_id}&impression_based={is_viewthrough}&gaid={adid}&tracker_name={tracker_name}&status={traffic_validated}

In-app event postback (iOS)

https://track.{yournetwork}.swaarm-clients.com/postback?click_id={click/imp_id}&impression_based={is_viewthrough}&idfa={idfa}&tracker_name={tracker_name}&status={traffic_validated}&event_id={event_name}&event_name={event_name}

In-app event postback (Android)

https://track.{yournetwork}.swaarm-clients.com/postback?click_id={click/imp_id}&impression_based={is_viewthrough}&gaid={adid}&tracker_name={tracker_name}&status={traffic_validated}&event_id={event_name}&event_name={event_name}

Event Setup

To track quality events for CPI campaigns and monetization events for CPA campaigns, use the event_id parameter to pass the event name, and set the Adv. EventType ID on the corresponding Swaarm event to match it exactly.

Postback Metadata Configuration (Kochava)

Kochava supports multiple methods and formats for sending postbacks. Use the following Swaarm-preferred configuration when setting up your postback in Kochava:

Setting	Value
Platform	Android, iOS, etc.
Method	GET
Format	URL
can_claim	No - allows Kochava to send conversions only for your network
Endpoint	Postback
Success Response	Yes