Skip to content

Liquid로 동작 및 미디어 URL 개인화하기

버튼, 링크, 이미지, 동영상의 URL에 Liquid 변수를 추가하여 메시지를 수신하는 각 사용자에 맞게 링크 대상과 콘텐츠를 개인화할 수 있습니다.

인앱 콘텐츠로의 딥링크

딥링킹이란?

딥링킹은 네이티브 앱을 실행하고 특정 작업을 수행하거나 특정 콘텐츠를 표시하도록 추가 정보를 제공하는 방법입니다.

이 과정은 세 부분으로 구성됩니다:

  1. 실행할 앱을 식별합니다.
  2. 앱에 수행할 작업을 지시합니다.
  3. 작업에 필요한 추가 데이터를 제공합니다.

딥링크는 앱의 특정 부분으로 연결되는 커스텀 URI이며, 위의 세 가지 요소를 모두 포함합니다. 핵심은 커스텀 스킴을 정의하는 것입니다. http:는 거의 모든 사람에게 익숙한 스킴이지만, 스킴은 어떤 단어로든 시작할 수 있습니다. 스킴은 반드시 문자로 시작해야 하지만, 이후에는 문자, 숫자, 더하기 기호, 빼기 기호 또는 점을 포함할 수 있습니다. 실질적으로 충돌을 방지하기 위한 중앙 레지스트리가 없으므로, 스킴에 도메인 이름을 포함하는 것이 모범 사례입니다. 예를 들어, twitter://는 이전에 Twitter로 알려진 X의 모바일 앱을 실행하기 위한 iOS URI입니다.

딥링크에서 콜론 이후의 모든 내용은 자유 형식 텍스트입니다. 구조와 해석을 정의하는 것은 사용자에게 달려 있지만, 일반적인 관례는 선행 //와 쿼리 매개변수(예: ?foo=1&bar=2)를 포함하여 http: URL을 모델로 하는 것입니다. 앞의 예시에서 twitter://user?screen_name=[id]는 앱에서 특정 프로필을 실행하는 데 사용됩니다.

시스템 URI 스킴

iOS 및 Android에서 기본적으로 처리되는 표준 URI 스킴(예: tel:, mailto:, sms:)은 앱에서 커스텀 딥링크 통합 없이 딥링크 URL 필드에 직접 입력할 수 있습니다.

스킴 예시 동작
tel: tel:+18005555555 전화 다이얼러 열기
mailto: mailto:[email protected] 이메일 작성 열기
sms: sms:+18005555555 SMS 작성 열기

이 스킴은 푸시 알림 클릭 시 동작과 인앱 메시지 버튼 동작에 사용할 수 있습니다. 추가 SDK 구성이나 앱 코드 변경은 필요하지 않습니다.

푸시 알림, 인앱 메시지, 배너 또는 Content Cards를 작성할 때, Deeplink into application을 선택하여 앱에서 특정 화면이나 작업을 열 수 있습니다. 일부 작성기에서는 이 옵션이 Deep Link Into App으로 표시됩니다.

이 옵션을 사용하기 전에 개발자와 협력하여 URI 형식을 정의하고 앱이 이를 열 수 있도록 구성하세요. myapp://과 같은 커스텀 스킴은 설치된 앱을 직접 엽니다. 유니버설 링크(iOS) 및 앱 링크(Android)는 https:// URL을 사용하여 앱이 설치된 경우 앱을 열고, 앱이 설치되지 않은 경우 웹 페이지로 대체합니다.

이 클릭 시 동작을 설정하려면:

  1. Campaign 또는 Canvas 작성기에서 클릭 시 동작을 찾습니다:
    • 푸시 알림 및 Content Cards의 경우 작성 탭으로 이동합니다.
    • 인앱 메시지의 경우 작성 탭으로 이동합니다. 드래그 앤 드롭 편집기에서 버튼 또는 이미지 블록을 선택하고 속성 패널을 엽니다.
  2. Deeplink into application 또는 Deep Link Into App을 선택합니다.
  3. URL 필드에 링크를 입력합니다. 예를 들어, 커스텀 스킴의 경우 myapp://products/12345, 유니버설 링크 또는 앱 링크의 경우 https://example.com/products/12345를 입력합니다.
  4. 실제 기기로 테스트 메시지를 보냅니다. 테스트가 성공하면 앱이 열리고 의도한 화면이나 작업으로 이동합니다. 유니버설 링크 또는 앱 링크의 경우, 앱이 설치되지 않은 기기에서도 테스트하여 예상되는 웹 대체 동작을 확인하세요.

UTM 태그 및 캠페인 기여도

UTM 태그란?

UTM(Urchin Traffic Manager) 태그를 사용하면 링크에 캠페인 기여도 세부 정보를 직접 포함할 수 있습니다. UTM 태그는 Google Analytics에서 캠페인 기여도 데이터를 수집하는 데 사용되며, 다음 속성을 추적하는 데 활용할 수 있습니다:

  • utm_source: 트래픽 소스의 식별자(예: my_app)
  • utm_medium: 캠페인 매체(예: newsfeed)
  • utm_campaign: 캠페인의 식별자(예: spring_2016_campaign)
  • utm_term: 사용자를 앱 또는 웹사이트로 유도한 유료 검색어의 식별자(예: pizza)
  • utm_content: 사용자가 클릭한 특정 링크 또는 콘텐츠의 식별자(예: toplink 또는 android_iam_button2)

