Oracle Responsys
Connect Branch and Responsys to enable a seamless email-to-app linking experience.

Overview
모든 소비자에게 다가갈 수 있도록 상황에 맞는 디지털 마케팅 캠페인을 설계하고 실행하십시오. Oracle Responsys는 모든 채널에서 상호 작용을 관리, 맞춤화 및 조직화하여 코드, 복잡한 기술 교육 또는 다른 전문가에 대한 의존 없이 중요한 순간에 유용한 메시지를 적시 전달할 수 있도록 도와줍니다.
작동 방식
- User clicks on a link in an email from their mobile mail client (Gmail, Apple Mail, etc.)
- If the user has the app installed and the link has a corresponding screen in the app, the app will open and deep link the user to the right content.
- Ex. Product detail page, category shopping page, etc.
- If the user does not have the app installed or the link only corresponds to a screen on the web, the user is routed to the website using their default mobile web browser.
- Ex. Unsubscribe link, privacy policy, etc.
전제 조건
Required Roles
Branch's Universal Email requires the following roles involved in order to enable:
- Developers
- CRM/Email Team
- Oracle Responsys Account Manager / Support Team
In order to enable Responsys, you need to have completed the following:
- Admin access to your Branch Dashboard.
- Enabled Universal Email for your Branch account.
- Contact your Branch account manager or visit https://branch.io/pricing
- Implemented the Branch SDK into your mobile app (iOS | Android)
- Set Up Deep Link Routing. How your mobile app routes to in-app content will determine how you will create and tag your Branch Links.
- Track events
- Obtained or set up your Responsys click tracking domain (CTD). Reach out to your Responsys account manager for assistance on this.
Enable Oracle Responsys
Connect Oracle Responsys Service in Branch
In the Branch Dashboard in Email → Manager tab, find Oracle Responsys and click Enable

