Skip to content

키-값 쌍

Braze는 키-값 쌍을 통해 사용자 장치에 추가 데이터 페이로드를 보낼 수 있게 합니다. 이 기능은 푸시, 인앱, 이메일 및 콘텐츠 카드 메시징 채널에서 사용할 수 있습니다.

추가 데이터 페이로드는 내부 측정기준 및 앱 콘텐츠를 업데이트하고 푸시 알림 속성(예: 알림 우선순위 지정, 현지화 및 소리)을 사용자 지정하는 데 도움이 될 수 있습니다.

푸시 알림

키-값 쌍은 Android, iOS 및 웹 푸시 알림에도 추가할 수 있습니다. 메시지 작성기에서 설정 탭을 선택하고, 새 쌍 추가를 클릭한 다음, 키-값 쌍을 지정합니다.

iOS

Apple 푸시 알림 서비스 (APNs)는 알림 환경 설정을 설정하고 키-값 쌍을 사용하여 커스텀 데이터를 보내는 것을 지원합니다. APNs는 알림 속성을 제어하는 미리 결정된 키와 값을 포함하는 Apple 예약 aps 라이브러리를 사용합니다.

APS 라이브러리
키 값 유형 값 설명
경고 문자열 또는 사전 객체 문자열 입력의 경우, 문자열을 메시지로 하여 닫기 및 보기 버튼이 있는 경고를 표시합니다. 비문자열 입력의 경우, 입력의 자식 속성에 따라 경고 또는 배너를 표시합니다.
배지 숫자 앱 아이콘에 배지로 표시되는 숫자를 관리합니다
소리 문자열 경고로 재생할 사운드 파일의 이름; 앱의 번들이나 Library/Sounds 폴더에 있어야 합니다
콘텐츠 사용 가능 숫자 1의 입력 값은 앱에 시작 또는 세션 재개 시 새로운 정보의 가용성을 신호합니다.
알림 속성 라이브러리
키 값 유형 값 설명
제목 문자열 알림의 일부로 Apple Watch에 잠시 표시되는 짧은 문자열
몸 문자열 푸시 알림의 내용
제목-위치-키 문자열 또는 null 현재 현지화의 제목 문자열을 Localizable.strings 파일에서 설정하는 키
제목-위치-인수 문자열 배열 또는 null 제목 현지화 형식 지정자 대신 나타날 수 있는 문자열 값 제목-loc-key
action-loc-key 문자열 배열 또는 null 지정된 문자열이 있으면 닫기 및 보기 버튼에 대한 현지화를 설정합니다
로케이션 키 문자열 또는 null 현재 현지화에서 Localizable.strings 파일의 알림 메시지를 설정하는 키
위치 인수 문자열 배열 loc-key에 현지화 형식 지정자 대신 나타날 수 있는 문자열 값
런치 이미지 문자열 사용자가 실행 버튼을 누르거나 실행 슬라이드를 이동할 때 시작 이미지로 사용하려는 앱 번들에 있는 이미지 파일의 이름

Braze 메시지 작성기는 alert 및 its properties, content-available, sound, category 키의 생성을 자동으로 처리합니다.

이 값들은 푸시 메시지를 만들 때 설정 탭에 입력할 수 있습니다. 알림 옵션을 선택하고 새 키-값 항목에 자동으로 채워질 키에 대한 알림 사전 키를 선택합니다.

Braze가 APNs에 푸시 알림을 보낼 때, 페이로드는 JSON 형식으로 작성됩니다.

간단한 페이로드

1
2
3

{
    "aps" : { "alert" : "Message received from Spencer" },
}

복잡한 페이로드

1
2
3
4
5
6
7
8
9
10
11
12

{
    "aps" : {
        "alert" : {
            "body" : "Hi, welcome to our app!",
            "loc-key" : "France",
            "loc-args" : ["Bonjour", "bienvenue"],
            "action-loc-key" : "Button_Type_1",
            "launch-image" : "Paris"
      },
        "content-available" : 1
    },
}
커스텀 키-값 쌍

라이브러리 페이로드 값 외에도 사용자 기기에 커스텀 키-값 쌍을 보낼 수 있습니다. 이 쌍의 값은 원시 타입으로 제한됩니다: 사전 (객체), 배열, 문자열, 숫자 및 불리언.

커스텀 키-값 쌍의 사용 사례에는 내부 측정기준 유지 및 사용자 인터페이스의 컨텍스트 설정 등이 포함되지만 이에 국한되지는 않습니다. Braze는 extras key 내에서 애플리케이션을 통해 원하는 방식으로 사용할 수 있도록 푸시 알림과 함께 추가 키-값 쌍을 보낼 수 있게 해줍니다. 다른 키를 사용하려면 앱이 이 커스텀 키를 처리할 수 있는지 확인하세요.

