콘텐츠 카드 만들기

이 문서에서는 Campaign 및 Canvases를 구축할 때 Braze에서 콘텐츠 카드를 만드는 방법을 다룹니다. 여기서는 메시지 유형 선택, 카드 작성, 메시지 전달 스케줄 설정 과정을 안내합니다.

1단계: 메시지를 작성할 위치 선택하기

단일하고 간단한 메시징(예: 하나의 메시지로 사용자에게 제품을 알리는 경우)에는 Campaign을 사용하세요. 여러 단계로 이루어진 사용자 여정(예: 시간 경과에 따른 사용자 행동을 기반으로 맞춤형 제품 추천을 보내는 경우)에는 Canvases를 사용하세요.

• campaign
• canvas

2단계: 메시지 유형 지정

세 가지 필수 콘텐츠 카드 유형인 클래식, 캡션 이미지, 이미지 전용 중 하나를 선택합니다.

각 유형의 예상 동작과 모양에 대해 자세히 알아보려면 크리에이티브 세부 정보를 참조하거나 다음 표의 링크를 확인하세요. 이러한 콘텐츠 카드 유형은 모바일 앱과 웹 애플리케이션 모두에서 지원됩니다.

메시지 유형	예시	설명
클래식		클래식 카드는 굵은 제목, 메시지 텍스트, 그리고 제목과 텍스트의 시작 부분에 배치되는 선택적 이미지로 구성된 간단한 레이아웃을 갖추고 있습니다. 클래식 카드에는 정사각형 이미지나 아이콘을 사용하는 것이 가장 좋습니다.
캡션 이미지		캡션 이미지 카드는 문구와 시선을 사로잡는 이미지로 콘텐츠를 돋보이게 합니다.
이미지 전용		이미지 전용 카드는 이미지, GIF 및 기타 텍스트가 아닌 크리에이티브 콘텐츠를 위한 공간으로 주목을 끕니다.

3단계: 콘텐츠 카드 작성

메시지 편집기의 작성 탭에서 메시지 콘텐츠와 동작의 모든 측면을 편집할 수 있습니다.

여기에 표시되는 내용은 이전 단계에서 선택한 카드 유형에 따라 달라지지만, 다음 옵션 중 일부가 포함될 수 있습니다.

언어

언어 추가를 선택하여 제공된 목록에서 원하는 언어를 추가합니다. 이렇게 하면 메시지에 Liquid가 삽입됩니다. Liquid 내 적절한 위치에 텍스트를 채울 수 있도록 콘텐츠를 작성하기 전에 언어를 먼저 선택하는 것을 권장합니다. 사용 가능한 전체 언어 목록은 지원되는 언어를 참조하세요.

오른쪽에서 왼쪽으로 쓰는 메시지 만들기

오른쪽에서 왼쪽으로 쓰는 메시지의 최종 모양은 서비스 제공업체가 메시지를 렌더링하는 방식에 따라 크게 달라집니다. 최대한 정확하게 표시되는 오른쪽에서 왼쪽으로 쓰는 메시지를 작성하는 모범 사례는 오른쪽에서 왼쪽으로 쓰는 메시지 만들기를 참조하세요.

제목 및 메시지

원하는 내용을 자유롭게 작성하세요. 제한은 없지만, 메시지를 빠르게 전달하고 고객이 클릭하도록 유도할수록 좋습니다! 명확하고 간결한 제목과 메시지 콘텐츠를 권장합니다. 이미지 전용 카드에는 이 필드가 제공되지 않습니다.

이미지

콘텐츠 카드에 이미지를 추가하려면 이미지 추가를 선택하거나 이미지 URL을 입력하면 됩니다. 이미지 추가를 선택하면 미디어 라이브러리가 열리며, 여기에서 이전에 업로드한 이미지를 선택하거나 새 이미지를 추가할 수 있습니다.

