English (US) 日本語 한국어 简体中文

Articles in this section

Branch

Event Forwarding

Below is our step-by-step guide to activation of event forwarding from Branch to Remerge. In case of any questions, please reach out to your Remerge Account Manager.

Please note: Tune has recently migrated to Branch and as part of this migration, you may now utilize the Branch portal to forward us real-time events from both Branch and Tune SDKs. In case you have implemented both SDKs in your app, said SDKs will be configured as two separate apps in the Branch dashboard.

1. Enable Integration 

  • Log in to your Branch Account, go to CHANNELS & LINKS, located on the upper left corner of the dashboard's menu and click on Ads > Partner Management. 

    Screen_Shot_2019-07-02_at_5.17.59_PM.png

  • A list of integrated partners will appear. Go to the Ad Partners window, and select Remerge by entering it in the search field.  

    Screen_Shot_2019-07-01_at_5.24.02_PM.png

  • Click on the Remerge logo to open our configuration window.

            Screen_Shot_2019-06-27_at_3.38.53_PM.png

2. Configure Event Forwarding

  • Branch's configuration window consists of four tabs: ACCOUNT SETTINGS, POSTBACK CONFIG, LINK PARAMETERS, and ATTRIBUTION WINDOWS. Event forwarding from Branch to Remerge is achieved by turning on the postbacks, which takes place on the POSTBACK CONFIG tab. The tab you are located on is always both highlighted and underlined as shown below:

    Screen_Shot_2019-07-01_at_5.42.51_PM.png

  • Select and send us your in-app event postbacks by ticking the ENABLE and ALL EVENTS boxes located next to each of the event postbacks. Please note: Install and open events are automatically tracked via the Branch's SDK. However, Custom Events (such as registration or purchase) are tracked only once you integrate them into your app.

    Screen_Shot_2019-07-01_at_5.46.47_PM.png

  • To add app-specific postbacks for custom events, click on the Add New Postback button at the bottom of the screen.

    Screen_Shot_2019-07-01_at_11.47.36_PM.png

  • Select an event, enter a Postback URL > click on Save. This will be the event that triggers your new postback.

    Screen_Shot_2019-07-01_at_11.47.45_PM.png

3. Edit Postbacks 

Edit your postbacks to ensure you are not restricting your events by any rules and/or in case of additional data, you wish to forward to Remerge. Edit postbacks by following Branch's postback templating instructions, and clicking SAVE. The postbacks in the Universal Ads interface follow the same syntax as Webhooks in Data Feeds.

  • Remain on the POSTBACK CONFIG tab. Go to ACTIONS, located to the right of the POSTBACK URL.
  • Click on the three-doted box > Advanced Edit > Done as displayed below:

    Screen_Shot_2019-07-02_at_5.23.41_PM.png

    Screen_Shot_2019-07-02_at_1.46.17_PM.png

Standard postback example:

https://remerge.events/event?app_id=<@loop data=app.app_bundles val="bundle"><#if user_data.os == bundle.os><#if bundle.os=="ANDROID">${(bundle.android.package_name)!}<#elseif bundle.os == "IOS">${(bundle.ios.itunes_id?substring(2))!}</#if><@break/></#if></@loop>&event=${ (name)! }&ts=${ (timestamp/1000)?long }&partner=branch&key=X66S05UQ&idfa=${ (user_data.idfa)! }&aaid=${ (user_data.aaid)! }&country=${ (user_data.geo_country_code)! }&os_name=${ (user_data.os)! }&os_version=${ (user_data.os_version)! }&app_version=${ (user_data.app_version)! }&network=branch&campaign=${ (last_attributed_touch_data.~campaign_id)! }&ad=${ (last_attributed_touch_data.~ad_set_id)! }&creative=${ (last_attributed_touch_data.~creative_id)! }&click_id=${ (last_attributed_touch_data.~click_id)! }&is_attributed=<#if (last_attributed_touch_data.$3p)! == (ad_network.machine_name)!>1<#else>0</#if>&network=${ last_attributed_touch_data.$3p }&partner_attribution_method=<#if last_attributed_touch_type == "CLICK">click<#elseif last_attributed_touch_type == "IMPRESSION">view</#if>&data=<@urlencode><#if content_items?has_content><@loop data=content_items val='attributes'>{"id":<@json>${(attributes.$product_name)!}</@json>,"price":<@json>${(attributes.$price)!}</@json>,"quantity":<@json>${(attributes.$quantity)!}</@json>}<@sep>,</@sep></@loop></#if></@urlencode>

Please be advised:  

  •  The above-mentioned template works for both Tune & Branch SDKs. That being said:

    • If you have migrated from Tune to Branch, your postback template will start with https://remerge.events/tune.
    • In case you are utilizing the Tune structure and wish to make changes, ensure to utilize the Branch postback template, as per the above example. 

4. Confirm Setup 

  • Please reach out to your Remerge Account Manager to confirm the arrival of events.