Input Click Tracking Domain
클릭 트래킹 도메인을 사용하면 이메일 열기 및 링크 클릭에 대한 인게이지먼트를 측정할 수 있습니다.
Oracle Responsys 연동을 위해서는 다음을 제공해야 합니다.
- 트래킹 도메인 클릭 -이메일의 링크에 대해 Oracle Responsys에서 사용하는 도메인
Additionally, Responsys hosts the AASA file for your click tracking domain. You can provide your Responsys account manager's email for Branch to send the AASA file.
Click Tracking Domain
- Remove
https://
when adding your click tracking domain.- Never add the same CTD to both your Live and Test Branch environments.
- You can enable the integration with multiple CTDs, if needed, but you cannot add the same CTD to multiple Branch Dashboards or ESP integrations.
Configure your App
Add your Responsys CTD to your Associated Domains
For your iOS App, you must add the CTD to the Associated Domains. Additional details can be found here.
웹 전용 콘텐츠 앱 코드 처리 추가하기
If you have links to content that exist only on the web and not in the app (for example, a temporary marketing webpage that isn't in the app), then this code snippet will ensure all links that have not had deep linking script applied will open in a browser. Details can be found here.
Return YES
to continueUserActivity
YES
to continueUserActivity
Additionally, you will need to add the CTD to your iOS app's info.plist file. Additional details can be found here.
Point DNS CNAME to Branch
DNS CNAME을 구성하는 방법에 대한 웹 호스팅 제공 업체의 지침을 따르세요.
Update the DNS CNAME and point it to thirdparty.bnc.lt
. Once the CNAME record is added, please allow up to an hour for Branch to generate SSL and AASA files for your click tracking domain.
중요한 CNAME 정보
- CNAME을 추가하기 전에 Branch 대시보드를 활성화하고 CTD를 반영해야 합니다.
- CTD에 이미 SSL 설정이 있는 경우, 보안 인증서가 제 3자가 기존 도메인을 대신하여 CSR을 제출하는 것을 허용하는지 확인합니다. 그렇지 않은 경우, Branch의 서포트팀에 문의하여 수동으로 Branch에 SSL 인증서를 제공하도록 조정하십시오.
- CNAME이 추가되면 Branch는 클릭 트래킹 도메인에 대한 SSL 인증서 및 AASA 파일을 자동 생성합니다. CNAME을 변경한 후 SSL 오류를 해결하는 데 최대 1시간이 걸릴 수 있습니다. 해당 시간 동안 클릭 트래킹 도메인의 링크 리다이렉션은 계정의 General Configuration 섹션에서 제공한 기본 URL로 리다이렉션됩니다.
- 이메일 클릭 트래픽이 활발한 라이브 도메인에 해당 변경을 적용하는 경우, 클릭 트래픽이 적은 시간대에 도메인 이름(CNAME) 변경이 이루어지도록 스케줄을 정합니다.
Add Branch Links to your Emails
Before you start sending your email campaigns, you need to determine what flow you want the user to experience and flag your email links accordingly.
Universal Email 솔루션 + Responsys와 호환되는 Branch 링크를 만들 수 있는 몇 가지 방법이 있습니다. 템플릿의 웹 URL을 이로 바꿔야 합니다. Branch 링크를 만들려면 다음 중 하나를 수행하십시오:
- Branch Responsys SDK 사용
- 이메일과 호환되는 일반 Branch 링크 만들기
- 이메일 템플릿을 변경하지 않고 API를 통해 이메일 링크 생성
- 이메일의 모든 웹 링크를 딥링크(Deep Link)로 전환
Responsys uses the shortcode e_rs
for links in emails - please use this in place of e_xx
in the guide below.
1. Branch Responsys SDK 사용
이 단계에서는 이메일에 딥링크(Deep Link)를 매우 쉽게 생성할 수있는 SDK를 업로드합니다. 이를 위해서는 EMD (Email Message Designer)가 활성화된 계정이 필요합니다.
- Work with your Branch account manager to modify the following code snippet, replacing
DOMAIN-HERE
with your Branch base domain:
<#macro deeplink link_to_be_wrapped><#assign branch_base_url="https://DOMAIN-HERE/3p?%243p=e_rs"><#assign final_link=branch_base_url + "&%24original_url=" + link_to_be_wrapped?url("ISO-8859-1")><a href="${final_link}"><#nested></a></#macro> <#macro tracked_deeplink link_to_be_wrapped><#assign branch_base_url="https://DOMAIN-HERE/3p?%243p=e_rs"><#assign deeplink=branch_base_url + "&%24original_url=" + link_to_be_wrapped?url("ISO-8859-1")></#macro>
-
Responsys 계정에 로그인하십시오.
-
Responsys 대시보드에서 콘텐츠 라이브러리를 엽니다. 기본 페이지의 바로가기 화면을 통해 액세스할 수도 있습니다.
-
Once you are in the Content Manager, you’ll see a list of folders where content is stored. Under All Content, create a new folder named
Branch_SDK
: -
Branch_SDK 폴더를 선택한 다음 Create Document 을 클릭합니다.
-
Create Document 창에서 :
-
Enter
branch-sdk
in the “Document Name” field. -
Content Box 에서 모든 텍스트를 삭제합니다.
-
복사한 스니펫을 1 에 붙여넣습니다.
-
Save를 클릭하십시오.
-
이제 딥링크(Deep Link) 스크립트를 성공적으로 만들었습니다. 파일 구조는 다음과 같아야 합니다.
Responsys 이메일 템플릿 설정
이 코드는 "Branch script" 라고 리퍼드(Referred) 됩니다 - 이 스크립트는 웹 URL을 딥링크(Deep Link)로 전환합니다.
Responsys 연동을 위해서는 두 곳에 이메일 템플릿 코드를 추가해야 합니다.
- 이메일 템플릿 상단
- 하이퍼링크 바로 앞
Copy the following snippet, and using the “Source” view, paste the snippet directly under the <html>
tag for every template you plan to add deep linking to.
<#include "cms://contentlibrary/Branch_SDK/branch-sdk.htm">
Responsys 링크 테이블 설정
For the Branch SDK to generate Branch links in the email or the 3P links while redirections, the Link Tracking table for the email template should contain the following two LINK NAME with the ${deeplink}
as the LINK URL.
트래킹된 링크를 생성하려면 ‘Track Link’이 ON로 설정되어 있는지 확인하십시오. 트래킹된 링크는 Responsys Click Tracking Domain에서 생성된 다음 Branch 3p 링크 (Branch_SDK.htm 파일에서 기본 URL로 추가된 링크)로 리디렉션됩니다.
딥링크(Deep Link) 만들기
Wherever you are using <a>
tags in your email templates, replace those with <@deeplink>
tags, or add <@tracked_deeplink />
for web URLs that you would like to deep link.
Link Tracking이 비활성화된 모습은 다음과 같습니다.
전:
<a href="https://branch.io">Example link</a>
후:
<@deeplink "https://branch.io">Example link</@deeplink>
링크 트래킹이 활성화된 경우에도 이메일에서 Branch 링크를 계속 사용할 수 있습니다.
전:
<a href="https://branch.io/product/1234">Example link</a>
후:
<@tracked_deeplink "https://branch.io/product/1234" /> <a href="${clickthrough('TEST_TRACKED_DEEPLINK' , 'deeplink=' + deeplink)}">Example link</a>
두번째 예는 링크 테이블에서 가져옵니다.
2. 이메일과 호환되는 일반 Branch 링크 만들기
Be sure to add "$3p":"e_xx"
to the deep link data of any links you use in email to ensure Universal Link and click tracking works as expected.
3. 이메일 템플릿을 변경하지 않고 API를 통해 이메일 링크 생성
To create email links via API, please use the instructions on how to create links via API, but include the following key value pairs in your call:
"$3p":"e_xx"
이는 Universal Link 및 클릭 트래킹 기능에 필요합니다."$original_url":"{{your web url URI encoded}}"
For each piece of content, include a URI encoded version of your content's web URL. You can also add deep link data as query parameters on that web URL. This ensures accurate Content Analytics reporting.
Example:"$original_url":"https%3A%2F%2Fshop.com%2Fshoes%2Fbrown-shoes%3Fmy_key%3Dmy_value%26campaign%3Dshoe_discounts"
4. 이메일의 모든 웹 링크를 딥링크(deep link)로 변환
웹 링크를 Branch 링크로 쉽게 전환할 수 있는 방법을 제시해 보았습니다. 해당 예시는 html 이메일 (string 으로서)을 사용하며 여기에 스크립트를 적용합니다.
다음은 스크립트입니다:
var crypto = require('crypto');
module.exports = function(original_url, branch_base_url) {
if (!original_url) { return new Error('Missing original_url'); }
if (typeof original_url != 'string') { return new Error('Invalid original_url'); }
if (!branch_base_url) { return new Error('Missing branch_base_url, should be similar to https://bnc.lt/abcd/3p?%243p=e_xx'); }
if (typeof branch_base_url != 'string') { return new Error('Invalid branch_base_url'); }
return branch_base_url + '&%24original_url=' + encodeURIComponent(original_url);
};
다음은 링크의 전후 모습입니다 (후자는 Branch 딥링크 (Deep Link)).
- 전: http://example.com/?foo=bar
- 후: https://vza3.app.link/3p?%243p=e_xx&%24original_url=http%3A%2F%2Fexample.com%2F%3Ffoo%3Dbar
참고 이는 실제 데모 링크가 아니라 단순화된 예시입니다.
웹 전용 콘텐츠에 대한 링크 처리
In some cases you may have content on web that isn’t in the app - for example, a temporary Mother’s Day promotion or an unsubscribe button. You can designate links to only open on web if you use the Responsys Link Table feature. There are three URL fields in the link table when creating a new link: LINK_URL
, IOS_LINK_URL
, and ANDROID_LINK_URL
. If you only enter the link in the LINK_URL
field, the path of the final click-wrapped url will begin with /pub/cc
. However, if you also input the same link in IOS_LINK_URL
, then the path of the final click-wrapped url will begin with pub/acc
. You should set up your AASA file to whitelist only the path /pub/acc*
in order to not launch the app from web-only links.
추가 정보
스타일링
If you include style tags within your <a>
tags, you’ll need to separate those out into a separate div inside the <@deeplink>
tag. If you use tracked links with <a>
tags, those will work fine.
다음과 같이 앵커 태그 내의 스타일 태그:
전:
<a href="https://branch.io/" style="color:#000001; text-decoration:none;">Branch Website</a>
후:
<@deeplink "https://branch.io/"><div style="color:#000001; text-decoration:none;">Branch Website</div></@deeplink>
론칭 실패 오류
You’ll see this error if you haven’t included the <#import >
snippet in your template.
Launch Failed: Launch failed: Template /contentlibrary/branch test campaign/My Default Template.htm caused an execution error: on line 183, column 92 in cms://contentlibrary/branch test campaign/Content.htm: deeplink is not a user-defined directive. It is a freemarker.template.SimpleScalar
프로파일 확장 테이블의 다이나믹 데이터 사용
The <@deeplink >
and <@tracked_deeplink />
tags even work with dynamic links injected via RPL.
<@deeplink "${latestProduct.url}">${latestProduct.name}</@deeplink>
Dynamic Query Parameters
Certain links in the Responsys Link Table use dynamic variables as query parameters.
Ex. ....com/?key=${VALUE}
In some cases, the value parameter will require additional URI encoding in order for the final URL to be a valid link.
Branch 대시보드의 분석
To see how the email campaigns have performed and break it down into campaigns, it is very essential to tag your email links with the ~campaign tag. If your team uses UTM tags, Branch will also ingest the UTM_campaign tag. This will help dedupe the numbers and hence see the downstream events. You can add the campaign tag in any comparisons and filters in any Dashboard views.
Updated 7 days ago