Content Card 메시지 받은편지함에 푸시 알림 유지하기

알림을 닫은 후에도 중요한 푸시 콘텐츠를 계속 확인할 수 있습니다. 같은 내용의 Content Card를 커스텀 앱 내 메시지 받은편지함으로 보내고, 키-값 페어로 받은편지함을 필터링하세요.

이 예시에 대해

가상의 모바일 뱅킹 브랜드인 Pyrite Financial은 Braze로 푸시 알림을 보내기 시작했습니다. 소비자가 푸시 알림을 닫으면 해당 메시지는 기기 UI에서 사라집니다.

마케팅 팀과 제품 팀은 소비자가 앱의 종 아이콘을 눌러 메시지 받은편지함을 계속 열어볼 수 있기를 원합니다. 소비자는 받은편지함에서 문서 준비 알림, 트랜잭션 알림, 예정된 서비스 중단 메시지를 다시 열 수 있습니다.

이 팀은 이미 앱의 다른 영역(예: 아티클)에서 Content Cards를 사용하고 있습니다. 이 패턴은 두 번째 Content Card 노출 위치로, 다음을 받을 수 있는 메시지 받은편지함을 추가합니다.

• 푸시 알림만
• Content Card만
• 푸시 알림과 이에 대응하는 Content Card를 함께

푸시 알림을 탭할 때와 Content Card를 탭할 때 같은 목적지(예: 문서)로 딥링크할 수 있습니다. 일부 푸시 메시지는 탭하면 받은편지함 자체가 열립니다.

이 예시는 푸시 알림과 Content Card 전달을 조율하는 방법을 보여줍니다. SDK에서 커스텀 받은편지함 UI를 구축하려면 튜토리얼: Content Card 받은편지함을 참조하세요. 카드 레이아웃에 대한 자세한 내용은 커스텀 Content Cards 만들기를 참조하세요.

고려 사항

• Content Cards는 전송 후 최대 30일 동안 유지됩니다. 닫은 카드를 포함해 사용자당 만료되지 않은 카드 250개의 피드 한도에 포함됩니다. 각 카드 페이로드는 Liquid 렌더링 후 2 KB로 제한됩니다. Content Card 만들기를 참조하세요.
• 앱의 다른 곳에서 이미 Content Cards를 사용하고 있다면 키-값 페어(예: feed_type: inbox와 feed_type: article)를 사용해 노출 위치를 분리하세요. 그러면 각 화면에는 해당 카드만 표시됩니다. 앱에서 필터링하기 전까지 모든 카드는 하나의 SDK 피드를 공유합니다. Content Card 피드 커스터마이징을 참조하세요.
• Content Cards는 세션 시작 시 자동으로 새로 고쳐집니다. 추가 새로 고침에는 requestContentCardsRefresh를 사용합니다. 받은편지함을 열 때나 당겨서 새로 고침할 때 새로 고치세요. 새로 고침 사용량 제한에 걸리지 않도록 계속 새로 고치거나 탭을 이동할 때마다 새로 고치는 것은 피하세요.
• 커스텀 받은편지함 UI는 노출 횟수, 클릭, 닫기를 로깅하는 작업을 수동으로 처리해야 합니다. 읽지 않음 배지(예: 종 아이콘의 점)는 앱에서 관리합니다.
• 받은편지함에 유지해야 하는 모든 푸시 알림에는 대응하는 Content Card가 필요합니다. 올바른 키-값 페어와 딥링크를 포함하세요. Content Card 채널이 빠지지 않도록 멀티채널 Campaign(캠페인) 템플릿이나 Canvas 템플릿을 사용하세요.
• 후속 로직 없이 푸시 알림과 Content Card를 동시에 보내려면 멀티채널 Campaign을 사용하세요. 지연, 분기, 재참여, 또는 인게이지먼트에 따른 후속 단계가 필요하다면 Canvas를 사용하세요.

설정

1단계: 받은편지함 키-값 페어와 딥링크 정의하기

앱이 받은편지함 카드를 필터링하고 처리하는 데 사용할 extras(키-값 페어)를 정합니다. 다음 표는 예시 세트를 보여줍니다.

사용 사례별로 딥링크 대상을 정합니다. 다음 표는 예시 대상을 보여줍니다.

엔지니어링 팀에 이 키를 기준으로 필터링, 선택적 읽지 않음 상태, 분석을 구현하도록 요청하세요. 모든 받은편지함 Content Card에 같은 키를 재사용하세요.

2단계: 멀티채널 Campaign 또는 Canvas 선택하기

