Beta
Social CMS with Branch is currently in Beta. Please be aware that there may be unexpected bugs/behaviors until the full release. Please reach out to your Branch account manager to get access to Social CMS.
Overview
Partners of Branch
Supported Partners:
Prerequisites
In order to enable this feature, you must have done the following:
Obtain your Partner
$3p
parameter:Sprinkler:
s_sprinklr
True Anthem:
s_true_anthem
You will need the mutual customer's
branch_key
. It is up to you to request this from the mutual customer, and it can be obtained from their Branch Dashboard.
Link Creation Options
1. Create a Single URL
Using your preferred method of configuring APIs, utilize Branch's Deep Linking API in order to configure your link. For this implementation, we will utilize the Create Endpoint.
Create Endpoint
POST /v1/url
Host: api2.branch.io
Request Headers:
Header | Value | Required |
---|---|---|
Content-Type | application/json | Yes |
Request Body Parameters:
Parameter | Description | Required |
---|---|---|
branch_key | The Branch key of the originating app; from your Branch Settings Dashboard | Yes |
data | The dictionary to embed with the link. Accessed as session or install parameters from the SDK. Use the data dictionary for all link control parameters that you'll find here. | No |
alias | Instead of our standard encoded short url, you can specify the vanity alias. For example, instead of a random string of characters/integers, you can set the vanity alias as .app.link/devonaustin. Aliases are enforced to be unique and immutable per domain, and per link - they cannot be reused unless deleted. Max 128 characters NOTE: If you POST to the this endpoint with the same alias, and a matching set of other POST parameters to an existing aliased link, the original will be returned to you. If it clashes and you don't specify a match, will return a HTTP 409 error. | No |
type |
Default is set to 0, which is the standard Branch links created via our SDK.git | No |
duration | In seconds. Only set this key if you want to override the match duration for deep link matching. This is the time that Branch allows a click to remain outstanding and be eligible to be matched with a new app session. This is default set to 7200 (2 hours) | No |
It's important to tag your links with an organized structure of analytics labels so that the data appears consistent and readable in the dashboard. | No | |
identity | The identity used to identify the user. If the link is not tied to an identity, there's no need to specify an identity.Max 127 characters | No |
Example Request/Response:
curl --request POST \
--url 'https://api2.branch.io/v1/url' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '
{
"branch_key": "key_live_hkDytPACtipny3N9XmnbZlapBDdj4WIL",
"data": {
"$3p": "s_sprinklr"
},
"campaign": "myCampaign",
"channel": "flyer_1",
"feature": "social"
}
'
{
"url": "https://branchster.app.link/lf0rdP55Yrb"
}
2. Create Your Link
Once you have your API set up