카드 생성
카드 생성 시기를 지정하여 Braze가 새 Content Cards Campaign 및 캔버스 단계에 대한 오디언스 자격 및 개인화를 평가하는 시기를 선택할 수 있습니다.
사전 요구 사항
이 기능을 활용하려면 다음 최소 SDK 버전으로 업그레이드해야 합니다:
iOS에서는 SWIFT SDK가 버전 5.2.0부터 이 기능을 지원하며, 레거시 OBJECTIVE-C SDK는 버전 4.5.0부터 지원합니다. SWIFT SDK 버전 5.0.0~5.1.x는 이 기능을 지원하지 않습니다.
SDK를 업그레이드한 후 모바일 사용자가 앱을 업그레이드해야 합니다. Campaign 또는 Canvas 오디언스를 필터링하여 해당 최소 앱 버전의 사용자만 타겟팅할 수 있습니다.
개요
예약 전송으로 새 콘텐츠 카드 Campaign을 만들 때 전송 단계에서 Braze가 카드를 생성하는 시기를 선택할 수 있습니다.

다음 옵션을 사용할 수 있습니다:
- Campaign 실행 시: Content Cards의 이전 기본 동작입니다. Braze는 Campaign이 실행될 때 오디언스 자격과 개인화를 계산한 다음, 카드를 생성하고 사용자가 앱을 열 때까지 저장합니다.
- 첫 노출 시(권장): 사용자가 다음에 앱을 열면(새 세션을 시작하면) Braze는 사용자가 어떤 Content Cards에 대해 자격이 있는지 결정하고, Liquid 또는 연결된 콘텐츠와 같은 개인화를 템플릿으로 처리한 다음 카드를 생성합니다. 이 옵션은 일반적으로 더 나은 성능을 제공합니다.
선택한 옵션에 관계없이, 콘텐츠 카드 만료일 카운트다운은 Campaign이 실행될 때 시작됩니다.
콘텐츠 카드 메시지 단계의 메시징 채널 탭에서 Braze가 카드를 생성하는 시기를 선택할 수 있습니다.

다음 옵션을 사용할 수 있습니다:
- 단계 진입 시: Content Cards의 이전 기본 동작입니다. Braze는 사용자가 캔버스 단계에 진입할 때 오디언스 자격을 계산한 다음, 카드를 생성하고 사용자가 앱을 열 때까지 저장합니다.
- 첫 노출 시(권장): Braze는 사용자가 캔버스 단계에 진입할 때 오디언스 자격을 계산합니다. 사용자가 다음에 앱을 열면(새 세션을 시작하면) Braze는 Liquid 또는 연결된 콘텐츠와 같은 개인화를 템플릿으로 처리한 다음 카드를 생성합니다. 이 옵션은 카드 전송에서 더 나은 성능과 더 최신의 개인화를 제공합니다.
선택한 옵션에 관계없이, 콘텐츠 카드 만료일 카운트다운은 사용자가 캔버스 단계에 진입할 때 시작됩니다.

익명 사용자가 첫 세션에서 콘텐츠 카드를 볼 수 있도록 하려면 Canvas 대신 Campaign을 사용하세요. 익명 사용자가 Canvas에 진입하면 이미 세션이 시작된 상태이므로, 새 세션을 시작할 때까지 콘텐츠 카드를 받지 못합니다.
제거 이벤트
사용자가 구매를 완료하거나 커스텀 이벤트를 수행할 때 Content Cards를 제거하는 옵션을 선택합니다. 커스텀 이벤트 수행을 제거 이벤트로 사용하려면, 속성정보 필터를 사용할 때 비교를 위한 컨텍스트 변수 또는 커스텀 속성을 선택합니다.

만료
만료(피드 내 시간) 설정에서 기간 개인화를 선택하여 컨텍스트 변수를 사용해 콘텐츠 카드의 만료를 설정할 수 있습니다.


Content Cards의 최대 만료 기간은 컨텍스트 변수를 사용한 개인화 기간을 사용하더라도 30일입니다. 30일을 초과하는 값은 30일로 제한됩니다. 자세한 내용은 카드 만료를 참조하세요.

