Oracle Responsys

Overview

imageimage

모든 소비자에게 다가갈 수 있도록 상황에 맞는 디지털 마케팅 캠페인을 설계하고 실행하십시오. Oracle Responsys는 모든 채널에서 상호 작용을 관리, 맞춤화 및 조직화하여 코드, 복잡한 기술 교육 또는 다른 전문가에 대한 의존 없이 중요한 순간에 유용한 메시지를 적시 전달할 수 있도록 도와줍니다.

1. Universal Email 필수 선행 조건 완료

📘

개발자가 필요할 수 있습니다.

다음 Universal Email 솔루션 필수 선행 조건은 개발자가 필요할 수 있는 URI 스키마 및 기타 컴포넌트를 제공하는 것을 포함합니다.

🚧

개발자 필요

다음 Universal Email 솔루션 필수 선행 조건에는 앱 코드 변경이 포함됩니다.

2. 연동 활성화

연동 활성화 방법:

  1. 왼쪽 탐색 메뉴에서 Email을 클릭합니다.
  2. 이메일 개요 페이지에서 상단의 Manager 탭을 클릭합니다.
  3. ESP를 찾아 Enable을 클릭합니다.

📘

Branch는 위의 설명과 같이 Branch 계정의 초기 설정 중 이미 제공했던 글로벌 링크 설정을 자동으로 감지합니다.

If you have not set up your global link settings and redirect preferences, you will be prompted to do so at this time.

3. 클릭 트래킹 도메인 제공

클릭 트래킹 도메인을 사용하면 이메일 열기 및 링크 클릭에 대한 인게이지먼트를 측정할 수 있습니다.

클릭 트래킹 도메인 (CTD)이 무엇인지 잘 모를 경우 최근에 전송된 이메일을 살펴보세요. 링크 위로 마우스를 가져가거나 링크 주소를 마우스 오른쪽 버튼으로 클릭/복사하면 이메일의 링크 도메인이 HTML의 URL과 일치하지 않는 것을 확인할 수 있습니다. 해당 도메인은 클릭 리포트를 제공하기 위해 ESP에서 사용하는 클릭 트래킹 도메인입니다.

Oracle Responsys 연동을 위해서는 다음을 제공해야 합니다.

  • 트래킹 도메인 클릭 -이메일의 링크에 대해 Oracle Responsys에서 사용하는 도메인

🚧

Branch 대시보드에 클릭 트래킹 도메인을 추가할 때 http:// 또는 https://를 제거하십시오.

주의 사항

  • 필요 시 여러 CTD와 연동을 활성화할 수 있지만 동일한 CTD를 여러 Branch 대시보드나 ESP 연동에 추가할 수 없습니다.

4. 연동 검증

SSL 인증서와 AASA 파일(iOS 만 해당)이 생성되면 유효성 검증 테스트를 검토하고 문제를 해결한 다음 연동을 테스트할 수 있습니다.

Branch는 다음을 자동으로 검증합니다.

  • iOS SDK가 연동되어 있습니다 (필수)
  • 안드로이드 SDK가 연동되어 있습니다 (필수)
  • 딥링킹(Deep Linking)이 설정되어 있습니다 (필수)
  • 클릭 트래킹 도메인이 설정되어 있습니다 (필수)
  • AASA 파일이 유효합니다 (필수)
  • SSL이 올바르게 설정되었습니다 (필수)
  • CNAME은 thirdparty.bnc.lt을 가리킵니다 (케이스 별 요구 사항)
  • 유니버설 링킹(Universal Linking)이 설정되었습니다 (필수)
  • 호스팅 된 딥링크(Deep Link) 데이터 (선택 사항)
  • 트래킹 되는 앱 이벤트 (선택 사항)
  • Android 앱 링크 (선택 사항)

🚧

일반적인 유효성 검증 문제

CNAME이 Branch를 나타내지 않습니다

DNS CNAME을 Branch로 지정하는 것은 연동 프로세스의 가장 중요한 단계입니다. 한편으로는 가장 골치 아픈 단계이기도 합니다.

다음을 수행하십시오.

  1. Log into your DNS provider’s console and add the CNAME record as described here.
  2. CNAME 레코드 추가 후 최소 60분을 대기하여 전파시키고 Branch가 SSL 인증서와 AASA 파일(iOS 앱 전용)을 생성할 수 있도록 합니다.

