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 AdAction (New)

Prev Next

Overview

AdAction is a US-based mobile performance marketing company that provides user acquisition, app monetization, and rewarded engagement products. Connect AdAction 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 AdAction in the new Branch experience. For information on AdAction in legacy Branch, visit our legacy guide.

Partner capabilities

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    
                   

Capability

               
                   

Details

               
                   

Company type

               
                   

Ad network, publisher

               
                   

Deep linking

               
                   

Supported

               
                   

Attribution

               
                   

Click-through attribution

               
                   

Ad campaign types

               
                   

Acquisition campaigns

               
                   

Ad formats

               
                   

Banner, Interstitial, Video, App of Day

               
                   

Click types

               
                   

Server-side click

               
                   

Supported platforms

               
                   

iOS, Android, Amazon, Windows, macOS

               
                   

Link wrapping

               
                   

Supported

               
                   

Cost ingestion support

               
                   

Supported (via click/impression tracking link)

               
                   

Pricing models

               
                   

CPI, CPC, CPA

               

Before you begin

To set up the AdAction 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 AdAction account with admin access. You'll need the following credential, available from your AdAction account manager: Client Security Token.

       

Enable AdAction

To begin, navigate to Configuration > Ad Partners > AdAction Interactive.

Enter your Client Security Token, then select Enable AdAction Interactive on the AdAction page. Contact your AdAction account manager if you need this value.

Configure attribution

By default, AdAction uses your global app attribution settings. To set attribution windows specific to AdAction, 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 AdAction automatically activates postbacks, including INSTALL and PURCHASE. The default postback URL template is:

https://tracking.cswsaa.com/aff_lsr?transaction_id=${ (last_attributed_touch_data.~click_id)! }&security_token=${ (ad_network.credentials.client_security_token)! }&adv_sub2=${ (user_data.geo_country_code)! }&adv_sub3=${ (timestamp/1000)?long }&adv_sub=${ (user_data.app_version)! }
   
       

Note: Goal ID required

   
   

AdAction requires the Goal ID that corresponds to each postback. Enter these values and save. Contact your AdAction account manager to obtain them.

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

       
  •    
  •        

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

       

Data mappings

Campaign data

Branch populates the following fields from AdAction campaign data.

                                                                                                                                                                            
                   

Branch field

               
                   

Partner data

               
                   

~advertising_partner_name

               
                   

"AdAction" (static)

               

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

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            
                   

Branch parameter

               
                   

Link placeholder

               
                   

Click ID

               
                   

{transaction_id}

               
                   

Custom Link Macro

               
                   

{goal_id}

               
                   

Click IP Address

               
                   

{ip}

               
                   

Secondary Publisher

               
                   

{affiliate_id}_{source}

               
                   

Creative Name

               
                   

{aff_sub5}

               
                   

Cost Model

               
                   

CPI

               
                   

Cost Currency

               
                   

USD

               
                   

Cost Value

               
                   

{revenue}

               
                   

Campaign ID

               
                   

{offer_id}