UTM 태그는 일반 HTTP(웹) 링크와 딥링크 모두에 삽입할 수 있으며, Google Analytics를 통해 추적할 수 있습니다.

UTM 태그 계산

Braze는 Campaign 또는 Canvas 단계의 모든 링크에 대해 _총 클릭 수_를 보고하며, 여기에는 UTM 태그가 없는 링크도 포함될 수 있습니다. 따라서 Google Analytics 캠페인 추적 링크에서 캠페인 성능 또는 보고서 빌더에 표시되는 _총 클릭 수_와 다른(보통 더 낮은) 결과가 나타날 수 있습니다.

Braze에서 UTM 태그 사용

일반 HTTP(웹) 링크에 UTM 태그를 사용하려는 경우(예: 이메일 캠페인의 캠페인 기여도 추적), 조직에서 이미 Google Analytics를 사용하고 있다면 Google의 URL 빌더를 사용하여 UTM 링크를 생성할 수 있습니다. 이러한 링크는 다른 링크와 마찬가지로 Braze 캠페인 콘텐츠에 쉽게 삽입할 수 있습니다.

앱의 딥링크에 UTM 태그를 사용하려면 앱에 관련 Google Analytics SDK가 통합되어 있고 딥링크를 처리하도록 올바르게 구성되어 있어야 합니다. 확실하지 않은 경우 개발자에게 확인하세요.

Analytics SDK가 통합 및 구성된 후, Braze 캠페인의 딥링크에 UTM 태그를 사용할 수 있습니다. 캠페인에 UTM 태그를 설정하려면 대상 URL 또는 딥링크에 필요한 UTM 태그를 포함하세요. 다음 예시는 푸시 알림과 인앱 메시지에서 UTM 태그를 사용하는 방법을 보여줍니다.

UTM 태그로 푸시 열람 및 인앱 메시지 클릭 기여도 추적

푸시 알림의 딥링크에 UTM 태그를 포함하려면, 푸시 메시지의 클릭 시 동작을 딥링크로 설정한 다음 딥링크 주소를 작성하고 다음과 같은 방식으로 원하는 UTM 태그를 포함합니다:

1

myapp://products/20-gift-card?utm_source=my_app&utm_medium=push&utm_campaign=spring2016giftcards&utm_content=ios_deeplink

UTM 태그를 사용한 푸시 열람 및 인앱 메시지 클릭 기여도 추적 관련 스크린샷.

인앱 메시지의 딥링크에 UTM 태그를 포함하려면 다음을 사용합니다:

1

myapp://products/20-gift-card?utm_source=my_app&utm_medium=iam&utm_campaign=spring2021giftcards&utm_content=web_link

UTM 태그를 사용한 푸시 열람 및 인앱 메시지 클릭 기여도 추적 관련 스크린샷.

URL에서 Liquid 개인화 사용하기

Braze 작성기 내에서 URL을 동적으로 구성하여 URL에 동적 UTM 매개변수를 추가하거나 사용자에게 고유한 링크를 보낼 수 있습니다(예: 사용자를 유기한 장바구니로 안내하거나 재입고된 특정 제품으로 안내).

지원되는 Liquid 개인화 태그로 URL 만들기

지원되는 Liquid 개인화 태그를 사용하여 URL을 동적으로 생성할 수 있습니다.

1

https://example.com/?campaign_utm={{campaign.${api_id}}}&user_attribute={{custom_attribute.${attribute1}}}

다음 예시와 같이 커스텀 정의된 Liquid 변수의 단축도 지원합니다.

Liquid 변수를 사용하여 URL 만들기

1
2

{% assign url_var = {{event_properties.${url_slug}}} %}
https://example.com/{{url_var}}

Liquid 변수로 렌더링된 URL 단축하기

지원 채널: KakaoTalk, LINE, SMS, RCS, WhatsApp

API 트리거 속성에 포함된 URL을 포함하여 Liquid로 렌더링된 URL을 단축합니다. 예를 들어, {{api_trigger_properties.${url_value}}}가 유효한 URL을 나타내는 경우, 메시지를 보내기 전에 해당 URL을 단축하고 추적합니다.

/messages/send 엔드포인트에서 URL 단축하기

/messages/send 엔드포인트를 통해 API 전용 메시지에서도 링크 단축이 활성화됩니다. 요청 매개변수의 전체 목록은 요청 매개변수를 참조하세요.

매개변수 필수 데이터 유형 설명
link_shortening_enabled 예 Boolean 링크 단축을 활성화하려면 link_shortening_enabled를 true로 설정합니다. 추적을 사용하려면 campaign_id와 message_variation_id가 있어야 합니다.
New Stuff!