링크 별칭 지정
링크 별칭 지정을 사용하여 Braze에서 발송하는 이메일 메시지의 링크를 식별할 수 있는 사용자 정의 이름을 생성합니다. 이러한 링크는 세분화 리타겟팅, 행동 기반 트리거링 및 링크 분석에 활용할 수 있습니다.
링크 별칭 지정 소개
링크 별칭 지정을 사용하면 이메일에서 발송된 링크를 식별하고 추적하기 위해 사용자가 직접 이름을 생성할 수 있습니다. 이를 통해 전체 링크를 참조할 필요 없이, 이메일에서 알아보기 쉬운 링크 별칭을 효율적으로 활용하여 인게이지먼트를 추적하고 캠페인 성능을 분석할 수 있습니다.
링크 별칭 지정을 사용하면 다음을 수행할 수 있습니다:
- 특정 링크를 클릭한 사용자를 리타겟팅: 링크를 클릭한 사용자를 식별하고 타겟팅합니다.
- 액션 기반 트리거 생성: 사용자가 링크를 클릭하면 이메일을 발송합니다.
- 측정기준 분석: 링크 A와 링크 B를 클릭한 사용자 수를 비교합니다.
작동 방식
Braze는 모든 링크 URL에 lid(링크 식별자라고도 함)라는 추가 파라미터를 추가하여 이메일 내의 링크를 고유하게 식별합니다. 이 lid 값을 통해 Braze는 나머지 URL 파라미터가 다를 수 있더라도 링크에 대한 사용자 상호작용을 추적, 모니터링 및 집계할 수 있습니다. 이를 통해 사용자가 이메일 캠페인의 콘텐츠에 어떻게 참여하는지에 대한 인사이트를 제공합니다.
링크 식별자는 이메일 Campaign, 이메일 메시지가 포함된 Canvas 또는 Content Blocks가 복제될 때에도 업데이트됩니다.
링크 별칭 지정 켜기
링크 별칭 지정은 대시보드가 아닌 Braze에서 회사 전체에 대해 켭니다. 요청하려면 Braze 계정 매니저에게 문의하세요. 링크 별칭 지정을 켜면 회사에 대해 링크 템플릿도 함께 켜집니다. Braze만 회사의 링크 별칭 지정을 켜거나 끌 수 있습니다.
링크 별칭 지정이 이미 켜져 있는지 확인하려면, 설정 > 이메일 환경설정에서 링크 별칭 지정 설정 탭으로 이동하세요. 이메일 환경설정을 열 수 없다면, “View Email Settings” 권한이 없는 것입니다. 페이지는 열 수 있지만 해당 탭이 없다면, 회사에 링크 별칭 지정이 켜져 있지 않은 것입니다. 누락된 페이지나 설정에 대해서는 링크 관리 페이지 또는 설정이 누락됨을 참조하세요.
링크 별칭 지정이 켜진 후에는 대시보드에서 다음 작업을 수행할 수 있습니다.
| 작업 | 이동 위치 | 필요 사항 |
|---|---|---|
| 링크 별칭 이름 지정 및 메시지에서 추적 또는 추적 해제 | 이메일 작성기 > 콘텐츠 > 링크 관리 | Campaign 또는 Canvas에 대한 접근 권한 |
| 워크스페이스의 모든 추적된 별칭 확인 및 일괄 추적 해제 | 설정 > 이메일 환경설정 > 링크 별칭 지정 설정 | 보기: “View Email Settings”, 편집: “Edit Email Settings” |
| 링크 템플릿 생성 및 적용 | 템플릿 > 이메일 링크 | “View Email Link Templates” 및 “Edit Email Link Templates” |
별칭 지정이 꺼졌을 때 변경되는 사항에 대해서는 lid 파라미터를 허용하지 않는 대상을 참조하세요. 이 표의 권한에 대해 자세히 알아보려면 회사 사용자 권한을 참조하세요.
링크 별칭 만들기
드래그 앤 드롭 에디터와 HTML 에디터는 동일한 작성기 사이드바를 사용하므로 두 에디터에서 단계가 동일합니다.
- Campaign 또는 Canvas 구성 요소에서 이메일 본문을 엽니다. 드래그 앤 드롭 에디터에서 이메일 본문 편집을 선택합니다.
- 작성기 사이드바에서 콘텐츠를 선택합니다(전송 설정 및 미리보기 및 테스트 옆에 있음). 이 레이아웃에 대한 자세한 내용은 드래그 앤 드롭으로 이메일 만들기를 참조하세요.
- 콘텐츠 하위 메뉴에서 디자인 및 빌드 아래의 링크 관리를 선택합니다. 하위 메뉴가 접혀 있는 경우 사이드바의 화살표 컨트롤을 사용하여 펼치세요.
- 각 별칭에 이름을 지정합니다. Braze는 모든 링크에 대해 고유한 기본 별칭을 생성하며, 별칭은 이메일 캠페인 배리언트 또는 Canvas 구성 요소별로 고유한 이름이어야 합니다.
별칭을 사용하여 보고 및 세분화에서 특정 링크를 참조할 수 있습니다.

