Overview
IconPeak is a mobile performance marketing company that provides user acquisition through proprietary machine-learning technology and a real-time bidding DSP. Connect IconPeak to Branch to attribute clicks and installs and configure Postbacks.
For more information about integrating ad partners in general, visit our Ad Partner Integration Guide.
Note: this guide is for new Branch
Please note that this guide is about integrating IconPeak in the new Branch experience. For information on IconPeak in legacy Branch, visit our legacy guide.
Partner capabilities
| Capability | Details |
|---|---|
| Company type | Performance marketing platform |
| Deep linking | Supported |
| Attribution | Click-through attribution |
| Ad campaign types | Acquisition campaigns |
| Ad formats | Contact IconPeak for details. |
| Click types | Server-side click |
| Supported platforms | iOS, Android, Windows |
| Link wrapping | Not supported |
| Cost ingestion support | Supported (via email import or manual file upload) |
| Pricing models | CPI |
Before you begin
To set up the IconPeak integration, you need:
- Ad partner integrations enabled for your Branch account. Availability varies by Branch plan. See Branch pricing or contact your Branch representative.
- A Branch account with access to Configuration > Ad Partners and admin permissions to enable and configure integrations.
- An IconPeak account with admin access.
Enable IconPeak
To begin, navigate to Configuration > Ad Partners > IconPeak.
IconPeak doesn't require credentials to activate. The integration is enabled automatically when you select Enable IconPeak on the IconPeak page.
Configure attribution
To configure attribution windows, select the Attribution windows tab on the IconPeak page.
To minimize discrepancies when comparing Branch and IconPeak reporting, match your Branch attribution windows to the settings in your IconPeak account.
| Attribution type | Default | IconPeak's recommendation |
|---|---|---|
| Click to start session | 1 day | 90 days |
| Click to install | 7 days | 30 days |
| Click to conversion event | 30 days | 90 days |
| Impression to start session | 1 day | 1 day |
| Impression to install | 1 day | 1 day |
| Impression to conversion event | 7 days | 1 day |
| Deep linking duration | 120 minutes | — |
For more information, follow Configure attribution in the general Ad Partner Integration Guide.
Configure postbacks
Enabling IconPeak automatically activates postbacks for INSTALL. The default postback URL template is:
https://postback.mynewrotationlink.com/postback?click_id=${ (last_attributed_touch_data.~click_id)! }To add postbacks for additional events or to customize behavior, follow Configure postbacks in the general Ad Partner Integration Guide.
Create a Branch Ad Link
Create a Branch Ad Link to use in your IconPeak campaigns. Branch uses the link to attribute clicks and deep link users into your app.
Follow Create Ad Links.
Verify your data
After your integration is connected and events are flowing, you can verify data is reaching Branch:
- In Branch Liveview: confirm that events from your app appear in real time. This is the fastest way to confirm SDK events are firing.
- In Branch Analysis dashboards: review attributed installs and events where
Ad Partner Name = IconPeak. - In IconPeak: confirm that forwarded events are appearing in your IconPeak attribution reporting.
Data mappings
Campaign data
Branch populates the following fields from IconPeak campaign data.
| Branch field | Partner data |
|---|---|
~advertising_partner_name | "IconPeak" (static) |