SSL이 올바르게 설정되지 않음

SSL 인증서 유효성 검증에 문제가 있는 경우 그 원인은 보통 클릭 트래킹 도메인에 이미 SSL이 설정되어 있고 써드파티가 유저를 대신하여 인증서 서명 요청을 제출하지 못하도록 하는 제한 사항이 있기 때문입니다.

AASA 파일이 유효하지 않습니다.

해당 오류는 SSL이 올바로 설정되었는지 여부에 달려있기 때문에 가장 쉽게 문제 해결이 가능합니다. SSL 오류를 해결하면 AASA 파일 오류도 동시에 해결됩니다.

6. 연동 테스트

유효성 검증 프로세스가 완료되면 테스트 링크를 생성하여 연동을 테스트할 수 있습니다. Branch에서 생성한 테스트 링크는 고유하며, Branch 링크로 자동 전환되어 ESP에서 이메일 템플릿을 생성하지 않고도 테스트할 수 있습니다. 실제로 이러한 전환 과정은 유저가 일반 이메일 템플릿 링크를 클릭한 순간 뒷단에서 동작합니다.

테스트 링크 생성 방법:

  1. Validate & Test 섹션에서 웹사이트의 URL을 입력합니다.
  2. Get Test Link를 클릭합니다.
  3. 테스트 링크가 생성되면 다음을 통해 공유할 수 있습니다.
  4. 클립보드로 복사
  5. 문자 메시지
  6. E-mail

테스트 링크를 생성한 후 모바일 디바이스에서 링크를 클릭하십시오. 모바일 디바이스에 이미 앱이 설치되어 있어야 합니다!

7. 이메일에 대한 Branch 링크 생성

Universal Email 솔루션 + Responsys와 호환되는 Branch 링크를 만들 수 있는 몇 가지 방법이 있습니다. 템플릿의 웹 URL을 이로 바꿔야 합니다. Branch 링크를 만들려면 다음 중 하나를 수행하십시오:

  1. Branch Responsys SDK 사용
  2. 이메일과 호환되는 일반 Branch 링크 만들기
  3. 이메일 템플릿을 변경하지 않고 API를 통해 이메일 링크 생성
  4. 이메일의 모든 웹 링크를 딥링크(Deep Link)로 전환

Responsys는 이메일에 단축 코드 e_rs를 사용합니다 - 아래 가이드에서 e_xx 대신에 이것을 사용하십시오.

1. Branch Responsys SDK 사용

이 단계에서는 이메일에 딥링크(Deep Link)를 매우 쉽게 생성할 수있는 SDK를 업로드합니다. 이를 위해서는 EMD (Email Message Designer)가 활성화된 계정이 필요합니다.

📘

대신 이 작업을 수행하는 방법 보기

There is also a tutorial video that walks through these steps.

  1. Branch 계정 관리자와 협력하여 다음 코드 스니펫을 수정하고 DOMAIN-HERE 을 Branch 기본 도메인으로 바꿉니다.
<#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>
  1. Responsys 계정에 로그인하십시오.

  2. Responsys 대시보드에서 콘텐츠 라이브러리를 엽니다. 기본 페이지의 바로가기 화면을 통해 액세스할 수도 있습니다.

    imageimage

  3. 콘텐츠 관리자에 들어가면 콘텐츠가 저장된 폴더 목록이 표시됩니다. All Content 아래에 Branch_SDK 이라는 새 폴더를 만듭니다.

    imageimage

  4. Branch_SDK 폴더를 선택한 다음 Create Document 을 클릭합니다.

    imageimage

  5. Create Document 창에서 :

    • "Document Name" 필드에 branch-sdk 을 입력합니다.

    • Content Box 에서 모든 텍스트를 삭제합니다.

    • 복사한 스니펫을 1 에 붙여넣습니다.

    • Save를 클릭하십시오.

      imageimage

이제 딥링크(Deep Link) 스크립트를 성공적으로 만들었습니다. 파일 구조는 다음과 같아야 합니다.

imageimage

Responsys 이메일 템플릿 설정

이 코드는 "Branch script" 라고 리퍼드(Referred) 됩니다 - 이 스크립트는 웹 URL을 딥링크(Deep Link)로 전환합니다.

