Overview
Attention
Branch's new experience is rolling out in phases, so your interface may differ. This article covers the legacy version of ad partner setup. For the new version, see Ad Partners (New).
AdColony is the premier in-app marketplace for brands and agencies to reach consumers on the most intimate screen in consumers' lives with 100% measurable, transparent, and brand-safe inventory with industry-leading viewability.
Partner Capabilities
| Capability | Details |
|---|---|
| Company Type | Ad Network |
| Deep Linking | Supported |
| Attribution | • Click-Through Attribution • View-Through Attribution |
| Ad Campaign Types | Acquisition Campaigns |
| Ad Formats | Video |
| Click Types | Client-side click |
| Supported Platforms | • iOS • Android • Amazon |
| Link Wrapping | Not Supported |
| Cost Ingestion Support | Supported |
| Cost Ingestion Types | • • API • Email Import • Manual File Upload |
| Pricing Models | • CPI • CPM |
Before you begin
In order to enable AdColony, you need to have completed the following:
Created a Branch Dashboard.
Have Branch's Performance product enabled for your Branch Account.
Implemented the Branch SDK into your mobile app (iOS | Android).
Running campaigns through AdColony.
Enable AdColony
1. Enable AdColony in Branch
In the Branch Dashboard under Ads > Partner Management, find/search for AdColony. If you're already logged into the Branch Dashboard, you can also click here to go there directly.
Click the Save & Enable button.
2. Configure Postbacks
Enabling AdColony will automatically enable the following postbacks:
- INSTALL
- OPEN
You can configure these postbacks or add more under the Postback Config tab.
Send All Events
Optionally, you can check the checkbox for a given postback for sending all events. When checked, all events will be sent regardless of attribution. Otherwise, the postback will only fire for events attributed to AdColony.
Adding Postbacks
Click the Add New Postback button at the bottom of the screen. A modal will appear that will allow you to select an event that you are tracking with the Branch SDKs (including Custom Events).
For more in-depth postback configurations, view our guides:
3. Configure Attribution Windows
After configuring your events, navigate to the Attribution Windows tab to set windows by attribution type.
Recommended Attribution Windows
| Attribution Type | Window |
|---|---|
| click to session start | 90 days |
| click to install | 30 days |
| click to conversion event | 90 days |
| impression to session start | 1 day |
| impression to install | 1 day |
| impression to conversion event | 1 day |
4. Create Branch Ad Link
Next, you'll need to create a Branch Ad Link for your AdColony campaigns in order for Branch to properly attribute conversions.
The Branch Ad Link you create will be placed in your AdColony campaign.
5. Verify Data in Branch
After launching your AdColony campaigns, and conversions begin to happen, you'll want to verify data is being sent from Branch to AdColony. You can look at the Branch Dashboard's Liveview Webhook Records and apply the following filter:
| Filter | Operator | Value |
|---|---|---|
| ad partner (3p) | equals | a_adcolony |
Once applied, data should flow through the Liveview, and you can see the data being sent to AdColony from Branch.