Branch

Branch is an affiliate network. Its own documentation: https://help.branch.io/docs/postback-macros-functions.

The offer’s URL

The network’s link takes the click id in the query parameter ~click_id.

How conversions get back to Tallyray

Method GET. The portal writes the URL for you to paste into the network. Each Tallyray parameter, and the network macro it reads:

Tallyray parameter	Network macro
`cid`	`${(last_attributed_touch_data.~click_id)!}`
`et`	`${(name)!}`
`payout`	`${(event_data.revenue)!}`
`currency`	`${(event_data.currency)!}`
`txid`	`${(id)!}`

Event names, as the network sends them, and what they mean here:

Network	Tallyray
`INSTALL`	`install`
`REINSTALL`	`reengagement`
`PURCHASE`	`sale`
`COMPLETE_REGISTRATION`	`registration`
`SUBSCRIBE`	`subscription`

An event name not listed reads as one of your event types’ codes; a postback with no event is of kind install.

Statuses:

Network	Tallyray
`approved`	`approved`

A postback with no status is approved; one with another is refused.

Tallyray keeps only the parameters this template reads, and drops the rest.

Build the postback URL

Your tracking domain

Postback URL

https://trk.example.com/postback/npt_…?cid=${(last_attributed_touch_data.~click_id)!}&et=${(name)!}&payout=${(event_data.revenue)!}&currency=${(event_data.currency)!}&txid=${(id)!}

Branch calls this URL for every conversion and every change to one. Replace npt_… with the token the portal shows, once, when it is made.

How to connect it

Nothing to authorize: the network sends its postbacks to a URL Tallyray gives you.

This page describes version 1 of the Branch template, the latest published. The version your connection runs is the one your administrators approved, and the portal shows it.