메시지 유형과 플랫폼마다 권장 비율과 요구 사항이 다를 수 있으므로 새 이미지를 의뢰하거나 만들기 전에 반드시 확인하세요. 콘텐츠 카드 메시지 필드의 총 크기는 2 KB로 제한된다는 점에 유의하세요.

상단에 고정

Braze는 고정 카드를 사용자 피드의 상단에 표시하며, 사용자는 이를 닫을 수 없습니다. 사용자 피드에 고정 카드가 여러 개 있는 경우 Braze는 시간순으로 정렬합니다. Braze가 콘텐츠 카드를 전달할 때 카드는 고정 또는 고정 해제 상태 중 하나이며, 이 상태는 카드의 수명 동안 변경되지 않습니다. Campaign의 고정 설정을 변경하면 변경 이후에 전송된 카드에만 업데이트가 적용됩니다. 이미 사용자 피드에 있는 카드의 고정 상태는 변경되지 않습니다.

클릭 시 동작

고객이 카드에 표시된 링크를 클릭하면 앱 내부로 더 깊이 이동하거나 다른 사이트로 이동하도록 할 수 있습니다. 콘텐츠 카드의 클릭 시 동작을 선택한 경우 링크 텍스트도 그에 맞게 업데이트하세요.

콘텐츠 카드 링크에서 사용할 수 있는 작업은 다음과 같습니다.

작업	설명
웹 URL로 리디렉션	네이티브가 아닌 웹 페이지를 엽니다.
앱으로 딥링크	앱의 기존 화면으로 딥링크합니다.
커스텀 이벤트 기록	트리거할 커스텀 이벤트를 선택합니다. 다른 콘텐츠 카드를 표시하거나 추가 메시징을 트리거하는 데 사용할 수 있습니다.
커스텀 속성 기록	현재 사용자에게 설정할 커스텀 속성을 선택합니다.

커스텀 이벤트 기록 및 커스텀 속성 기록 옵션을 사용하려면 다음 SDK 버전 호환성이 필요합니다.

4단계: 추가 설정 구성(선택 사항)

키-값 페어를 사용하여 카드의 카테고리를 만들고, 여러 콘텐츠 카드 피드를 만들고, 카드 정렬 방식을 커스텀할 수 있습니다.

메시지에 키-값 페어를 추가하려면 설정 탭으로 이동하여 새 페어 추가를 선택합니다.

5단계: Campaign 또는 Canvas의 나머지 부분 빌드하기

• campaign
• canvas

6단계: 검토 및 배포

Campaign 또는 Canvas 구축을 마친 후 세부 정보를 검토하고 테스트한 다음 전송하세요. 자세한 내용은 테스트 메시지 보내기를 참조하세요.

다음으로 콘텐츠 카드 보고를 확인하여 콘텐츠 카드 캠페인의 결과에 액세스하는 방법을 알아보세요.

알아두어야 할 사항

페이로드 및 피드 제한

성능을 위해 Content Cards에는 두 가지 주요 제약이 있습니다. 하나는 카드별 페이로드 크기 제한이고, 다른 하나는 피드에 표시할 수 있는 최대 카드 수입니다.

Content Cards의 크기 제한

단일 콘텐츠 카드의 전체 데이터 페이로드는 Liquid 개인화가 렌더링된 후에 2KB를 초과할 수 없습니다. 여기에는 다음이 포함됩니다.

• 제목
• 메시지
• 이미지 URL(이미지 파일 크기가 아니라 URL 문자열 자체의 길이)
• 링크 텍스트
• 지정한 모든 플랫폼의 링크 URL(iOS, Android, 웹용 URL을 각각 지정하면 모두 합계에 포함됩니다)
• 키-값 페어(키 이름과 값 모두)

Liquid로 커스텀 속성 등에서 긴 텍스트 문자열을 가져오면 제한을 초과할 수 있습니다.

