키-값 쌍 이해하기
예상 2분 읽기
|
업데이트 2025년 7월 7일 AM 12:00 EST
학습 내용
키-값 쌍이 무엇인지와 표준 푸시 알림과 무음 푸시 알림 모두에서 이를 사용하는 방법을 알아보세요. 키-값 쌍은 푸시 알림과 함께 포함되는 사용자 지정 데이터로, 앱 동작을 트리거하고, 메시지에 태그를 지정하고, 알림을 맞춤 설정하는 등 다양한 작업을 할 수 있어요.
키-값 쌍이란 무엇인가요?
키-값 쌍은 사용자에게 표시되는 표준 푸시 알림과 사용자에게 표시되지 않는 무음 푸시 알림 모두에 포함할 수 있는 사용자 지정 데이터예요.
무음 알림과 표준 알림 모두 앱 콘텐츠를 업데이트하거나, 백그라운드 작업을 트리거하거나, 보고 목적으로 메시지에 태그를 지정하는 데 사용할 수 있어요.
표준 푸시를 사용하면, 맞춤 푸시 템플릿을 만들고 채우는 데도 사용할 수 있어요.
키-값 쌍 사용 방법
키-값 쌍을 사용하려면 앱이 키를 인식하고 해당 값에 반응하도록 설정되어 있어야 하므로, 앱 개발자와 협업하여 앱이 사용 사례를 지원하도록 빌드되어 있는지 확인해 주세요. 또한 Klaviyo 계정에서 푸시 알림을 설정 했는지 확인해 주세요.
푸시 알림을 만들 때 Behaviors 탭에서 찾을 수 있어요. 사용하려면 Custom data를 켠 다음 키와 값을 추가해 주세요. 푸시 알림당 키-값 쌍을 최대 10개까지 추가할 수 있어요.
전자상거래 앱의 예를 살펴볼게요:
- 온라인 구매를 완료한 후 앱에 표시되는 고객의 리워드 포인트를 업데이트하려고 해요. 리워드 포인트 프로필 속성을 키-값 쌍으로 포함해 무음 푸시를 전송해서 이를 수행할게요.
- Placed Order 이벤트로 트리거되는 감사 플로우가 이미 있어요. 이 플로우 끝에 무음 푸시를 추가해 앱에 표시되는 리워드 포인트 값을 업데이트해요.
- 무음 푸시에는 Key 가 rewardspoints 이고 Value가 {{ person.rewardspoints }}로 설정된 키-값 쌍이 포함돼요. 이 포인트를 저장하는 Klaviyo 프로필 속성의 이름은 rewardspoints이며, 앱은 이 키-값 쌍을 기준으로 업데이트되도록 올바르게 구성되어 있어요.
- 이 예시에서는 rewardspoints 값이 이 플로우를 통해 앱으로 전송되기 전에 Klaviyo에서 업데이트되었는지 확인해, 정확하게 반영되도록 했어요.
사용 사례
키-값 쌍에는 다음과 같은 다양한 사용 사례가 있어요:
- 앱 콘텐츠 개인화
수신자의 속성(위의 리워드 포인트 예시 등)을 기반으로 앱 콘텐츠를 개인화하기 위해 무음 푸시 알림을 보낼 수 있어요. - 보고를 위한 태그 만들기
푸시 알림(표준 또는 무음)에 키-값 쌍을 포함해 메시지에 “태그”를 지정한 다음, 특정 태그가 있는 모든 메시지의 데이터를 가져와 집계할 수 있어요. 예를 들어, 이러한 태그는 UTM 매개 변수일 수 있어요. - 맞춤 푸시 템플릿 만들기
푸시 알림 본문의 글꼴 크기와 색상을 지정하거나, 푸시 알림이 전달될 때 재생될 맞춤 사운드를 설정할 수 있어요. 계정은 알림에 배송 위치나 혜택 만료까지 남은 시간 카운트다운과 같은 실시간 데이터를 표시할 수도 있어요.
특정 사용 사례를 지원하도록 앱 개발자와 협업하는 것을 권장해요.
이 도움말 문서가 유용했나요?
이 형식은 도움말 문서 피드백 용도로만 사용하세요. 지원 팀에 문의하는 방법.