App Engagement Reports

Overview

Branch can send you a data file detailing App Engagement events for a specified time period. Branch sends the file daily by default, but you can choose to receive it less frequently. Each row records an event with event_type triggered at event_timestamp during an App's session_id by a user whose WorkerID = external_id.

File Name Structure

\[file type}\_file_YYYYMMDD_YYYYMMDD_YYYYMMDDhhmmss.csv

1st YYYYMMDD is start date of file (>=)

2nd YYYYMMDD is end date of file (\<)

YYYYMMDDhhmmss is when file was pulled

start and end date will be filled with 00000000 for historic pull

Column Details

Column NameTypeNullableExample DataDescription
event_timestampTIMESTAMPN2021-04-23T13:07:15ZThe time the event occurred.
event_typeTEXTNintroscreen_login_successA short readable name of the event's type.
event_propertyTEXTYmerchant_name, offer_typeAn extra value that is sometimes required to differentiate the use case for a given event_type.
external_idTEXTNfirst_example_userThe Worker's ID.
session_idTEXTNdd19d734-9d9a-9dc6-e110-eaa0835b297bA session identifier that will remain consistent, from when a user opens the app, to when the app enters the background. Will refresh upon entering a new app session.