✕
필터
홈가이드
티켓 제출Branch 대시보드Branch UniversityLog In
티켓 제출Branch 대시보드Branch University

Salesforce - Open App Default

Overview

image

Email Studio를 만나보세요. 세계 최고의 이메일 마케팅 플랫폼으로 고객에게 다가가십시오. 기본 마케팅 캠페인에서 정교한 일대일 메시지에 이르기까지 더 스마트한 이메일을 구축하십시오.

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

📘

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

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

🚧

개발자 필요

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

2. Salesforce 설정하기

Salesforce Click Tracking Domain을 확보하십시오.

If your click tracking domain is not secure (i.e., secure domains will start with https://), you will need to purchase an SSL SKU from your Salesforce Account Manager.

참고: Salesforce에서 SSL 인증서 요청을 처리하는 데 4-6주가 소요될 수 있습니다.

Salesforce Marketing Cloud에서 AASA 파일 설정

유니버셜 링크(Universal Links)를 올바르게 처리하도록 Salesforce 계정을 설정해야 합니다. Email Studio에서 Send Management 섹션 하단의 딥링킹(Deep Linking)에서 설정합니다. 올바른 클릭 트래킹 도메인에 해당하는 계정에서 진행 중인지 확인하세요.

image

  1. AppID 값을 입력하십시오.
  2. Check the "Exclude Profile" and "Unsub Center" checkboxes to force links to these items to open in the browser and not the app, if desired.
  3. Click "Save" to save the configuration.
  4. Salesforce 및 Branch에 이 단계를 완료했음을 알리면 기술 계정 관리자가 모든 것이 정상인지 확인합니다.

image

3. 연동 활성화

연동 활성화 방법:

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

📘

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.

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

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

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

Salesforce v1 Open App Default 연동을 사용하려면 다음을 제공해야합니다.

  • 클릭 트래킹 도메인 -이메일의 링크를 위해 Salesforce에서 사용하는 도메인

🚧

Remove http:// or https:// when adding your click tracking domain in the Branch dashboard

2394

주의 사항

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

👍

NEXT를 클릭하고 Validate & Test 섹션을 진행하기 전에 다음 섹션을 마쳐 연동 검증을 통과해야 합니다.

5. 연동 검증

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

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

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

🚧

일반적인 유효성 검증 문제

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

이 연동에서는 CNAME이 Salesforce를 가리켜야 하므로 항상 이 오류가 발생합니다. 무시하시면 됩니다.

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
698

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

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

1. Salesforce AMPscript를 사용하여 링크 변환하기

Salesforce의 AMPscript를 사용하여 이메일 템플릿의 웹 링크를 Branch 링크로 전환하는 Salesforce에 새로운 Content Area를 추가할 것입니다.

  1. Work with your Branch account manager to modify the following Salesforce AMPscript snippet, replacing DOMAIN-HERE with your Branch base domain (i.e., example.app.link):

    %%[ VAR @deeplink, @branch_base_url SET @branch_base_url = "https://DOMAIN-HERE/3p?%243p=e_et" SET @deeplink = CONCAT(@branch_base_url, CONCAT("&%24original_url=", URLEncode(@link_to_be_wrapped, 1, 1))) ]%%

  2. After logging into Salesforce Marketing Cloud, click on Email Studio and then a sub-menu will appear. Click on Email in the dropdown menu:

1338
  1. This will take you to the landing page for the Email section. Click on Content in the menu bar to navigate to the Content section:
1343
  1. 콘텐츠 섹션에서 왼쪽에 폴더 목록이 표시됩니다. My Contents 폴더를 마우스 오른쪽 버튼으로 클릭하고 콘텐츠 빌더 메뉴에서 Create Folder를선택합니다.
1360
  1. Name the folder Branch:
1830
  1. 폴더가 생성되면 오른쪽 상단에서 Create 버튼을 클릭한 뒤 Content Blocks를 클릭하고 마지막으로 Free Form을 클릭합니다.
2094
  1. Free Form 화면에서 이전에 생성한 스니펫을 붙여 넣으십시오.
2094

  1. Save를 클릭합니다.

  2. In the Create Free Form window that appears, enter deeplink in the text field named Content Name. Click on Save after you enter the text:

2094
  1. 이제 파일 deeplink가 나열된 Contents 섹션의 폴더 목록으로 돌아갑니다:

이제 딥링킹(Deep Linking) AMPscript를 성공적으로 만들었습니다.

📘

코드 스니펫

The snippet below will follow this format. The code below also has a placeholder for @branch_base_url. Replace it with yours.

%%[ VAR @deeplink, @branch_base_url SET @branch_base_url = "BASE URL FROM BRANCH" SET @deeplink = CONCAT(@branch_base_url, CONCAT("&%24original_url=", URLEncode(@link_to_be_wrapped, 1, 1))) ]%%

Salesforce 이메일 템플릿 설정

이 섹션에서는 기존 이메일 템플릿의 개별 링크를 딥링크(Deep Link)로 전환하는 방법에 대해 설명합니다. 딥링크(Deep Link)로 전환하려는 이메일 템플릿의 모든 링크에 대해 이 작업을 수행해야 합니다.

예를 들어 아래 링크를 Branch 링크로 변환하기로 결정한 경우:

<a href="https://branch.io/product/1234/"> I want it! </a>

This is what the link will look like in the email template, after you added the AMPscript to convert it into a Branch link:

%%[ SET @link_to_be_wrapped = "https://branch.io/product/1234/" ContentAreaByName("My Contents\branch\deeplink") ]%%
<a href="%%=RedirectTo(@deeplink)=%%">Example link</a>

AMPscript를 사용하여 링크를 Branch 링크로 전환하는 프로세스는 다음과 같습니다 (이 플로우는 링크를 별도의 문서로 전환한 다음 최종 템플릿에 다시 붙여 넣습니다):

  1. Salesforce Marketing Cloud에 로그인

  2. Click on Email Studio and then a sub-menu will appear. Click on Email in the dropdown menu:

    image

  3. This will take you to the landing page for the Email section. Click on Content in the menu bar to navigate to the Content section:

    image

  4. 이메일이 포함된 폴더로 이동하여 기존 이메일을 엽니다. 이메일이 아래와 같이 HTML 레이아웃인지 확인하십시오.

    image

  5. Choose a link that you want to convert to a Branch deep link. Copy the text right after the href= in your email template, and paste it into a separate document. In the example, it is:

    "https://branch.io/product/1234/"

  6. 더하다 %%[ SET @link_to_be_wrapped = before the link in your separate document. In the example, this is now:

    %%[ SET @link_to_be_wrapped = "https://branch.io/product/1234/"

  7. 더하다 ContentAreaByName("My Contents\branch\deeplink"")]%% after the link:

    %%[ SET @link_to_be_wrapped = "https://branch.io/product/1234/"ContentAreaByName("My Contents\branch\deeplink"")]%%

  8. From the original link in your template, copy the text from and including <a until the href=. Add it to the text after %% in the last step. Please include the <a but not the href=:

    %%[ SET @link_to_be_wrapped = "https://branch.io/product/1234/" ContentAreaByName("My Contents\branch\deeplink"") ]%%<a style="_any css can be added here_"

  9. 더하다 href="%%=RedirectTo(@deeplink)=%%" to the end:

    %%[ SET @link_to_be_wrapped = "https://branch.io/product/1234/" ContentAreaByName("My Contents\branch\deeplink"") ]%% <a style="_any css can be added here_"href="%%=RedirectTo(@deeplink)=%%"

  10. From the original link in your template, copy the end of the tag, the link text, and the closing tag (>I want it!</a> in the example) and add it to the end:

    %%[ SET @link_to_be_wrapped = "https://branch.io/product/1234/" ContentAreaByName("My Contents\branch\deeplink"") ]%% <a style="_any css can be added here_" href="%%=RedirectTo(@deeplink)=%%">I want it!</a>

  11. Copy your final result from the separate document back into your email template, replacing everything inside and including the <a></a> tags in the template.

  12. Branch 딥링크 (Deep Link)로 전환하려는 이메일 템플릿의 모든 링크에 대해 이 작업을 반복합니다.

📘

링크 전환 요약

Wherever you use <a> tags in your email templates, replace those with AMPscript to convert the web URLs into Branch links. The AMPscript references the Content Area setup earlier.

%%[SET @link_to_be_wrapped = "ADD YOUR LINK HERE" ContentAreaByName("My Contents\branch\deeplink")]%%
<a href="%%=RedirectTo(@deeplink)=%%">Click Me</a>

For example,
Before:
<a href="https://branch.io/product/1234">Example link</a>
후:
%%[ SET @link_to_be_wrapped = "https://branch.io/product/1234" ContentAreaByName("My Contents\deeplink") ]%%
<a href="%%=RedirectTo(@deeplink)=%%">Example link</a>

🚧

컨텐츠 영역 폴더

Make sure your deeplink Content Area is in the right folder. Either change the folder to "My Contents" or change the path used by "ContentAreaByName" in the Branch script.

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

Be sure to add "$3p":"e_et" to the deep link data of any links you use in email to ensure Universal Link and click tracking works as expected.

3. Create email links via 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_et" 이는 Universal Link 및 클릭 트래킹 기능에 필요합니다.
  2. "$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"

다음은 링크의 전후 모습입니다 (후자는 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

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

4. 웹 전용 링크에 플래그 지정

For links that should always open in web, even if the app is installed, add Salesforce's link attribute mc-deep-link="false" to your link tag to ensure the app does not open in iOS:

<a mc-deep-link="false" href="https://my.app.link/3p?$3p=e_et&$original_url=..." > This link will not open the app. </a>

If the link in the "href" part of the tag is a normal web link, the app will NOT open in Android. If the link in the "href" part of the tag is a Branch link, but you don't want the app to open, then you'll need to add &%24web_only%3Dtrue as a query parameter:

<a href="https://my.app.link/3p?%243p=e_xx&%24original_url=http%3A%2F%2Fexample.com&%24web_only%3Dtrue" > This link will not open the app. </a>