Skip to content

Content Cards의 동작 커스터마이즈

이 구현 가이드에서는 Content Cards의 동작 변경, 페이로드에 키-값 페어와 같은 추가 항목 추가, 일반적인 커스터마이즈 레시피에 대해 설명합니다. 콘텐츠 카드 유형의 전체 목록은 Content Cards 정보를 참조하세요.

키-값 페어

Braze를 사용하면 키-값 페어를 사용하여 Content Cards를 통해 사용자 기기에 추가 데이터 페이로드를 전송할 수 있습니다. 이를 통해 내부 측정기준을 추적하고, 앱 콘텐츠를 업데이트하고, 등록정보를 커스터마이즈할 수 있습니다. 대시보드를 사용하여 키-값 페어를 추가합니다.

키-값 페어는 card 오브젝트에 extras로 저장됩니다. 애플리케이션에서 추가 처리를 위해 카드와 함께 데이터를 전송하는 데 사용할 수 있습니다. card.extras를 호출하여 이러한 값에 액세스합니다.

키-값 페어는 card 오브젝트에 extras로 저장됩니다. 애플리케이션에서 추가 처리를 위해 카드와 함께 데이터를 전송하는 데 사용할 수 있습니다. card.extras 를 호출하여 이러한 값에 액세스합니다.

키-값 페어는 card 오브젝트에 extras로 저장됩니다. 애플리케이션에서 추가 처리를 위해 카드와 함께 데이터를 전송하는 데 사용할 수 있습니다. card.extras 를 호출하여 이러한 값에 액세스합니다.

보조 콘텐츠로서의 Content Cards

Content Cards를 기존 피드에 원활하게 혼합하여 여러 피드의 데이터를 동시에 로드할 수 있습니다. 이를 통해 Braze Content Cards와 기존 피드 콘텐츠가 일관되고 조화로운 경험을 만들어 냅니다.

오른쪽 예시는 로컬 데이터와 Braze에서 제공하는 Content Cards로 채워지는 하이브리드 항목 목록이 포함된 피드를 보여줍니다. 이를 통해 Content Cards를 기존 콘텐츠와 구분할 수 없게 만들 수 있습니다.

API 트리거 키-값 페어

API 트리거 Campaign은 카드의 값이 외부 요인에 따라 사용자에게 표시할 콘텐츠를 결정할 때 사용할 수 있는 좋은 전략입니다. 예를 들어 보조 콘텐츠를 표시하려면 Liquid를 사용하여 키-값 페어를 설정합니다. 설정 시 class_type을 알아야 합니다.

보조 Content Cards 사용 사례에 대한 키-값 페어입니다. 이 예시에서는 카드의 다양한 측면인 "tile_id", "tile_deeplink", "tile_title"이 Liquid를 사용하여 설정됩니다.

대화형 콘텐츠로서의 Content Cards

화면 왼쪽 하단에 50% 프로모션을 표시하는 대화형 Content Card가 나타납니다. 클릭하면 프로모션이 장바구니에 적용됩니다.

Content Cards를 활용하여 사용자를 위한 역동적이고 인터랙티브한 경험을 만들 수 있습니다. 오른쪽 예시에서는 결제 시 Content Card 팝업이 표시되어 사용자에게 막바지 프로모션을 제공합니다. 이와 같은 카드를 잘 배치하면 특정 사용자 동작을 향한 ‘넛지’를 제공할 수 있습니다.

이 사용 사례의 키-값 페어에는 원하는 할인 금액으로 설정된 discount_percentagecoupon_code로 설정된 class_type이 포함됩니다. 이러한 키-값 페어를 사용하여 결제 화면에서 유형별 Content Cards를 필터링하고 표시할 수 있습니다. 키-값 페어를 사용하여 여러 피드를 관리하는 방법에 대한 자세한 내용은 기본 Content Card 피드 커스터마이즈를 참조하세요.

Content Card 배지

숫자 7이 표시된 빨간색 배지와 함께 Swifty라는 이름의 Braze 샘플 앱이 표시된 iPhone 홈 화면

배지는 사용자의 관심을 끌기에 적합한 작은 아이콘입니다. 배지를 사용하여 새로운 Content Card 콘텐츠를 사용자에게 알리면 사용자를 앱으로 다시 유도하고 세션을 늘릴 수 있습니다.

미열람 Content Card 수를 배지로 표시

미열람 Content Card 수를 앱 아이콘에 배지로 표시할 수 있습니다.

언제든지 다음을 호출하여 미열람 카드 수를 요청할 수 있습니다:

1
braze.getCachedContentCards().getUnviewedCardCount();

그런 다음 이 정보를 사용하여 미열람 Content Cards 수를 나타내는 배지를 표시할 수 있습니다. 자세한 내용은 SDK 참조 문서 를 참조하세요.

언제든지 다음을 호출하여 미열람 카드 수를 요청할 수 있습니다:

1
Braze.getInstance(context).getContentCardUnviewedCount();
1
Braze.getInstance(context).contentCardUnviewedCount

그런 다음 이 정보를 사용하여 미열람 Content Cards 수를 나타내는 배지를 표시할 수 있습니다. 자세한 내용은 SDK 참조 문서 를 참조하세요.

다음 샘플은 braze.contentCards를 사용하여 미열람 Content Card 수를 요청하고 표시합니다. 앱이 닫히고 사용자 세션이 종료된 후 이 코드는 카드 수를 요청하여 viewed 등록정보를 기준으로 카드 수를 필터링합니다.

1
func applicationDidEnterBackground(_ application: UIApplication)

이 메서드 내에서 주어진 세션 동안 사용자가 카드를 볼 때 배지 수를 적극적으로 업데이트하는 다음 코드를 구현합니다:

1
2
let unreadCards = AppDelegate.braze?.contentCards.cards.filter { $0.viewed == false }
UIApplication.shared.applicationIconBadgeNumber = unreadCards?.count ?? 0
1
(void)applicationDidEnterBackground:(UIApplication *)application

이 메서드 내에서 주어진 세션 동안 사용자가 카드를 볼 때 배지 수를 적극적으로 업데이트하는 다음 코드를 구현합니다:

1
2
3
4
5
6
7
NSInteger unreadCardCount = 0;
for (BRZContentCardRaw *card in AppDelegate.braze.contentCards.cards) {
  if (card.viewed == NO) {
    unreadCardCount += 1;
  }
}
[UIApplication sharedApplication].applicationIconBadgeNumber = unreadCardCount;
New Stuff!