여정에 따라 멀티채널 Campaign 또는 Canvas를 선택합니다. 다음 표는 두 가지 경로를 비교합니다.

이 패턴의 예시는 Canvas의 Content Cards — 푸시 알림 받은편지함을 참조하세요.

3단계: 메시지 전달 구성하기

멀티채널 Campaign

1. 메시징 > 캠페인으로 이동하여 캠페인 생성을 선택한 다음 멀티채널을 선택합니다.
2. 작성 단계에서 채널 추가를 선택하고 푸시와 Content Cards를 추가합니다.
3. 푸시 알림을 작성합니다. 클릭 시 동작에서 받은편지함 또는 다른 앱 내 목적지로 딥링크를 설정합니다.
4. 같은 내용이거나 보완하는 문구로 Content Card를 작성합니다. 설정 탭에서 새 페어 추가를 선택하고 1단계의 받은편지함 키-값 페어를 추가합니다. Content Card 딥링크를 설정합니다.
5. 새 문서와 같은 이벤트에는 실행 기반 전달을 스케줄합니다. 예정된 서비스 중단에는 예약 전달을 사용합니다. 오디언스를 정의합니다.
6. 이후 받은편지함과 연동되는 푸시 Campaigns에 Content Card 채널과 같은 extras가 포함되도록 템플릿이나 체크리스트를 저장합니다.

Canvas

1. 메시징 > Canvas로 이동한 다음 Canvas 생성을 선택합니다. 여정의 진입 스케줄과 오디언스를 설정합니다(예: 문서가 준비되었을 때의 커스텀 이벤트).
2. 푸시와 Content Cards를 모두 포함하는 메시지 단계를 추가합니다. 흐름에 필요하다면 연속된 메시지 단계를 사용합니다.
3. 딥링크와 받은편지함 키-값 페어를 포함해 Campaign 경로와 같은 방식으로 푸시 알림과 Content Card를 작성합니다.
4. 필요에 따라 Content Card 인게이지먼트를 활용하는 후속 단계를 추가합니다. 예를 들어 48시간 이내에 클릭이 없으면 후속 메시지를 보냅니다. 이러한 필터에 의존하기 전에 커스텀 받은편지함이 어떤 분석을 로깅하는지 확인하세요.

4단계: 앱 받은편지함 동작 확인하기

출시 전에 엔지니어링 팀과 함께 앱이 다음을 수행하는지 확인하세요.

1. 앱 수명 주기 초기에 Content Card 업데이트를 한 번 구독합니다. 이미 다른 곳에서 Content Cards를 운영하고 있다면 기존 구독을 재사용합니다.
2. 캐시된 카드로 받은편지함을 렌더링한 다음, 열 때나 당겨서 새로 고침할 때 새로 고칩니다.
3. extras가 받은편지함과 일치하는 카드(예: feed_type이 inbox인 카드)만 필터링합니다.
4. 커스텀 UI에 대한 노출 횟수, 클릭, 닫기를 로깅합니다. React Native에서는 다음 SDK 메서드를 사용합니다.
   • getCachedContentCards
   • requestContentCardsRefresh
   • logContentCardImpression
   • logContentCardClicked
   • logContentCardDismissed
   • processContentCardClickAction
   • 지원 중단된 getContentCards 메서드보다 getCachedContentCards를 사용하세요.
5. 소비자가 관련 작업을 완료하면(예: 문서에서 doc_id를 열면) 선택적으로 카드를 닫습니다. 받은편지함에서 닫기를 탭하는 방식에 더해 이 방식도 함께 사용합니다.

5단계: 세 가지 전달 방식 테스트하기

• 푸시 알림만: 알림이 도착하고 받은편지함 카드는 표시되지 않습니다.
• Content Card만: 카드가 받은편지함에 표시되고 푸시 알림은 전송되지 않습니다.
• 푸시 알림과 Content Card: 둘 다 함께 전송되고 딥링크가 설계대로 동작합니다. 푸시 알림을 닫은 후에도 카드가 남아 있습니다. 읽지 않음 배지, 닫기, 분석이 예상대로 동작합니다.

테스트 중에 사용량 제한으로 받은편지함 업데이트가 차단되지 않도록 실제와 비슷한 탐색 상황에서 새로 고침을 테스트하세요.

관련 문서

• Content Card 만들기
• Canvas의 Content Cards
• 멀티채널 Campaign 만들기
• 튜토리얼: Content Card 받은편지함
• 커스텀 Content Cards 만들기
• Content Card 피드 커스터마이징
• Content Card 분석 로깅
• 푸시 메시지 만들기