Logging Custom Events

Post
/event/custom

This endpoint is used to log custom events

Body parameters
Expand All
object
branch_key
string Required

The Branch Key of the originating app obtained in your Account Settings

Examplekey_live_xxxx
name
string Required

The name of the event to log. Can be a string of custom event name. For instance "picture swiped".

ExampleCustomEventTest
user_data
object (user_data_standard)
os
string

One of the following operating system e.g. Android, iOS,MAC_OS,LINUX,WINDOWS etc.

ExampleAndroid
os_version
string

The version of the operating system.

Example12.4.0
environment
string

usually FULL_APP

ExampleFULL_APP
aaid
string

The Android/Google advertising ID.

Exampleabcdabcd-0123-0123-00f0-000000000000
android_id
string

Android hardware ID

Examplea12300000000
idfa
string

iOS advertising ID

idfv
string

iOS vendor ID

limit_ad_tracking
boolean

true if the partner has opted to not be tracked by advertisers

ExampleFalse
user_agent
string

The user agent of the browser or app where the event occurred. Usually associated with a webview.

ExampleMozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko)
browser_fingerprint_id
string

Branch internal-only field for tracking browsers.

Example00000000
http_origin
string

The current page url where Web SDK logged web session start.

Examplehttp_origin
http_referrer
string

The referral url that led to the current page where Web SDK logged web session start.

developer_identity
string

The developer-specified identity for a user.

Exampleuser123
country
string

The country code of the user, usually based on device settings or user agent string.

ExampleUS
language
string

The language code of the user, usually based on device settings or user agent string.

Exampleen
ip
string

The ip address for the device where the event occurred

Example000.000.0.0
local_ip
string

Android only - local ip of the device

Example000.000.0.0
brand
string

The brand of the device

ExampleLGE
randomized_device_token
string

Branch internal-only field for tracking devices.

Example00000000
app_version
string

The app version downloaded by the user.

Example1.0.0
model
string

The model of the device.

ExampleNexus 5X
screen_dpi
integer

The screen's DPI.

Example420
screen_height
integer

The screen's height.

Example1794
screen_width
integer

The screen's width.

Example1080
dma_eea
boolean

Whether European regulations, including the DMA, apply to this user and conversion. Required if EU regulations apply to this user.

ExampleTrue
dma_ad_personalization
boolean

Whether end user has granted or denied ads personalization consent. Required if dma_eea is set to true (i.e., EU regulations apply to this user).

ExampleTrue
dma_ad_user_data
boolean

Whether end user has granted or denied consent for 3P transmission of user level data for ads. Required if dma_eea is set to true (i.e., EU regulations apply to this user).

ExampleTrue
custom_data
object

Custom data contain key-value pairs of additional information

property*
string additionalProperties
meta_data
object
property*
string additionalProperties
event_data
object (event_data_standard)
transaction_id
string

The partner-specified transaction id for their internal use

Example00000000
revenue
number

The partner-specified reported revenue for the event.

Example1.5
currency
string

Currency that revenue, price, shipping, tax were originally reported in by the partner

ExampleUSD
shipping
number

Shipping cost associated with the transaction.

Example10.2
tax
number

Total tax associated with the transaction.

Example12.3
coupon
string

Transaction coupon redeemed with the transaction (e.g. "SPRING2017")

Examplecoupon
affiliation
string

Store or affiliation from which this transaction occurred (e.g. Google Store)

Exampletest_affiliation
description
string

Description associated with the event, not necessarily specific to any individual content items (see below)

ExampleEvent_description
search_query
string

Additional search queries.

ExampleTest Search query
Responses
200

Ok

400

Authentication Failed

Result
"{\n    \"error\": {\n        \"message\": \"Authentication failed !\",\n        \"code\": 400\n    }\n}"
Expand All
object
error
object (inline_response_400_error)
message
string
ExampleAuthentication failed !
code
integer
Example400
429

Rate Limit Reached

Result
"{\n    \"error\": {\n        \"code\": 429,\n        \"message\": \"Rate limit reached.\"\n    }\n}"
Expand All
object
error
object (inline_response_400_error)
message
string
ExampleAuthentication failed !
code
integer
Example400