Responsys 연동을 위해서는 두 곳에 이메일 템플릿 코드를 추가해야 합니다.

  1. 이메일 템플릿 상단
  2. 하이퍼링크 바로 앞

다음 스니펫을 복사하고 'Source' 보기를 사용하여 딥링킹(Deep Linking)을 추가하려는 모든 템플릿에 대해 스니펫을 <html> 태그 바로 아래에 붙여 넣습니다.

<#include "cms://contentlibrary/Branch_SDK/branch-sdk.htm">

Responsys 링크 테이블 설정

Branch SDK가 리디렉션하는 동안 이메일 또는 3P Link에서 Branch 링크를 생성하려면 이메일 템플릿의 Link Tracking 테이블에 ${deeplink}LINK URL인 다음 두 개의 LINK NAME이 포함되어야 합니다.

imageimage

트래킹된 링크를 생성하려면 ‘Track Link’ON로 설정되어 있는지 확인하십시오. 트래킹된 링크는 Responsys Click Tracking Domain에서 생성된 다음 Branch 3p 링크 (Branch_SDK.htm 파일에서 기본 URL로 추가된 링크)로 리디렉션됩니다.

딥링크(Deep Link) 만들기

이메일 템플릿에서 <a> 태그를 사용하는 곳마다 태그를 <@deeplink> 태그로 바꾸거나 딥링크(Deep Link)하려는 웹 URL에 <@tracked_deeplink />를 추가하십시오.

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>

두번째 예는 링크 테이블에서 가져옵니다.

imageimage

2. 이메일과 호환되는 일반 Branch 링크 만들기

유니버셜 링크 및 클릭 트래킹이 예상대로 작동하도록 이메일에 사용하는 링크의 딥링크(Deep Link) 데이터에 "$3p":"e_xx"을 추가하십시오.

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:

  1. "$3p":"e_xx" 이는 Universal Link 및 클릭 트래킹 기능에 필요합니다.
  2. "$original_url":"{{your web url URI encoded}}" 각 콘텐츠에 대해 콘텐츠 웹 URL의 URI 인코딩 버전을 포함합니다. 해당 웹 URL의 쿼리 파라미터로 딥링크(Deep Link) 데이터를 추가할 수도 있습니다. 이로써 정확한 Content Analytics 리포트가 보장됩니다.
    예: "$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)).

  1. 전: http://example.com/?foo=bar
  2. 후: https://vza3.app.link/3p?%243p=e_xx&%24original_url=http%3A%2F%2Fexample.com%2F%3Ffoo%3Dbar

참고 이는 실제 데모 링크가 아니라 단순화된 예시입니다.

웹 전용 콘텐츠에 대한 링크 처리

경우에 따라 앱에 없는 웹 콘텐츠(예: 임시 어머니의 날 프로모션 또는 구독 취소 버튼)가 있을 수 있습니다. Responsys Link Table 기능을 사용하는 경우 웹에서만 오픈되도록 링크를 지정할 수 있습니다. 새 링크 생성 시 링크 테이블에는 3개의 URL 필드가 있습니다: LINK_URL , IOS_LINK_URLANDROID_LINK_URL입니다. LINK_URL 필드에 링크만을 입력하면, 최종 클릭으로 랩핑된 URL의 경로는 /pub/cc로 시작합니다. 그러나 IOS_LINK_URL에 동일한 링크를 입력하면 최종 클릭 랩핑 된 URL의 경로는 pub/acc로 시작합니다. 웹 전용 링크에서 앱을 런칭하지 않으려면 AASA 파일이 경로 /pub/acc*만을 허용하도록 설정해야 합니다.

imageimage

imageimage

추가 정보

스타일링

<a> 태그 내에 스타일 태그를 포함하는 경우 <@deeplink> 태그 안에서 이를 별도의 div로 분리해야 합니다. <a> 태그로 트래킹된 링크를 사용할 경우 정상적으로 작동합니다.

다음과 같이 앵커 태그 내의 스타일 태그:

전:

<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>

론칭 실패 오류

템플릿에 <#import > 스니펫을 포함하지 않은 경우 이 오류가 표시됩니다.

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

프로파일 확장 테이블의 다이나믹 데이터 사용

<@deeplink ><@tracked_deeplink /> 태그는 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.