Apple은 고객에게 고객 정보나 민감한 데이터를 커스텀 페이로드 데이터로 포함하지 않도록 권장합니다. 게다가 Apple은 경고 메시지와 관련된 모든 작업이 기기의 데이터를 삭제하지 않도록 권장합니다.

API로 트리거된 캠페인

Braze를 사용하면 extras으로 알려진 커스텀 정의 문자열 키-값 쌍을 보낼 수 있습니다. API 트리거 및 예약된 API 트리거 캠페인에서 추가 기능에 액세스하려면 대시보드에서 키를 “example_key”로 설정하고 값을 "$json:{"foo": 1, "bar": 1}"로 설정하십시오. 이로 인해 "extras": { "test": { "foo": 1, "bar": 1 }의 개발자 콘솔 출력이 발생합니다

Android

Braze를 사용하면 키-값 쌍을 사용하여 푸시 알림에 추가 데이터 페이로드를 보낼 수 있습니다.

데이터 페이로드

iOS 푸시와 유사하게, 사용자 기기에 커스텀 키-값 쌍을 보낼 수 있습니다.

커스텀 키-값 쌍의 몇 가지 사용 사례로는 내부 측정기준 유지 및 사용자 인터페이스에 대한 컨텍스트 설정이 포함되지만, 원하는 목적에 따라 사용할 수 있습니다.

API로 트리거된 캠페인

Braze를 사용하면 extras으로 알려진 커스텀 정의 문자열 키-값 쌍을 보낼 수 있습니다. API 트리거 및 예약된 API 트리거 캠페인에서 추가 기능에 액세스하려면 대시보드에서 키를 “example_key”로 설정하고 값을 "$json:{"foo": 1, "bar": 1}"로 설정하십시오. 이로 인해 "extras": { "test": { "foo": 1, "bar": 1 }의 개발자 콘솔 출력이 발생합니다.

FCM 메시징 옵션

Android 푸시 알림은 FCM 메시지 옵션으로 더욱 맞춤 설정할 수 있습니다. 여기에는 알림 우선순위, 소리, 지연, 수명 및 접을 수 있는 기능이 포함됩니다. 이 값들은 푸시 메시지를 만들 때 설정 탭에서 지정할 수 있습니다. Braze 메시지 작성기에서 이러한 옵션을 설정하는 방법에 대한 자세한 지침은 고급 푸시 알림 설정을 참조하십시오.

조용한 푸시 알림

무음 푸시 알림은 경고 메시지나 소리 없이 푸시 알림으로, 백그라운드에서 앱의 인터페이스나 콘텐츠를 업데이트하는 데 사용됩니다. 이 알림은 키-값 쌍을 사용하여 이러한 백그라운드 앱 동작을 트리거합니다. 푸시 알림은 또한 우리의 제거 추적을 지원합니다.

마케터는 푸시 알림이 앱 사용자에게 전송되기 전에 예상되는 동작을 트리거하는지 테스트해야 합니다. iOS 또는 Android 무음 푸시 알림을 작성한 후 외부 사용자 ID 또는 이메일 주소로 필터링하여 테스트 사용자만 타겟팅하도록 하십시오.

캠페인 시작 시, 테스트 기기에서 푸시 알림을 받지 않았는지 확인해야 합니다.

인앱 메시지

인앱 메시지에 키-값 페어를 추가하려면 메시지 작성기의 설정 탭을 선택하고, 새 페어 추가를 클릭한 다음 키-값 페어를 지정합니다.

API로 트리거된 캠페인

Braze를 사용하면 extras으로 알려진 커스텀 정의 문자열 키-값 쌍을 보낼 수 있습니다. API 트리거 및 예약된 API 트리거 캠페인에서 추가 기능에 액세스하려면 대시보드에서 키를 “example_key”로 설정하고 값을 "$json:{"foo": 1, "bar": 1}"로 설정하십시오. 이로 인해 "extras": { "test": { "foo": 1, "bar": 1 }의 개발자 콘솔 출력이 발생합니다.

이메일

SparkPost와 SendGrid는 이메일에서 키-값 쌍을 지원합니다. SendGrid를 사용하면 키-값 쌍이 고유 인수로 전송됩니다. SendGrid는 최대 10,000바이트의 데이터에 대해 무제한의 키-값 쌍을 첨부할 수 있습니다. 이러한 키-값 쌍은 SendGrid 이벤트 웹훅의 게시물에서 볼 수 있습니다.

Braze의 이메일 메시지 작성기의 보내기 정보 탭.

콘텐츠 카드

콘텐츠 카드에 키-값 페어를 추가하려면 Braze 메시지 작성기의 설정 탭으로 이동하여 새 페어 추가를 클릭하세요.

콘텐츠 카드에 키-값 페어 추가

Github   GitHub 에서 이 페이지를 편집합니다.
이 페이지가 얼마나 도움이 되었나요?
New Stuff!