링크 별칭 지정은 쿼리 파라미터를 안전하게 추가할 수 있는 HTML 앵커 태그 내의 href 속성에서만 지원됩니다. Braze가 lid 값을 쉽게 추가할 수 있도록 링크 끝에 물음표(?)를 포함하는 것이 좋습니다. lid 값을 추가하지 않으면 Braze가 링크 별칭 지정을 위한 URL을 인식하지 못합니다.

드래그 앤 드롭 에디터에서 링크 별칭이 링크 관리 탭에 표시되려면 URL에서 해시 기호(#) 앞에 물음표(?)가 포함되어야 합니다.
링크 별칭 관리
추적된 모든 링크 별칭을 보려면 다음을 수행합니다:
- 설정 > 작업 공간 설정에서 이메일 환경설정으로 이동합니다.
- 링크 별칭 지정 설정 탭을 선택합니다.
여기에서 링크 별칭을 정렬, 검색하고 추적을 끌 수 있습니다.

Campaign의 링크 별칭 목록 및 Canvas의 링크 별칭 목록 엔드포인트를 사용하여 Campaign 또는 이메일 전용 Canvas 구성 요소에서 각 메시지 배리언트에 설정된 alias를 추출할 수 있습니다.
Braze는 이메일 내 링크를 평가하고, 링크 템플릿을 추가하며, 세분화 및 보고 목적에 적합한 명명 규칙을 제공할 것을 권장합니다. 이렇게 하면 모든 링크를 효과적으로 추적할 수 있습니다.
링크 별칭 지정을 켜도 메시지, Content Blocks 및 링크 템플릿은 수정되지 않습니다. 링크 템플릿이나 Content Blocks를 사용하는 기존 메시지는 동일하게 유지됩니다. 그러나 메시지를 업데이트하면 링크 별칭 마크업이 모든 링크에 적용되므로 링크가 표시되도록 링크 템플릿을 다시 적용해야 합니다.
링크 별칭 지정으로 링크가 업데이트되는 방식
다음 표는 이메일 본문의 링크, 링크 별칭 지정 결과, 그리고 원래 링크가 링크 별칭 지정으로 어떻게 업데이트되는지에 대한 설명의 예시를 제공합니다.
영구 링크
로직: Braze는 물음표(?)를 삽입하고 첫 번째 쿼리 파라미터를 URL에 추가합니다.
| 이메일 본문 내 링크 | 별칭이 적용된 링크 |
|---|---|
https://www.braze.com |
https://www.braze.com?lid=slfdldtqdhdk |
추가 쿼리 파라미터가 있는 링크
로직: Braze는 다른 쿼리 파라미터를 감지하고 URL 끝에 lid=를 추가합니다.
| 이메일 본문 내 링크 | 별칭이 적용된 링크 |
|---|---|
https://www.braze.com?utm_campaign=retention&utm_source=email |
https://www.braze.com?utm_campaign=retention&utm_source=email&lid=0goty30mviyz |
HTML 링크
로직: Braze는 링크가 URL임을 인식하고 이미 물음표(?)가 존재하므로, lid 쿼리 파라미터를 물음표 뒤에 추가합니다.
| 이메일 본문 내 링크 | 별칭이 적용된 링크 |
|---|---|
<a href="{{custom_attribute.{product_url}}}?"> |
<a href="{{custom_attribute.{product_url}}}?lid=ac7a548g5kl7"> |
앵커가 있는 링크
로직: Braze는 URL이 앵커(#)가 물음표(?) 뒤에 위치하는 표준 구조를 사용할 것으로 예상합니다. Braze는 왼쪽에서 오른쪽으로 읽기 때문에, 물음표와 lid 값이 앵커 앞에 추가됩니다.
| 이메일 본문 내 링크 | 별칭이 적용된 링크 |
|---|---|
https://www.braze.com#bookmark1?utm_source=email |
https://www.braze.com?lid=eqslgd5a9m3y#bookmark1?utm_source=email |
앵커와 캡처 태그가 있는 링크
로직: 앵커(#)가 포함된 URL에 링크 별칭 지정을 사용할 때, Braze는 앵커가 쿼리 파라미터 뒤에 위치할 것으로 예상합니다. 이는 올바른 추적을 위해 lid 값이 앵커 앞에 추가되어야 함을 의미하며, Braze가 URL을 왼쪽에서 오른쪽으로 읽기 때문에 물음표(?)와 lid가 앵커 앞에 와야 합니다.
| 이메일 본문 내 링크 | 별칭이 적용된 링크 |
|---|---|
<a href="https://www.braze.com/promotions#special-offer">Check out our special offer!</a> |
<a href="https://www.braze.com/promotions?lid={{link_alias}}#special-offer">Check out our special offer!</a> |
링크 별칭 추적
작성기 사이드바에서 콘텐츠 > 링크 관리(디자인 및 빌드 아래)를 선택한 다음, 추적하려는 별칭을 선택합니다. 추적된 별칭은 링크 별칭을 참조하는 세분화 필터에서 사용할 수 있습니다(세분화 필터 참조). 또한 사용자가 이메일에서 링크 별칭을 클릭할 때 액션 기반 메시지를 보내거나 Canvas를 통해 사용자를 이동시킬 수도 있습니다. 액션 기반 필터를 참조하세요. 추적 설정은 해당 링크의 클릭이 이메일 성능 리포팅에 집계되는지 여부에는 영향을 미치지 않습니다.

Braze에서는 추적할 링크를 무제한으로 선택할 수 있지만, 사용자가 가장 최근에 열어본 링크만 리타겟팅할 수 있습니다. 고객 프로필에는 가장 최근에 클릭한 링크 100개가 포함됩니다. 예를 들어, 500개의 링크를 추적하고 사용자가 500개 모두를 클릭한 경우, 가장 최근에 클릭한 100개의 링크를 기반으로 리타겟팅하거나 Segment를 생성할 수 있습니다.
액션 기반 필터
회사에서 링크 별칭 지정이 활성화되어 있으면, 모든 링크(추적 또는 미추적)를 타겟팅하는 액션 기반 메시지를 생성하거나 사용자가 이메일 Campaign 또는 Canvas 구성 요소에서 별칭을 클릭했는지 여부를 기반으로 리타겟팅할 수 있습니다.

- Campaign이 보관되면 링크 추적이 꺼지며 해당 링크 별칭은 다른 필터에서 사용할 수 없습니다.
- 링크에 추적이 활성화되어 있고 Campaign에서 클릭된 경우, 이후에 링크 추적이 꺼지더라도 해당 메시지에서 하나 이상의 링크가 여전히 추적되고 있는 한 세분화 필터에서 사용 가능한 옵션으로 Campaign을 찾을 수 있습니다.
- 추적된 링크를 필터로 선택하려면 활성(발신된) Canvas에 있어야 하며, 캔버스 단계에서 별칭 클릭 필터 드롭다운을 사용합니다. 링크가 Canvas 초안에서 추적되고 있는 경우에는 추적된 링크를 필터로 선택할 수 없습니다.
링크를 미추적으로 설정하려면 링크 별칭 관리를 참조하세요.
세분화 필터
Braze에서 이메일에 링크 별칭이 있고 사용자가 이를 클릭하면, 해당 이벤트는 별칭과 함께 사용자 프로필에 기록됩니다.
“모든 Campaign 또는 캔버스 단계에서 별칭 클릭” 세분화 필터를 사용한 후 나중에 이 링크 별칭의 이름을 변경하면, 고객 프로필의 이전 클릭 데이터는 업데이트되지 않으므로 여전히 이전 링크 별칭으로 표시됩니다. 따라서 새 링크 별칭을 기반으로 사용자를 타겟팅하면, 이전 링크 별칭의 데이터는 포함되지 않습니다.
“Campaign에서 별칭 클릭” 또는 “Canvas에서 별칭 클릭” 세분화 필터를 사용하면, 사용자가 특정 Campaign 또는 Canvas에서 특정 별칭을 클릭했는지 여부를 기준으로 필터링합니다. 여러 사용자가 동일한 이메일 주소를 공유하고 링크 별칭이 클릭된 경우, 해당 이메일 주소를 공유하는 다른 모든 사용자의 고객 프로필이 업데이트됩니다. 이러한 프로필은 클릭 이벤트뿐만 아니라 전달 및 열람 이벤트에 의해서도 업데이트됩니다.
다음 세분화 필터는 이벤트가 처리되는 시점에 추적되는 클릭 이벤트에 적용됩니다. 즉, 미추적 링크는 기존 데이터를 제거하지 않으며, 링크 추적을 시작해도 데이터가 소급 적용되지 않습니다. 자세한 내용은 세분화 필터를 참조하세요.
링크 추적 해제
링크 추적을 해제해도 미추적 별칭에 대한 기존 Segment가 재할당되지 않습니다. 이전 데이터는 새로운 데이터로 대체될 때까지 고객 프로필에 남아 있습니다.
보관된 메시지의 링크는 자동으로 추적이 해제됩니다. 그러나 보관된 메시지의 보관이 해제되면 링크를 다시 추적해야 합니다. 링크 별칭이 추적되면, 링크 리포팅은 최상위 도메인이나 전체 URL 대신 별칭으로 인덱싱됩니다.
이메일 Campaign의 모든 링크와 각각의 총 클릭 수를 보려면 메시지 분석 > 이메일 성능 > 미리보기 및 히트맵으로 이동하여 히트맵 표시 토글을 선택합니다.

이메일 클릭 이벤트
Currents로 인게이지먼트 데이터를 내보내면, 링크 별칭 지정이 활성화된 경우 이메일 클릭 이벤트가 약간 달라집니다. 링크 별칭 지정이 활성화되면 이메일 클릭 이벤트에 link_id와 link_alias라는 두 개의 추가 필드가 포함됩니다.
// Email Click: users.messages.email.Click
{
"id": (string) unique ID of this event,
"user_id": (string) Braze user ID of the user,
"external_user_id": (string) External ID of the user,
"time": (int) 10-digit UTC time of the event in seconds since the epoch,
"timezone": (string) IANA time zone of the user at the time of the event,
"campaign_id": (string) ID of the campaign if from a campaign,
"campaign_name": (string) name of the campaign,
"message_variation_id": (string) ID of the message variation if from a campaign,
"message_variation_name": (string) the name of the message variation if from a campaign,
"canvas_id": (string) ID of the Canvas if from a Canvas,
"canvas_name": (string) name of the Canvas,
"canvas_variation_id": (string) ID of the Canvas variation the user is in if from a Canvas,
"canvas_variation_name": (string) name of the Canvas variation the user is in if from a Canvas,
"canvas_step_id": (string) ID of the step for this message if from a Canvas,
"canvas_step_name": (string) name of the step for this message if from a Canvas,
"send_id": (string) ID of the message if specified for the campaign (See Send Identifier under API Identifier Types),
"dispatch_id": (string) ID of the message dispatch (unique ID for each 'transmission' sent from the Braze platform). Users who are sent a schedule message get the same dispatch_id. Action-based or API-triggered messages get a unique dispatch_id per user.,
"email_address": (string) email address for this event,
"url": (string) the URL that was clicked (Email Click events only),
"user_agent": (string) description of the user's system and browser for the event (Email Click and Open events only),
"ip_pool": (string) IP pool used for message sending,
"link_id": (string) unique value generated by Braze for the URL,
"link_alias": (string) alias name set when the message was sent
}

dispatch_id의 동작은 Canvas와 Campaigns 간에 다릅니다. Braze는 캔버스 단계(스케줄 가능한 진입 단계 제외)를 “예약된” 경우에도 트리거된 이벤트로 처리하기 때문입니다. Canvas와 Campaigns에서의 dispatch_id 동작에 대해 자세히 알아보세요.
2019년 8월에 업데이트됨.
Content Blocks에서의 링크 별칭 지정
새로운 Content Blocks는 링크가 수정되어, Braze가 해당하는 각 링크에 lid=를 추가합니다. 이 입력 안내 값은 이메일 메시지 배리언트에 삽입될 때 확인됩니다.
Braze가 링크 별칭 지정을 활성화하기 전에 생성된 기존 Content Blocks 내의 링크를 수정하려면, 기존 Content Blocks를 복제한 다음 복제된 Content Blocks 내의 링크를 수정하세요.
lid 값이 없는 콘텐츠 블록이 새 메시지에 삽입되면, 해당 콘텐츠 블록의 링크는 별칭으로 추적되지 않습니다. 새 콘텐츠 블록이 “이전” 메시지 배리언트에 삽입되면, 해당 메시지 배리언트의 링크는 링크 별칭 지정에 의해 인식됩니다. 콘텐츠 블록의 링크도 인식됩니다. 그러나 “이전” Content Blocks는 “새” Content Blocks를 중첩할 수 없습니다.

Content Blocks의 경우, Braze는 새 메시지에 사용할 기존 Content Blocks의 사본을 만들 것을 권장합니다. 이는 대량 복제를 통해 수행할 수 있으며, 새 메시지에서 링크 별칭 지정이 활성화되지 않은 콘텐츠 블록을 참조하는 시나리오를 방지할 수 있습니다.
Liquid로 생성된 URL에 대한 링크 별칭 지정
Liquid로 생성된 URL(예: HTML의 assign, Content Blocks에서 가져온 값, 또는 커스텀 속성의 Liquid)의 경우, Braze는 lid 쿼리 파라미터를 삽입할 명확한 위치가 필요합니다. 대부분의 경우 Liquid가 URL에 남아 있으면, 직접 구분 기호를 추가하지 않는 한 Braze는 ?로 새 쿼리 문자열을 시작할지 &로 기존 쿼리에 합류할지 추론하지 않습니다.
다음을 수행하세요:
- URL에 쿼리 문자열이 아직 포함되지 않은 경우, Liquid 뒤에
?를 추가합니다(예:?). - URL에
?와 쿼리 파라미터가 이미 포함된 경우, Liquid 뒤에&를 추가합니다(예:&).

Liquid로 생성된 URL과 함께 링크 템플릿을 사용할 때, 렌더링된 URL에 쿼리 구분 기호로 사용된 ? 문자가 정확히 두 개 포함되어 있으면, Braze는 Liquid 실행 후 보수적으로 렌더링된 URL을 정규화할 수 있습니다. 두 번째 ?는 Braze가 URL을 최소한으로 변경하도록 &로 재작성될 수 있습니다.
Braze는 모든 중복 ? 패턴을 수정하려 하지 않으며, 더 복잡한 URL의 처리는 의도적으로 제한됩니다. 마크업에서 먼저 올바른 ? 또는 &를 추가하고, 정규화를 제한적인 안전장치로 취급하세요—올바른 형식의 URL이나 구분 기호 없이 링크 관리에서 링크가 인식되도록 하는 것을 대체하지 않습니다.
후행 ? 또는 &(또는 다른 지원되는 삽입 지점)가 없으면, 링크 별칭 지정은 URL을 인식하지 못하고 링크 관리에 나열되지 않으며 링크 템플릿이 적용되지 않습니다.
URL 프래그먼트(#)와 추적 파라미터
프래그먼트(#와 그 뒤의 모든 내용)는 일반 링크 요청 시 서버로 전송되지 않습니다. Braze는 lid를 쿼리 문자열에 삽입하며, 이는 # 앞에 나타나야 합니다. href에 Liquid와 # 프래그먼트가 있지만 # 앞에 ? 또는 &가 없는 경우, Braze는 lid를 안전하게 추가할 수 없으므로 해당 링크가 링크 관리에 나타나지 않거나 링크 별칭으로 추적되지 않을 수 있습니다.
이는 드래그 앤 드롭 편집기에서 버튼 URL이 Liquid와 해시 기반 패턴을 혼합할 때(예: 정적 경로 다음에 #, 그 다음에 추가 키-값 페어) 특히 흔합니다. 이 경우 # 바로 앞에 ?를 추가하여 쿼리 문자열(lid 포함)이 프래그먼트 전에 파싱되도록 합니다.
https://example.com/campaign/to/abc123?#user_id={{${user_id}}}&source=email
위 예시에서 # 앞의 ?는 Braze에 lid를 추가할 쿼리 세그먼트를 제공합니다. 동적 URL에 대해 “LID 할당 실패”와 같은 오류가 표시되면, href가 이 섹션의 예시에 표시된 ? 또는 & 패턴을 사용하는지 확인하세요.
드래그 앤 드롭 편집기 고려사항
드래그 앤 드롭 편집기에서 링크를 보유하는 필드(예: 버튼 URL)는 Liquid 실행 전에 기본 href를 검증합니다. 공백, 줄바꿈 및 URL에 안전하지 않은 기타 문자는 Braze가 링크 템플릿 또는 링크 별칭 지정 파라미터를 추가할 때 예상치 못한 동작을 유발할 수 있습니다. 대상에 대해 분기 Liquid가 필요한 경우, HTML 블록에서 URL을 설정하고(다음 섹션 참조) 해당 필드에 복잡한 Liquid를 직접 넣는 대신 드래그 앤 드롭 URL 필드에서 단일 변수를 참조하세요.
Content Blocks 예시
Content Blocks에 후행 ? 또는 &가 없는 https://www.braze.com/{{custom_attribute.${offer_id}}} 같은 링크가 포함되어 있으면, Braze는 lid를 어디에 추가해야 하는지 알 수 없으므로 해당 링크는 링크 관리에서 선택되지 않습니다. Content Blocks의 URL 끝에 ? 또는 &를 추가하고(쿼리 문자열이 이미 존재하는지 여부에 따라), Content Blocks를 저장하면 링크가 인식될 수 있습니다.
URL이 사용자마다 다를 때의 리포팅
메시지의 각 고유 href는 링크 관리 및 별칭 기반 리포팅을 위해 하나의 링크 ID와 하나의 링크 별칭에 매핑됩니다. 링크 별칭이 추적되면, 대시보드 내 이메일 리포팅은 가능한 모든 해석된 URL이 아닌 별칭별로 인덱싱됩니다.
먼저 Braze에서 다음 접근 방식을 사용하세요:
- Campaign 및 Canvas 이메일 분석: 링크 추적 해제에 설명된 대로 Show Heatmap이 켜진 상태에서 Message Analytics > Email Performance > Preview & Heatmap에서 링크별 집계 클릭을 검토합니다.
- 쿼리 빌더에서 수신자별 클릭: Campaign 또는 Canvas에 대한 Email URLs clicked 쿼리 빌더 템플릿을 실행합니다. 이 템플릿은 요약 수 계산을 위한 비개인화된 링크를 표시하며, CSV 내보내기에는 클릭한 사용자의 사용자 ID, 클릭한 링크 및 타임스탬프가 포함됩니다. (비개인화된 URL은 요약 보기를 위해 Liquid 태그를 제거합니다. 자세한 내용은 템플릿 설명을 참조하세요.)
- 작성기에서 별칭 수준 세부 분석: 각 대상(예: 각
offer_id)이 링크 관리 및 별칭 기반 리포팅에서 자체 행으로 표시되어야 하는 경우, 경로가 사용자마다 변경되는 하나의 링크 대신 별도의href값(따라서 별도의 별칭)을 사용하세요—예를 들어, 브랜치별로 고유한 링크를 사용합니다.
스트리밍 인게이지먼트 내보내기도 사용하는 경우, 이메일 클릭 이벤트에는 url 필드가 포함됩니다. 해당 페이로드가 링크 별칭 지정과 어떻게 관련되는지는 이 페이지의 이메일 클릭 이벤트를 참조하세요.
예시
할당된 URL에 쿼리 파라미터가 없을 때 이 패턴을 사용합니다:
{% assign link1 = "https://www.braze1.com" %}
<a href="{{link1}}?">Visit Braze</a>
할당된 URL에 이미 ?와 쿼리 파라미터가 포함되어 있으면, ? 대신 Liquid 뒤에 &를 추가합니다:
{% assign link_with_params = "https://www.braze1.com?campaign=test" %}
<a href="{{link_with_params}}&">Visit Braze</a>
조건부 Liquid를 포함한 URL
href 내에서 조건부 Liquid 태그가 사용되는 경우(예: {% if %}, {% elsif %}, 또는 {% unless %}로 URL을 설정), 링크 별칭 지정은 해당 링크에 적용되지 않습니다. 즉, 이러한 링크는 링크 관리에 나타나지 않으며 클릭 추적을 위한 lid를 받지 못합니다.
권장: HTML 블록에서 assign(또는 {% capture %})을 사용하여 최종 URL을 구성한 다음 링크가 필요한 곳에서 해당 변수를 참조합니다. 드래그 앤 드롭 편집기에서는 버튼 URL 필드에 해당 변수를 적절한 후행 ? 또는 &와 함께 붙여넣습니다—예를 들어, ?.
{% if {{custom_attribute.${account_tier}}} == "pro" %}
{% assign url = "https://example.com/pro/verify" %}
{% else %}
{% assign url = "https://example.com/retail/account" %}
{% endif %}
버튼 URL 필드(드래그 앤 드롭) 또는 HTML에서 구분 기호와 함께 href를 변수로 지정합니다:
<a href="{{ url }}?">Go to account</a>
또는 URL을 하나의 변수로 캡처할 수 있습니다:
{% capture url %}
{%- if condition -%}
https://example.com/url1
{%- else -%}
https://example.com/url2
{%- endif -%}
{% endcapture %}
<a href="{{ url }}?">Go to account</a>
문제 해결
링크 관리 페이지 또는 설정이 누락된 경우
대시보드가 이 문서의 내비게이션과 일치하지 않는 경우, 다음 표를 참고하여 원인을 확인하세요.
| 누락된 항목 | 원인 | 해결 방법 |
|---|---|---|
| 이메일 작성기 사이드바의 Link Management | 회사에 링크 별칭 지정이나 링크 템플릿이 모두 활성화되지 않았습니다. | Braze 계정 매니저에게 문의하세요. Braze에서 링크 별칭 지정 없이 링크 템플릿만 활성화한 경우, Link Management가 표시되어 템플릿을 적용할 수 있지만 별칭을 지정하거나 추적할 수는 없습니다. |
| Content Blocks의 Link Management | Link Management 사이드바는 Campaign 및 Canvas 이메일 작성기에서만 표시됩니다. | Content Blocks를 사용하는 Campaign 또는 Canvas에서 별칭을 추가하고 이름을 지정하세요. Content Blocks에서의 링크 별칭 지정을 참조하세요. |
| 설정 > 이메일 환경설정의 Link Aliasing Settings 탭 | “View Email Settings” 권한이 없어서 이메일 환경설정을 열 수 없거나, 페이지를 열 수 있지만 회사에 링크 별칭 지정이 활성화되지 않았습니다. | 워크스페이스 관리자에게 “View Email Settings” 권한을 요청하세요. 이메일 환경설정을 열 수 있는데도 탭이 누락된 경우, Braze 계정 매니저에게 링크 별칭 지정 활성화를 요청하세요. |
| 템플릿 아래의 Email Link | 회사에 링크 템플릿이 활성화되지 않았거나, 링크 템플릿 권한이 없습니다. | 링크 템플릿을 참조하세요. |
| Link Management의 특정 링크 | Braze가 lid 매개변수를 추가할 안전한 위치를 찾지 못했습니다. |
Liquid로 생성된 URL에 대한 링크 별칭 지정을 참조하세요. |
URL에 lid 매개변수가 누락된 경우
경우에 따라 HTML 이메일 편집기의 URL에 링크 별칭 지정을 위한 링크 식별자(lid) 쿼리 매개변수 및 값이 누락될 수 있습니다. 이는 다음과 같은 시나리오에서 발생할 수 있습니다:
- 닫히지 않은 HTML 주석(
<!--) 또는 닫히지 않은<style>또는<script>태그: Braze가 링크 별칭 지정을 위해 링크를 감지하거나 업데이트하지 못하게 하는 가장 일반적인 마크업 문제입니다.<div>와 같이 닫히지 않은 요소는 일반적으로 이 문제를 일으키지 않습니다. VS Code와 같은 코드 편집기 또는 IDE를 사용하여 이러한 태그를 찾아 닫으세요. - HTML에서 이스케이프되지 않은 특수 문자: HTML 속성 또는 본문 콘텐츠의
<및>와 같은 문자는 HTML 엔티티(예:<및>)를 사용해야 합니다. 이스케이프되지 않은 문자는 HTML 파싱을 깨뜨리고 Braze가 링크 별칭 지정을 위해 링크를 감지하거나 업데이트하지 못하게 할 수 있습니다. 자세한 내용은 HTML 기호를 참조하세요. - 따옴표 불일치(
',"): HTML 미리보기 도구 또는 코드 편집기를 사용하여 따옴표가 불일치하는지 감지할 수 있습니다. VS Code에는 내장 HTML 미리보기 기능이 있으며 따옴표 불일치를 감지할 수 있습니다. - 일반 따옴표가 아닌 특수 따옴표 문자: MS Word와 같은 문서 편집기에서 HTML을 복사하여 붙여넣으면 일부 서식이 그대로 전달되어 일부 따옴표가 따옴표처럼 보이는 특수 문자를 사용할 수 있습니다. 권장되는 방법은 HTML을 코드 편집기에 붙여넣고 올바른 따옴표 문자가 사용되었는지 확인하는 것입니다.
lid 매개변수를 허용하지 않는 대상
이메일 편집기에서 테스트 메시지를 보내면 Braze가 링크에 lid={{placeholder}}를 추가합니다(플레이스홀더는 전송 시 고유 값으로 대체됩니다). 대상 사이트 또는 API가 추가 쿼리 매개변수를 허용하지 않는 경우, 편집기에서는 링크가 작동하지만 이메일에서 열었을 때 실패할 수 있습니다.
lid 값이 없으면 Braze는 해당 URL을 추적 및 세분화를 위한 링크 별칭으로 처리하지 않습니다. 백엔드 또는 사이트에서 lid 쿼리 매개변수가 있을 때 이를 무시하도록 업데이트하는 것을 권장합니다. 이렇게 하면 이 문서에서 설명한 링크 별칭 지정, 리포팅 및 Segment 사용 사례가 유지됩니다.
백엔드 변경을 계획하는 동안 설정 > 이메일 환경설정 > Link Aliasing Settings에서 영향받는 별칭의 추적을 해제할 수 있습니다. 추적 해제를 해도 lid 매개변수는 제거되지 않습니다. 추적 해제가 Segments 및 필터에 미치는 영향은 링크 추적 해제를 참조하세요.
Braze가 lid를 추가하지 않도록 하려면 Braze 지원팀에 연락하여 회사의 링크 별칭 지정을 해제해 달라고 요청하세요. 링크 별칭 지정이 해제되면 다음 사항을 고려하세요:
- 새 이메일 메시지 및 Content Blocks는 일반적으로 새로운 링크 별칭 마크업(
lid쿼리 매개변수 등)을 받지 않습니다. - 링크 별칭 지정이 활성화된 상태에서 생성된 기존 메시지는 HTML에 여전히 링크 별칭 마크업을 포함할 수 있습니다. 더 이상 원하지 않는 곳에서 남아 있는
lid매개변수를 수동으로 제거해야 할 수 있습니다. - 기존 Campaign, Canvas 이메일 단계 또는 Content Blocks를 편집하는 경우, 템플릿이 적용된 링크가 올바르게 표시되도록 링크 템플릿을 다시 추가해야 할 수 있습니다.
- 링크 별칭 지정이 활성화된 상태에서 발송된 메시지의 클릭 리포팅은 기능 해제 이후의 리포팅과 깔끔하게 일치하지 않을 수 있습니다.
- 링크 별칭 기반 필터(예: Clicked Alias 필터)를 사용하는 Segments는 예상한 오디언스를 반환하지 않을 수 있습니다.