정적 콘텐츠가 제한을 초과하면 Campaign 작성기에 경고가 표시됩니다. 다만 Liquid를 사용하는 동적 콘텐츠의 크기는 미리 예측하지 않습니다. 메시지 크기가 2KB를 초과하면 전송 시점에 중단됩니다. 이렇게 중단된 전송은 Messaging Observability에서 Content Card invalid 성과로 확인할 수 있습니다.

콘텐츠 카드 페이로드 크기를 관리하는 모범 사례는 다음과 같습니다.

• 긴 링크에는 URL 단축기를 사용하세요. 추적 매개변수가 많이 붙은 URL은 크기 제한에 걸리기 쉽습니다. URL 단축 서비스를 사용하면 문자 수를 크게 줄여 페이로드 공간을 확보할 수 있습니다.
• Liquid로 동적 콘텐츠를 잘라내세요. 사용자 속성이나 API 호출에서 가져온 동적 텍스트로 카드를 개인화하면 콘텐츠 길이를 예측하기 어렵습니다. truncate 같은 Liquid 필터를 미리 사용해 동적 텍스트의 길이를 제한하세요.
• 멀티 플랫폼 URL을 효율적으로 사용하세요. 2KB 제한에는 정의한 모든 플랫폼의 URL이 포함됩니다. 플랫폼마다 길고 서로 다른 URL을 사용하면 페이로드 크기가 몇 배로 늘어날 수 있습니다. 가능하면 모든 플랫폼에서 작동하는 단일 링크를 사용하고, 필요에 따라 URL 단축기를 활용하세요.
• 풍부한 콘텐츠에는 배너를 고려하세요. 항상 많은 양의 콘텐츠가 필요한 사용 사례라면 Content Cards가 적합한 채널이 아닐 수 있습니다. 배너에는 2KB 페이로드 제한이 없으므로 앱이나 웹사이트 경험에 풍부한 콘텐츠를 직접 임베드하는 데 더 적합합니다.

피드의 카드 수

각 사용자는 피드에 만료되지 않은 콘텐츠 카드를 언제든 최대 250개까지 보유할 수 있습니다. 이 한도를 초과하면 Braze는 읽지 않은 카드라도 가장 오래된 카드부터 반환하지 않습니다. 닫은 카드도 이 한도에 포함되므로, 닫은 카드가 많으면 오래된 카드가 들어갈 공간이 줄어들 수 있습니다.

카드 한도 관련 문제를 방지하려면 다음 모범 사례를 따르는 것이 좋습니다.

• 만료일을 짧게 설정하세요: 주말 세일처럼 시기가 중요한 Campaign에는 구체적인 만료일을 설정하세요. 이렇게 하면 카드가 더 이상 의미가 없어진 뒤 피드에서 자동으로 제거되어 한도에 포함되지 않습니다.
• 실행 기반 제거를 활용하세요: 트랜잭션성 카드나 목표 기반 카드에는 제거 이벤트를 설정하세요. 예를 들어 사용자에게 프로필 완성을 유도하는 카드는 profile_completed 이벤트가 기록되는 즉시 제거되어야 합니다.
• 장기 실행 Campaign을 점검하세요: 반복 또는 진행 중인 Campaign을 검토하여 시간이 지나면서 피드에 카드가 너무 많이 쌓여 사용자 경험을 해치지 않는지 확인하세요.

Content Cards의 재자격 이해하기

재자격은 사용자가 같은 Campaign의 메시지를 두 번 이상 받을 수 있는지, 받을 수 있다면 언제 받을 수 있는지를 결정합니다. Content Cards에서는 재자격의 작동 방식을 이해하는 것이 반복 Campaign을 관리하고 사용자가 중복되거나 오래된 메시지를 받지 않도록 하는 데 매우 중요합니다.

재자격 계산 방식

재자격을 켜면 사용자가 Campaign에 ‘재진입’할 수 있는 시점까지의 카운트다운은 메시지가 전송된 후에 시작됩니다. 카운트다운이 시작되는 정확한 시점은 카드 생성 설정에 따라 다릅니다.

