Documentation Index

Fetch the complete documentation index at: https://help.branch.io/llms.txt

Use this file to discover all available pages before exploring further.

Enable Impact (New)

Prev Next

Overview

Impact is a partnership-management platform (formerly Impact Radius) used to manage affiliate, influencer, and referral partnerships. Connect Impact 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 Impact in the new Branch experience. For information on Impact in legacy Branch, visit our legacy guide.

Partner capabilities

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    
                   

Capability

               
                   

Details

               
                   

Company type

               
                   

Affiliate network

               
                   

Deep linking

               
                   

Supported

               
                   

Attribution

               
                   

Click-through attribution

               
                   

Ad campaign types

               
                   

Acquisition campaigns, Retargeting campaigns

               
                   

Ad formats

               
                   

Desktop web inventory, In-app inventory, Mobile web inventory

               
                   

Click types

               
                   

Client-side click

               
                   

Supported platforms

               
                   

iOS, Android, Windows

               
                   

Link wrapping

               
                   

Not supported

               
                   

Cost ingestion support

               
                   

Not supported

               
                   

Pricing models

               
                   

CPI, CPC, CPM, CPA, CPV

               

Before you begin

To set up the Impact integration, you need:

       
  •        

    Branch's Performance product enabled for your Branch account. Contact your Branch account manager or visit https://branch.io/pricing.

       
  •    
  •        

    A Branch account with access to Configuration > Ad Partners and admin permissions to enable and configure integrations.

       
  •    
  •        

    An Impact account with admin access. You'll need the following credentials, available from your Impact account manager: iOS Tracker, Android Tracker, Account SID, Authorization Token.

       

Enable Impact

To begin, navigate to Configuration > Ad Partners > Impact.

Enter your iOS Tracker, Android Tracker, Account SID, Authorization Token, then select Enable Impact on the Impact page. Contact your Impact account manager if you need these values.

Configure attribution

By default, Impact uses your global app attribution settings. To set attribution windows specific to Impact, enable the Override global app settings toggle on the Attribution windows tab.

For more information, follow Configure attribution in the general Ad Partner Integration Guide.

Configure postbacks

Enabling Impact automatically activates postbacks, including INSTALL and PURCHASE. The default postback URL template is:

https://${ (ad_network.credentials.Account_SID)! }:${ (ad_network.credentials.Authorization_Token)! }@api.impactradius.com/Advertisers/${ (ad_network.credentials.Account_SID)! }/Conversions/?ActionTrackerId=<@loop data=app.app_bundles val="bundle"><#if user_data.os == bundle.os><#if bundle.os=="IOS">${ (ad_network.credentials.ios_Tracker)! }<#elseif bundle.os == "ANDROID">${ (ad_network.credentials.android_Tracker)! }</#if><@break/></#if></@loop>&AppPackage=<@loop data=app.app_bundles val="bundle"><#if user_data.os == bundle.os><#if bundle.os=="IOS"><@break/><#elseif bundle.os == "ANDROID">${(bundle.android.package_name)!}</#if><@break/></#if></@loop>&AppName=${ (app.name)! }&EventCode=${ (name)! }&EventDate=NOW&AndroidId=${ (user_data.android_id)! }&AppleIfa=${ (user_data.idfa)! }&GoogAid=${ (user_data.aaid)! }&AppInstallRef=${ (last_attributed_touch_data.AppInstallRef)! }&DeviceOs=${ (user_data.os)! }&DeviceOsVer=${ (user_data.os_version)! }&IpAddressCarrier=${ (user_data.ip)! }&ClickId=${ (last_attributed_touch_data.~click_id)! }&Oid=${ (id)! }&subID1=${ (last_attributed_touch_data.subID1)! }&subID2=${ (last_attributed_touch_data.subID2)! }&subID3=${ (last_attributed_touch_data.subID3)! }&ShareId=${ (last_attributed_touch_data.ShareId)! }&IntegrationSource=BRANCH

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 to use in your Impact campaigns. Branch uses the link to attribute clicks and deep link users into your app.

Follow Create a Branch Ad Link in the general Ad Partner Integration Guide.

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

       
  •    
  •        

    In Impact: confirm that forwarded events are appearing in your Impact attribution reporting.

       

Data mappings

Campaign data

Branch populates the following fields from Impact campaign data.

                                                                                                                                                                            
                   

Branch field

               
                   

Partner data

               
                   

~advertising_partner_name

               
                   

"Impact" (static)

               

By default, Branch automatically appends these link parameters to Impact ad links. When a user clicks the link, Impact provides the corresponding values, which Branch ingests and uses for attribution and reporting.

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    
                   

Branch parameter

               
                   

Link placeholder

               
                   

Custom Link Macro

               
                   

{AppInstallRef}

               
                   

Click ID

               
                   

{clickid}

               
                   

Custom Link Macro

               
                   

{subid1}

               
                   

Custom Link Macro

               
                   

{subid2}

               
                   

Custom Link Macro

               
                   

{subid3}

               
                   

Custom Link Macro

               
                   

{sharedid}

               
                   

Secondary Publisher

               
                   

{irmpname}

               
                   

Campaign ID

               
                   

{ircid}