콘텐츠 카드 만들기

이 문서에서는 캠페인과 캔버스를 구축할 때 Braze에서 콘텐츠 카드를 만드는 방법에 대해 설명합니다. 여기에서는 메시징 유형을 선택하고, 카드를 작성하고, 메시지 전달 일정을 예약하는 방법을 안내해 드립니다.

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

하나의 간단한 메시징 캠페인(예: 하나의 메시지로 사용자에게 제품에 대해 알리는 경우)에 캠페인을 사용합니다. 캔버스를 사용하여 다단계 사용자 여정(예: 시간 경과에 따른 사용자 행동에 기반한 맞춤형 제품 제안 전송)을 진행할 수 있습니다.

• campaign
• canvas

2단계: 메시지 유형 지정

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

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

메시지 유형	예시	설명
클래식		클래식 카드는 굵은 제목, 메시지 텍스트, 제목과 텍스트 왼쪽에 있는 이미지(선택 사항)가 있는 간단한 레이아웃입니다. 클래식 카드에는 정사각형 이미지나 아이콘을 사용하는 것이 가장 좋습니다.
자막이 있는 이미지		자막 콘텐츠 카드는 카피와 시선을 사로잡는 이미지로 콘텐츠를 보여줍니다.
이미지만		이미지 전용 카드는 이미지, GIF 및 기타 창의적인 비텍스트 콘텐츠를 위한 공간으로 시선을 사로잡습니다.

3단계: 콘텐츠 카드 작성

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

여기에 표시되는 내용은 이전 단계에서 선택한 카드 유형에 따라 다르지만 다음 옵션 중 하나를 포함할 수 있습니다:

Language

언어 추가를 선택하여 제공된 목록에서 원하는 언어를 추가합니다. 이렇게 하면 Liquid가 메시지에 삽입됩니다. 콘텐츠를 작성하기 전에 언어를 선택하여 Liquid에서 원하는 위치에 텍스트를 채울 수 있도록 하는 것이 좋습니다. For our full list of available languages you can use, refer to Languages supported.

Creating right-to-left messages

The final appearance of right-to-left messages depends largely on how service providers render them. For best practices on crafting right-to-left messages that display as accurately as possible, refer to Creating right-to-left messages.

제목 및 메시지

원하는 것은 무엇이든 작성하세요. 제한은 없지만 메시지를 더 빨리 전달하고 고객의 클릭을 유도할수록 좋습니다! 명확하고 간결한 제목과 메시지 내용을 권장합니다. 이러한 필드는 이미지 전용 카드에는 제공되지 않습니다.

이미지

이미지 추가를 선택하거나 이미지 URL을 입력하여 콘텐츠 카드에 이미지를 추가합니다. 이미지 추가를 선택하면 이전에 업로드한 이미지를 선택하거나 새 이미지를 추가할 수 있는 미디어 라이브러리가 열립니다. 메시지 유형과 플랫폼마다 권장 비율과 요구 사항이 다를 수 있으므로 이미지를 커미셔닝하거나 처음부터 만들기 전에 반드시 확인해야 합니다! 콘텐츠 카드 메시지 필드의 총 크기는 2KB로 제한된다는 점에 유의하세요.

맨 위에 고정

Braze는 사용자 피드 상단에 고정 카드를 표시하며 사용자는 이를 해제할 수 없습니다. 사용자의 피드에 고정 카드가 여러 개 있는 경우 Braze는 시간순으로 카드를 정렬합니다. 카드를 보낸 후에는 고정 옵션을 소급하여 업데이트할 수 없습니다. 캠페인을 보낸 후에 이 옵션을 변경하면 향후 전송에만 영향을 미칩니다.

클릭 시 동작

고객이 카드에 표시된 링크를 클릭하면 앱으로 더 깊이 들어가거나 다른 사이트로 연결될 수 있습니다. 콘텐츠 카드에 클릭 시 동작을 선택한 경우 링크 텍스트도 그에 맞게 업데이트해야 합니다.

The following actions are available for Content Card links:

Action	설명
웹 URL로 리디렉션	네이티브가 아닌 웹 페이지를 엽니다.
앱으로 딥링크	앱의 기존 화면으로 딥링크를 연결합니다.
사용자 지정 이벤트 로그	Choose a custom event to trigger. 다른 콘텐츠 카드를 표시하거나 추가 메시지를 트리거하는 데 사용할 수 있습니다.
사용자 지정 속성 로그	Choose a custom attribute to set for the current user.

The Log Custom Event and Log Custom Attribute options require the following SDK version compatibility:

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

You can use key-value pairs to create categories for your Cards, create multiple Content Card feeds, and customize how cards are sorted.

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

5단계: 나머지 캠페인 또는 캔버스 구축하기

• campaign
• canvas

6단계: 검토 및 배포

캠페인 또는 캔버스의 마지막 구축을 완료한 후에는 세부 사항을 검토하고 테스트한 다음 준비가 되면 전송하세요.

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

알아두어야 할 사항

페이로드 및 피드 제한

콘텐츠 카드에는 성능/성과를 지원하기 위해 각 카드의 페이로드 크기 제한과 피드에 표시할 수 있는 최대 카드 수라는 두 가지 주요 제약 조건이 있습니다.

콘텐츠 카드의 크기 제한

Liquid 개인화가 렌더링된 후 단일 콘텐츠 카드의 전체 데이터 페이로드는 2KB를 초과할 수 없습니다. This includes:

• 제목
• 메시지
• 이미지 URL(이미지 파일 크기가 아닌 URL 문자열 자체의 길이)
• 링크 텍스트
• 지정된 모든 플랫폼에 대한 링크 URL(iOS, Android 및 웹용 별도 URL은 모두 합산에 포함)
• 키-값 페어(키 이름과 값 모두)

Liquid를 사용하여 긴 문자열을 가져오는 경우(예: 커스텀 속성에서) 한도를 초과할 수 있습니다.

정적 콘텐츠가 한도를 초과하면 캠페인 작성기에 경고가 표시됩니다. (Liquid를 사용하는 동적 콘텐츠의 크기는 예측할 수 없습니다.) 메시지 크기가 2KB를 초과하면 전송 시 중단됩니다. 이러한 중단은 메시지 활동 로그에서 Content card maximum size exceeded 라는 이유와 함께 확인할 수 있습니다.

다음은 콘텐츠 카드 페이로드 크기를 관리하기 위한 몇 가지 모범 사례입니다:

• 긴 링크에는 URL 단축기를 사용합니다. 특히 광범위한 추적 매개변수가 있는 URL은 크기 제한 문제가 발생할 수 있습니다. URL 단축 서비스를 사용하면 글자 수를 획기적으로 줄이고 페이로드 공간을 확보할 수 있습니다.
• Liquid로 동적 콘텐츠 잘라내기. 사용자 속성 또는 API 호출에서 동적 텍스트로 카드를 개인화할 때 콘텐츠의 길이를 예측할 수 없습니다. truncate 같은 Liquid 필터를 적극적으로 사용하여 동적 텍스트의 길이를 제한하세요.
• 멀티플랫폼 URL을 효율적으로 활용하세요. 2KB 제한에는 정의한 모든 플랫폼의 URL이 포함됩니다. 각 플랫폼마다 길고 고유한 URL을 사용하면 페이로드의 크기가 커질 수 있습니다. 가능하면 모든 플랫폼에서 작동하는 단일 링크를 사용하거나 필요에 따라 URL 단축기를 사용하세요.
• 더 풍부한 콘텐츠를 위해 배너를 고려하세요. 지속적으로 많은 양의 콘텐츠가 필요한 사용 사례의 경우 콘텐츠 카드가 적합한 채널이 아닐 수 있습니다. 배너에는 동일한 2KB 페이로드 제한이 없으며 앱 또는 웹사이트 경험에 직접 더 풍부한 콘텐츠를 삽입하는 데 더 적합합니다.

Number of cards in feed

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

카드 한도 문제를 방지하려면 다음과 같은 모범 사례를 따르는 것이 좋습니다:

• 더 짧은 만료일을 사용하세요: 주말 세일과 같이 시간에 민감한 캠페인의 경우 특정 만료일을 설정하세요. 이렇게 하면 카드가 피드에서 자동으로 제거되고 더 이상 관련성이 없어진 후에는 한도에 포함되지 않습니다.
• 액션 기반 제거를 활용하세요: 트랜잭션 또는 목표 기반 카드에 대한 제거 이벤트를 설정합니다. 예를 들어, 사용자에게 프로필을 작성하라는 메시지를 표시하는 카드는 profile_completed 이벤트가 기록되는 즉시 제거해야 합니다.
• 장기 실행 캠페인을 감사합니다: 반복되거나 진행 중인 캠페인을 검토하여 시간이 지남에 따라 피드를 너무 많은 카드로 채워 사용자에게 좋지 않은 경험을 제공하고 있지는 않은지 확인하세요.

콘텐츠 카드 재적격성 이해

재적격 여부는 사용자가 동일한 캠페인에서 메시지를 두 번 이상 받을 수 있는지 여부와 시기를 결정합니다. 콘텐츠 카드의 경우, 반복되는 캠페인을 관리하고 사용자에게 중복되거나 오래된 메시지가 수신되지 않도록 하려면 이 작동 방식을 이해하는 것이 중요합니다.

재적격성 계산 방법

재참가 자격을 켜면 사용자가 메시지를 받은 후 캠페인에 ‘재참가’할 수 있는 시점에 대한 카운트다운이 시작됩니다. 카운트다운이 시작되는 구체적인 시점은 카드 생성 설정에 따라 다릅니다:

• 첫 노출을 사용하는 콘텐츠 카드는 노출 횟수를 사용하여 재적격성을 계산합니다.
• 캠페인 시작 또는 캔버스 단계 입력 시 생성된 콘텐츠 카드는 전송 시간 또는 노출 횟수 중 가장 최근의 시간을 사용합니다.

30일 만료 및 재자격 기간

흔히 혼동을 일으키는 원인은 캠페인 재자격과 모든 콘텐츠 카드의 30일 자동 만료 사이의 상호 작용입니다.

모든 콘텐츠 카드는 전송 또는 삭제된 후 30일이 지나면 Braze의 시스템에서 자동으로 삭제됩니다. 재자격이 해제된 장기 반복 캠페인이 있는 경우, 사용자는 30일이 지난 후에도 동일한 카드를 다시 받을 수 있습니다. 원래 카드가 삭제되면 시스템에서 해당 사용자가 캠페인을 받았다는 기록이 더 이상 표시되지 않으므로 다음 세션에서 다시 자격을 얻을 수 있습니다.

사용자가 특정 캠페인의 메시지를 한 번만 받도록 하려면 이 캠페인에서 메시지를 받지 않은 사용자를 위해 캠페인 또는 캔버스 단계에 오디언스 필터를 추가하세요. 이 필터는 장기간 운영되는 캠페인에서 중복 전송을 방지하는 가장 신뢰할 수 있는 방법입니다.

라이브 콘텐츠 카드 관리하기

콘텐츠 카드가 전송된 후에는 사용자에게 전달될 준비가 된 ‘받은편지함’에서 대기합니다(이메일의 경우와 유사). After content is pulled into the Content Card (at the time of display), it cannot be changed during its lifespan. 이는 연결된 콘텐츠를 통해 API를 호출하는 경우 엔드포인트의 데이터가 변경되는 경우에도 적용됩니다. 이 데이터는 업데이트되지 않습니다. 새 사용자에게만 전송을 중지하고 사용자의 피드에서 삭제할 수 있습니다. 캠페인을 수정하면 향후 전송되는 카드에만 업데이트가 적용됩니다.

출시된 카드 업데이트

이미 카드를 받은 사용자의 카드를 변경하려면 다음 방법 중 하나를 사용해야 합니다:

Option 1: 캠페인 복제(즉각적인 변경에 권장)

첫 번째 방법은 캠페인을 아카이브하고 복제된 새 캠페인을 시작하는 것입니다:

1. 원래 캠페인을 중지하고 메시지가 표시되면 Remove card after the next sync 을 선택합니다.
2. 캠페인을 복제하고 편집한 다음 새 버전을 실행합니다.

캠페인을 복제할 때는 새 버전의 오디언스를 정의해야 합니다. 세분화 필터를 사용하여 업데이트된 카드를 받는 사람을 제어할 수 있습니다:

• 사용자가 콘텐츠 카드를 다시 받을 자격이 없는 경우 Received Message from Campaign 필터를 Has Not 조건으로 설정하여 이전 버전의 콘텐츠 카드를 받지 않은 사용자를 필터링할 수 있습니다.
• 이전 카드를 받은 사용자가 X일 이내에 다시 자격을 얻어야 하는 경우 Last Received Message from specific campaign 필터를 X일 이상으로 설정하거나 Received Message from Campaign 조건으로 Has Not 필터를 설정할 수 있습니다.

효과

• 기존 수신자: 신규 및 기존 수신자가 자격을 갖춘 경우 다음 피드 새로 고침 시 업데이트된 카드를 볼 수 있습니다.
• 보고: 카드의 각 버전에는 별도의 분석 기능이 있습니다.

Let’s say you’ve set a campaign to be triggered by a session start, and it has re-eligibility set to 30 days. 사용자가 이틀 전에 캠페인을 받았는데 사본을 변경하려고 합니다. First, you’d archive the campaign and remove the cards from the feed. 둘째, 캠페인을 복제하고 새 카피로 다시 시작합니다. 사용자에게 다른 세션이 있는 경우 즉시 새 카드를 받게 됩니다.

옵션 2: 동일한 캠페인을 중지했다가 다시 시작하기

이 접근 방식은 모든 분석을 단일 캠페인으로 통합합니다. 신규 자격을 갖춘 사용자는 새 카드를 받게 되지만, 기존 수신자의 경우 자격을 다시 얻을 때까지 업데이트가 지연됩니다:

1. 캠페인을 중지하고 메시지가 표시되면 다음 동기화 후 카드 제거를 선택합니다.
2. 필요에 따라 캠페인을 수정합니다.
3. 캠페인을 다시 시작합니다.

효과

• 기존 수신자: 이미 카드를 받은 사용자는 다시 자격을 갖추기 전까지는 업데이트된 카드를 받을 수 없습니다. 재적격성이 해제되면 새 카드를 받을 수 없습니다.
• 보고: 하나의 캠페인에는 출시된 카드 버전에 대한 모든 보고 분석이 포함됩니다. Braze는 출시된 버전을 구분하지 않습니다.

세션 시작에 의해 트리거되고 재자격이 30일로 설정된 캠페인이 있다고 가정해 보겠습니다. 사용자가 이틀 전에 캠페인을 받았는데 사본을 변경하려고 합니다. 먼저 캠페인을 중지하고 피드에서 카드를 제거합니다. 둘째, 새 카피로 캠페인을 다시 게시합니다. 다른 세션이 있는 사용자의 경우 28일 후에 새 카드를 받게 됩니다.

카드 제거 및 만료

수동 카드 제거

캠페인을 중지하여 언제든지 모든 사용자의 피드에 대한 카드를 수동으로 제거할 수 있습니다.

1. 콘텐츠 카드 캠페인을 열고 캠페인 중지를 선택합니다.
2. 메시지가 표시되면 다음 동기화 후 카드 제거를 선택합니다. 다음 피드 새로고침 시 카드가 제거됩니다.

카드 제거 자동화

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

캠페인 또는 캔버스 단계에서 제거 이벤트를 지정합니다. 사용자가 해당 이벤트를 수행하면 Braze가 이벤트를 처리한 후 새로고침할 때 해당 카드가 피드에서 제거됩니다.

카드 만료

콘텐츠 카드는 전송된 날로부터 최대 30일 동안 사용할 수 있으며, 30일이 지나면 사용자 피드에서 삭제되고 Braze의 시스템에서 삭제됩니다.

카드를 30일 이상 오래 보관하기

카드를 항상 사용할 수 있는 것처럼 보이게 하려면(i.e., 최대 30일보다 오래 지속됨) 30일마다 카드를 효과적으로 교체하는 반복 캠페인을 만들 수 있습니다:

1. 콘텐츠 카드의 기간을 30일로 설정합니다.
2. 캠페인 재적격성을 30일로 설정합니다.
3. “세션 시작” 시 캠페인이 트리거되도록 설정합니다.