• 첫 노출 시 생성되는 Content Cards는 노출 시간을 기준으로 재자격을 계산합니다.
• Campaign 실행 시, 멀티채널 Campaign에서, 또는 캔버스 단계 진입 시 생성되는 Content Cards는 전송 시간과 노출 시간 중 더 늦은 시간을 기준으로 합니다.

30일 만료와 재자격

흔히 혼동되는 부분은 Campaign 재자격과 모든 Content Cards에 적용되는 자동 30일 만료 사이의 상호작용입니다.

모든 Content Cards는 전송 또는 제거된 후 30일이 지나면 Braze 시스템에서 자동으로 삭제됩니다. 재자격을 끈 상태로 장기간 반복 실행되는 Campaign이 있다면, 사용자가 30일 후 같은 카드를 다시 받을 수 있습니다. 원래 카드가 삭제되면 시스템에 해당 사용자가 Campaign을 받았다는 기록이 더 이상 남지 않으므로, 다음 세션에서 다시 자격을 갖게 되기 때문입니다.

사용자가 특정 Campaign의 메시지를 한 번만 받도록 하려면, Campaign 또는 캔버스 단계에 이 Campaign에서 메시지를 받지 않은 사용자를 대상으로 하는 오디언스 필터를 추가하세요. 이 필터는 장기 실행 Campaign에서 중복 전송을 방지하는 가장 확실한 방법입니다.

실시간 Content Cards 관리하기

Content Cards는 전송된 후 이메일과 비슷하게 ‘받은편지함’에서 사용자에게 전달될 준비를 한 채 대기합니다. 콘텐츠가 표시 시점에 콘텐츠 카드에 반영된 후에는 카드가 유지되는 동안 변경할 수 없습니다. 연결된 콘텐츠를 통해 API를 호출하고 엔드포인트의 데이터가 변경되더라도 마찬가지이며, 해당 데이터는 업데이트되지 않습니다. 새 사용자에게 전송되지 않도록 중지하거나 사용자 피드에서 제거하는 것만 가능합니다. Campaign을 수정하면 수정 이후에 전송된 카드에만 변경 사항이 반영됩니다.

실행된 카드 업데이트하기

이미 카드를 받은 사용자에게 변경된 카드를 보여주려면 다음 방법 중 하나를 사용해야 합니다.

옵션 1: Campaign 복제(즉시 변경이 필요한 경우 권장)

첫 번째 방법은 Campaign을 보관하고 복제한 새 Campaign을 실행하는 것입니다.

1. 원래 Campaign을 중지하고, 메시지가 표시되면 Remove card after the next sync를 선택합니다.
2. Campaign을 복제하고 수정한 다음 새 버전을 실행합니다.

Campaign을 복제할 때는 새 버전의 오디언스를 정의해야 합니다. 세분화 필터를 사용해 업데이트된 카드를 받을 사용자를 제어하세요.

• 사용자가 콘텐츠 카드에 다시는 재자격을 얻지 않아야 한다면, Received Message from Campaign 필터의 조건을 Has Not으로 설정하여 이전 버전의 콘텐츠 카드를 받지 않은 사용자를 필터링할 수 있습니다.
• 이전 카드를 받은 사용자가 X일 후 재자격을 얻어야 한다면, Last Received Message from specific campaign 필터를 X일보다 더 이전으로 설정하거나(OR) Received Message from Campaign 필터를 Has Not 조건으로 설정할 수 있습니다.

영향

• 기존 수신자: 자격이 있는 새 수신자와 기존 수신자 모두 다음 피드 새로고침 시 업데이트된 카드를 봅니다.
• 보고: 카드의 각 버전에 별도의 분석이 제공됩니다.

