Universal Email 연동 가이드

Universal Email (이메일-투-앱)을 사용하면 이메일 링크를 멀티 플랫폼 딥링크(Deep Link)로 자동 전환하여 유저를 모바일 디바이스에서 앱의 콘텐츠로 직접 연결하는 동시에 앱이 없는 데스크톱 및 모바일 사용자에게 동일한 웹 경험을 유지합니다.

본 가이드는 모든 Branch Universal Email 솔루션 파트너에 적용됩니다. ESP를 Branch와 연동하려면 아래 단계를 따르세요. ESP에 추가 지침이 필요한 경우 전용 가이드로 이동합니다.

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

📘

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

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

🚧

개발자 필요

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

2. 연동 활성화

연동 활성화 방법:

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

📘

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

글로벌 링크 설정 및 리다이렉션 선호도를 설정하지 않은 경우 이 때 설정하라는 요청이 표시됩니다.

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

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

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

또는 아래 버튼을 눌러 클릭 트래킹 도메인을 찾는 방법에 대한 ESP 문서를 확인하십시오. 문서가 없을 시 ESP에 관련하여 서포트팀에 문의하는 방법을 링크에서 확인하십시오.

🚧

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

adestra adobe campaign classic adobe campaign standard airship amazon simple email service betaout bluecore blueshift braze + mailjet braze + sendgrid braze + sparkpost campaign monitor cheetah digital marketing suite clevertap + amazon ses clevertap + mailgun clevertap + mandrill clevertap + sendgrid cmercury cordial customer.io emarsys epsilon expertsender hootsuite IBM watson campaign automation iterable v1 iterable v2 kahuna klaviyo leanplum mailgun mailjet mailup mandrill marketo message gears moengage oracle bronto oracle eloqua oracle responsys pepipost postup rapid mail sailthru v1 sailthru v2 salesforce 웹 열기 기본값 salesforce 앱 열기 기본값 salesforce v2 legacy salesforce v3 legacy selligent marketing cloud selligent message studio sender sendgrid smartech socialflow sparkpost vero whatcounts yes marketing yiye technology zeta

주의 사항

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

  • 일부 ESP 연동에서는 ESP의 클릭 데이터 수집에 사용하는 '데이터 도메인'도 추가해야 합니다.

    • 선택한 ESP는 해당 필드의 표시 여부를 좌우합니다. 필드가 표시되지 않으면 추가할 필요가 없습니다.
    • ESP의 어카운트 관리자로 데이터 도메인을 확인합니다.
  • 일부 ESP 연동에서는 ESP의 연락처 이메일을 제공하여 Branch가 생성한 AASA 파일을 보내야 합니다.

    • 선택한 ESP는 해당 필드의 표시 여부를 좌우합니다. 필드가 표시되지 않으면 추가할 필요가 없습니다.

👍

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

4. DNS CNAME을 Branch로 지정

대부분의 ESP 연동에서는 Branch의 thirdparty.bnc.lt 도메인을 나타내는 CNAME (별칭) 레코드를 포함하도록 CTD의 DNS 레코드를 업데이트해야 합니다.

해당 웹 호스팅 제공 업체의 DNS CNAME 설정 방법 가이드를 따르십시오. 참고로 다음은 제공 업체의 일반적인 가이드입니다.

중요한 CNAME 정보

  • CNAME을 추가하기 전에 Branch 대시보드를 활성화하고 CTD를 반영해야 합니다.
  • CTD에 이미 SSL 설정이 있는 경우, 보안 인증서가 제 3자가 기존 도메인을 대신하여 CSR을 제출하는 것을 허용하는지 확인합니다. 그렇지 않은 경우, Branch의 서포트팀에 문의하여 수동으로 Branch에 SSL 인증서를 제공하도록 조정하십시오.
  • CNAME이 추가되면 Branch는 클릭 트래킹 도메인에 대한 SSL 인증서 및 AASA 파일을 자동 생성합니다. CNAME을 변경한 후 SSL 오류를 해결하는 데 최대 1시간이 걸릴 수 있습니다. 해당 시간 동안 클릭 트래킹 도메인의 링크 리다이렉션은 계정의 General Configuration 섹션에서 제공한 기본 URL로 리다이렉션됩니다.
  • 이메일 클릭 트래픽이 활발한 라이브 도메인에 해당 변경을 적용하는 경우, 클릭 트래픽이 적은 시간대에 도메인 이름(CNAME) 변경이 이루어지도록 스케줄을 정합니다.

5. 연동 검증

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

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

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

🚧

일반적인 유효성 검증 문제

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

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

다음을 수행하십시오.

  1. DNS 제공 업체의 콘솔에 로그인하고 이곳에 설명한대로 CNAME 레코드를 추가합니다.
  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. 플래그 지정된 링크로 이메일 전송 시작

축하합니다. ESP 연동을 성공적으로 설정했습니다! 이메일 캠페인 설정을 시작하기 전에 유저가 경험할 플로우를 결정하고 그에 맞추어 이메일 링크에 플래그를 지정해야 합니다.

대부분의 ESP는 다음 유저 플로우(User fLow)를 서포트합니다.

  • 유저를 인앱 콘텐츠에 딥링킹(Deep Linking) 하기

    • URL 쿼리 파라미터로 링크에 추가하기:
      <a href="links.example.com?$deep_link=true" >Link to your app!</a>
    • HTML에 추가하기:
      <a href="http://example.com" deeplink="true">Link to your app!</a>
  • 유저를 웹 전용 콘텐츠에 링킹 하기

    • URL 쿼리 파라미터로 링크에 추가하기:
      <a href="links.example.com?$web_only=true" >Link to your app!</a>

Updated 4 months ago



Universal Email 연동 가이드


Universal Email (이메일-투-앱)을 사용하면 이메일 링크를 멀티 플랫폼 딥링크(Deep Link)로 자동 전환하여 유저를 모바일 디바이스에서 앱의 콘텐츠로 직접 연결하는 동시에 앱이 없는 데스크톱 및 모바일 사용자에게 동일한 웹 경험을 유지합니다.

제안된 편집은 API 참조 페이지에서 제한됩니다.

Markdown 본문 콘텐츠에 대한 편집만 제안할 수 있지만 API 사양에는 제안할 수 없습니다.