This guide walks you through connecting AppSamurai as an ad partner inside your Branch dashboard, so Branch can attribute installs and in-app events back to your AppSamurai campaigns and forward those conversions to AppSamurai through postbacks.

Before you start

  • You have access to a Branch dashboard with the Performance (Ads) product enabled.
  • The Branch SDK is already integrated in your iOS and Android app, and you are tracking the events you want to optimise on.
  • You have an active AppSamurai campaign. If any of the account details below are missing, your AppSamurai account manager can provide them.

1. Enable AppSamurai as an ad partner

  1. In the Branch dashboard, open Ads and select Partner Management from the sidebar. The Branch Partner Management screen with the Ad Partners sidebar and ad partner settings
  2. Search for AppSamurai in the Ad Partners search box, select it from the results, and click Save & Enable.

2. Add your account credentials

Some partners require account credentials before they can be enabled; others do not. If Branch prompts you for an Account ID (or similar), enter the value your AppSamurai account manager gave you. These credentials are added to your postbacks automatically. Click Save & Enable to finish.

Entering the Account ID under Ad Account Information and clicking Save and Enable in Branch

3. Confirm the postbacks

  1. Open the Postback Config tab for AppSamurai. Basic postbacks for events such as INSTALL and PURCHASE are switched on automatically when you enable the partner.
  2. Review the event list and enable any additional events you want AppSamurai to receive, for example OPEN, ACHIEVE_LEVEL, COMPLETE_TUTORIAL or COMPLETE_REGISTRATION, then click Save. The Branch Postback Config tab listing INSTALL, PURCHASE, OPEN and other events with their postbacks enabled

To confirm a postback is wired up correctly, use the Postback Testing tab, which verifies both the postback and your partner credentials before you go live.

4. Create your AppSamurai ad link

AppSamurai is a non-SAN partner, so Branch needs one of its ad links in your campaigns to attribute conversions. From the AppSamurai partner settings, click Create Ad Link to generate the link, then share it with your AppSamurai account manager to run in your campaigns.

5. Verify data is being sent

  1. Find your AppSamurai partner key: open the Account Settings tab for AppSamurai in Partner Management and copy the Partner Identifier ($3p Value). The Account Settings tab showing the Partner Identifier or 3p Value for the ad partner
  2. Go to Liveview > Webhook Records and add a filter of ad partner (3p) equals your AppSamurai key. Add the Webhook Response Code column to read the result, plus the IDFA/AAID and Click ID columns to confirm the macros are being populated. Branch Liveview Webhook Records filtered by ad partner, showing 201 success response codes

A response code in the 200 range means the postback was delivered successfully; a 400-range code means there was an error worth reviewing.

Give it time

Data can take a little while to move through Branch's attribution system and reach AppSamurai. If a test conversion has not appeared after about 30 minutes, revisit the steps above to check nothing was missed. For anything specific to your account, contact your AppSamurai account manager or email adops@appsamurai.com.

You can also refer to Branch's own Ad Partner Integration Guide for the latest partner-side details.