예를 들어 세션 시작으로 트리거되고 재자격이 30일로 설정된 Campaign이 있다고 가정해 보겠습니다. 한 사용자가 이틀 전에 Campaign을 받았고, 문구를 변경하려고 합니다. 먼저 Campaign을 보관하고 피드에서 카드를 제거합니다. 다음으로 Campaign을 복제하고 새 문구로 다시 실행합니다. 사용자가 다시 세션을 시작하면 즉시 새 카드를 받습니다.

옵션 2: 같은 Campaign을 중지했다가 다시 실행

이 방법은 모든 분석을 하나의 Campaign에 통합하여 유지합니다. 새로 자격을 얻은 사용자는 새 카드를 받지만, 기존 수신자는 재자격을 얻을 때까지 업데이트가 지연됩니다.

1. Campaign을 중지하고, 메시지가 표시되면 Remove card after the next sync를 선택합니다.
2. 필요에 따라 Campaign을 수정합니다.
3. Campaign을 다시 시작합니다.

영향

• 기존 수신자: 이미 카드를 받은 사용자는 재자격을 얻을 때까지 업데이트된 카드를 받지 않습니다. 재자격이 꺼져 있으면 새 카드를 절대 받지 않습니다.
• 보고: 실행된 모든 카드 버전의 보고 분석이 하나의 Campaign에 포함됩니다. Braze는 실행된 버전을 구분하지 않습니다.

예를 들어 세션 시작으로 트리거되고 재자격이 30일로 설정된 Campaign이 있다고 가정해 보겠습니다. 한 사용자가 이틀 전에 Campaign을 받았고, 문구를 변경하려고 합니다. 먼저 Campaign을 중지하고 피드에서 카드를 제거합니다. 다음으로 새 문구로 Campaign을 다시 게시합니다. 사용자가 다시 세션을 시작하면 28일 후에 새 카드를 받습니다.

카드 제거 및 만료

수동 카드 제거

Campaign을 중지하면 언제든지 모든 사용자 피드에서 카드를 수동으로 제거할 수 있습니다.

1. 콘텐츠 카드 Campaign을 열고 Stop Campaign을 선택합니다.
2. 메시지가 표시되면 Remove card after the next sync를 선택합니다. 다음 피드 새로고침 시 카드가 제거됩니다.

자동 카드 제거

사용자가 구매 완료나 기능 활성화 같은 특정 행동을 수행하면 카드를 자동으로 제거할 수 있습니다.

Campaign 또는 캔버스 단계에서 제거 이벤트를 지정하세요. 사용자가 해당 이벤트를 수행하면 Braze가 이벤트를 처리한 다음 사용자의 피드에서 카드를 제거합니다.

카드 만료

Content Cards는 전송된 시점부터 최대 30일 동안 유지되며, 30일이 지나면 Braze가 사용자 피드에서 제거하고 Braze 시스템에서 삭제합니다.

카드를 30일보다 오래 유지하기

카드가 항상 표시되는 것처럼 보이게 하려면, 30일마다 카드를 사실상 교체하는 반복 Campaign을 만들 수 있습니다.

1. 콘텐츠 카드의 기간을 30일로 설정합니다.
2. Campaign 재자격을 30일로 설정합니다.
3. Campaign이 “Session Start” 시 트리거되도록 설정합니다.

콘텐츠 카드 동기화 및 새로고침

Content Cards는 정해진 일정에 따라, 그리고 앱이 피드를 새로고침할 때 동기화됩니다. 동기화 동작은 전체 동기화와 부분 동기화에 따라 다르며, SDK 통합 방식에 따라 세션 시작 시 카드가 새로고침되는 시점이 달라집니다. 지원되는 SDK 버전에서는 Braze가 실시간 전달을 통해 활성 세션 중에도 전송 및 제거 사항을 전달합니다. 구현에 관한 자세한 내용은 콘텐츠 카드 피드 커스터마이징 및 Content Cards 만들기를 참조하세요.

Content Cards Campaign 중지의 영향

