Branch Webhooks Integration

Branch’s webhook system allows you to export install and down-funnel event data as it occurs. You can import this data into your internal systems for analysis. You simply need to specify a URL for the POST or GET requests.

NOTE: Access to Branch’s webhook system is included in their Advanced Data Feeds add-on.

Support References:

• Branch Webhooks Documentation
• Branch Postback Macros & Functions Documentation

---

Log in to Branch

1. Log in to your Branch account at dashboard.branch.io/login.

---

Webhook Setup

---

Configure the JSON Payload

1. Define your custom POST body using static and macro parameters.
   • Macros like ${ip}, ${user_agent}, ${timestamp} will be replaced automatically by Branch.

{
  "product": "xyz", // Static
  "eventName": "purchase", // Static
  "device_id": "${idfa_or_aaid}", // Dynamic
  "ip_address": "${ip}", // Dynamic
  "useragent": "${user_agent}", // Dynamic
  "timestamp": "${timestamp}" // Dynamic
}

---

Set Authentication Header

1. Below the payload section, there is a Headers section in the webhook configuration. Add your header like this:
   • Key: Authentication-Key
   • Value: YOUR_API_KEY

---

Select Events to Trigger the Webhook

1. Choose specific events this webhook should trigger on (e.g., install, open, purchase, etc.).

NOTE: You can map it to standard or custom events.

2. Event Mapping: Create a separate webhook trigger mapped to each of your partner’s supported event names. Please reach out to your Atlas Publisher for their supported event names.

---

Save and Test

1. Click Save Feed.
2. Trigger a test event via your app or emulator.
3. Confirm delivery in Branch’s Event Tester or by monitoring logs at your endpoint.

---

Additional Information

Email atlassupport@kochava.com for support or reference Branch’s Webhooks documentation for more information on Branch’s Webhooks.