두 옵션 모두 카드가 생성된 후에는 Braze가 오디언스 자격이나 개인화를 다시 계산하지 않습니다.
실행 또는 진입 시 카드 생성과 첫 노출 시 카드 생성의 차이점
이 섹션에서는 Campaign 실행 또는 단계 진입 시 카드 생성과 첫 노출 시 카드 생성의 주요 차이점을 설명합니다.
| Campaign 실행 시 / 캔버스 단계 진입 시 | 첫 노출 시 | |
|---|---|---|
| 사용 시기 | 특정 시점(실행 시점)의 콘텐츠 스냅샷이 필요한 경우. |
|
| 오디언스 | Braze는 Campaign이 전송될 때 오디언스 멤버십을 평가합니다. 신규 또는 익명 사용자가 Campaign 전송 후 카드를 보려고 하면 자격 평가 대상에 포함되지 않습니다. 반복 Campaign의 경우 다음 반복 주기에 평가됩니다. |
Braze는 사용자가 다음에 앱을 열 때(세션 시작, Campaign에만 해당*) 멤버십을 평가합니다. 이 설정은 신규 또는 익명 사용자가 카드를 보려고 할 때 항상 자격 평가 대상에 포함되므로 더 넓은 오디언스 도달 범위를 제공합니다. 또한 첫 노출 시로 설정된 경우에는 사용량 제한(카드를 받는 사람 수 제한)이 적용되지 않습니다. |
| 개인화 | Braze는 Campaign이 실행되거나 사용자가 캔버스 단계에 진입할 때 Liquid, 연결된 콘텐츠, Content Blocks를 평가합니다. 반복 Campaign의 경우 다음 반복 주기에 평가됩니다. | Braze는 첫 노출 시 또는 다음 반복 주기 후에 Liquid, 연결된 콘텐츠, Content Blocks를 평가합니다. |
| 분석 | 전송된 메시지는 Braze가 생성하여 사용 가능하게 만든 카드 수를 나타냅니다. 사용자가 카드를 확인했는지 여부는 포함되지 않습니다. | 전송된 메시지는 세션 시작 후 Braze가 사용자에게 전송한 카드 수를 나타냅니다. Canvas에서 사용자가 세션을 시작하지 않고 단계에 진입하면 Braze는 카드를 전송하지 않으므로, 이 지표가 단계에 진입한 사용자 수와 일치하지 않을 수 있습니다. 도달 가능한 사용자와 노출 횟수는 변하지 않지만, 첫 노출 시 카드를 생성하면 Campaign 실행 또는 캔버스 단계 진입에 비해 전송량(전송된 메시지)이 줄어들 것으로 예상됩니다. |
| 처리 시간 | Braze는 실행 시 Segment 내 모든 자격 있는 사용자에 대해 카드를 생성합니다. 대규모 오디언스의 경우, 실행 후 카드가 더 빨리 제공되도록 첫 노출 시를 선택하세요. | Braze는 사용자가 처음 카드를 보려고 할 때 카드를 생성하므로, 첫 노출 시 표시되는 데 1~2초 정도 걸릴 수 있습니다. |
* 이 시나리오는 Campaign에만 적용됩니다. Canvas 오디언스는 단계 수준이 아닌 Canvas 진입 시 평가되기 때문입니다.
고려 사항
멀티채널 캠페인
멀티채널 캠페인은 첫 노출 시 카드를 지원하지 않으므로, 모든 Content Cards는 캠페인 시작 시 전송됩니다.
Canvas 컨텍스트 속성정보 사용
Content Cards를 Canvas 컨텍스트 속성정보로 개인화할 때는 ${...} 구문을 사용합니다(예: {{context.${property_name}}}). 이 구문 없이 점 표기법을 사용하면(예: {{context.property_name}}) 푸시나 이메일 등 다른 채널에서는 정상적으로 작동하더라도 Content Cards에서는 올바르게 처리되지 않을 수 있습니다.
출시 후 카드 생성 방식 변경
Braze는 캠페인 출시 후 카드 생성 방식을 변경하지 않는 것을 권장합니다. 두 가지 카드 생성 유형 간에 발송된 메시지 수 계산 방식이 다르기 때문에, 캠페인 출시 후 카드 생성 방식을 변경하면 발송량의 정확도에 영향을 줄 수 있습니다.
잠재적인 처리 시간
대규모 오디언스의 경우, 출시 후 카드를 빠르게 제공할 수 있도록 첫 노출 시 카드 생성 옵션을 선택하세요. 세션 시작 시 트리거되는 캠페인도 성능 향상을 위해 첫 노출 시 카드 생성 방식(예약 전달을 통해 이용 가능)으로 전환하면 도움이 될 수 있습니다.
첫 노출 시 카드를 생성하는 경우, 카드가 처리되는 데 몇 초 정도 걸릴 수 있습니다. 이 처리 시간은 카드 크기와 메시지 템플릿 옵션의 복잡도 등 다양한 요인에 따라 달라집니다. 예를 들어, 연결된 콘텐츠를 사용하는 카드의 처리 시간은 최소한 연결된 콘텐츠의 응답 시간만큼 소요됩니다.
이전 SDK 버전
사용자의 앱이 이전 SDK 버전을 실행하고 있더라도 전송된 Content Cards를 수신할 수 있습니다. 다만, 카드가 표시되기까지 더 오래 걸릴 수 있으며, 다음 Content Cards 동기화 시점까지 표시되지 않을 수 있습니다.