Campaign을 중지하고 Remove card after the next sync를 선택하면 Braze는 다음 새로고침 시 사용자 피드에서 카드를 제거합니다. 사용자가 카드를 보기 전에 제거되면 노출이 발생하지 않으므로, 노출 횟수가 전송 횟수보다 적을 수 있습니다.

문제 해결

트리거 이벤트 후 Content Cards가 즉시 표시되지 않는 이유는 무엇인가요?

실행 기반 전달 Campaign(예: 세션 시작)의 경우, 트리거 이벤트가 발생한 후 카드를 사용할 수 있게 되기까지 짧은 지연이 발생하는 것이 정상입니다. 이 지연은 다음과 같은 이유로 발생합니다:

• 트리거 이벤트가 Braze 서버로 플러시됩니다.
• Campaign이 트리거되고 사용자의 자격이 기록됩니다.
• 해당 사용자에 대한 콘텐츠 카드가 데이터베이스에 생성됩니다.
• 카드가 기기에 도달합니다.

지원되는 SDK 버전에서는 실시간 전달을 통해 Braze가 카드를 생성하는 즉시 기기로 전송하므로, 카드가 현재 세션 중에 도착합니다. 이전 버전에서는 SDK가 다음 동기화 시 카드를 가져오며, 사용자의 자격이 기록되기 전에 실행된 동기화는 아무것도 반환하지 않습니다.

첫 번째 세션 중인 신규 사용자의 경우 이 처리 지연은 피할 수 없습니다. 즉시 사용할 수 있어야 하는 기존 사용자의 경우 예약 전송을 대신 사용하는 것이 좋습니다.

신규 사용자와 기존 사용자 모두의 지연을 최소화해야 하는 경우, 두 개의 Campaign을 만들 수 있습니다:

• 세션 수가 0보다 큰 기존 사용자: 예약 전송 Campaign을 사용합니다. 카드가 미리 생성되어 즉시 사용할 수 있습니다.
• 세션 수가 0인 신규 사용자: 실행 기반 트리거 Campaign을 사용합니다. 카드는 첫 번째 세션 트리거 후에 생성됩니다.

이 방법을 사용하면 기존 사용자는 카드를 즉시 확인할 수 있고, 신규 사용자에게는 첫 번째 세션에서 짧은 지연 후에 도달할 수 있습니다. 지연 시간을 개선하는 추가 전략은 Content Cards의 짧은 지연 시간 요구 사항 개선을 참조하세요.

노출 또는 해제 타임스탬프가 Campaign 일정을 벗어나는 이유는 무엇인가요?

분석 및 Currents의 노출 및 해제 타임스탬프는 Braze가 카드를 생성하거나 전송한 시점이 아니라, 사용자가 콘텐츠 카드를 조회하거나 해제한 시점을 나타냅니다. 카드는 Content Cards가 새로 고쳐질 때까지 사용자의 피드에 남아 있을 수 있으므로, 노출 및 해제 타임스탬프가 Campaign의 전송 기간 이후일 수 있습니다.

그래도 시간이 예상과 다르게 보이는 경우:

• 분석을 회사 시간대로 보고 있는지, Currents에서 사용자의 시간대로 보고 있는지 확인하세요.
• 전송 시간만 비교하지 말고, 사용자가 카드를 받은 후 실제로 카드를 조회하거나 해제했는지 확인하세요.

콘텐츠 카드 측정기준에 대한 자세한 내용은 콘텐츠 카드 보고를 참조하세요.

“All expiration values for a campaign must match” 오류

이 오류는 다중 배리언트 콘텐츠 카드 Campaign에서 배리언트마다 다른 만료 설정을 사용할 때 표시됩니다. 모든 배리언트에 동일한 만료(기간 또는 특정 시간)를 설정하거나 Campaign을 단일 배리언트로 줄인 다음 다시 저장하세요. Campaign을 구성할 때 만료를 설정하는 방법은 전달 일정 또는 트리거 선택을 참조하세요.