메시지 추가 기능 Liquid 태그

message_extras Liquid 태그를 사용하여 연결된 콘텐츠, 카탈로그, 커스텀 속성(예: 언어, 국가), 캔버스 항목 속성 또는 기타 데이터 소스의 동적 데이터로 보내기 이벤트에 주석을 달 수 있습니다.

message_extras Liquid 태그는 커런츠 및 Snowflake 데이터 공유의 해당 전송 이벤트에 키-값 페어를 추가합니다.

동적 또는 추가 데이터를 커런츠 또는 Snowflake 데이터 공유 전송 이벤트로 다시 보내려면 메시지 본문에 적절한 Liquid 태그를 삽입하세요.

다음은 message_extras 에 대한 표준 Liquid 태그 형식의 예시입니다:

1
{% message_extras :key test :value 123 %}

메시지 본문에 키-값 페어를 위해 필요한 태그를 추가할 수 있습니다. 그러나 모든 키와 값의 길이는 1KB를 초과해서는 안 됩니다. 커런츠 및 Snowflake 데이터 공유에서 전송 이벤트에 대해 message_extras라는 새 이벤트 필드를 볼 수 있습니다. 이것은 하나의 필드에 JSON 직렬화된 문자열을 생성합니다.

지원 채널

message_extras 태그는 모든 메시지 유형에 대해 전송 이벤트와 함께 인앱 메시지 노출 횟수 이벤트를 지원합니다. 인앱 메시지에서 message_extras를 사용하려면 특정 최소 SDK 버전을 충족해야 합니다.

message_extras 태그 사용 방법

1. 채널의 메시지 본문에 message_extras Liquid 태그를 입력합니다. 또는 개인화 추가 모달을 사용하고 개인화 유형에 대해 메시지 추가 기능을 선택할 수 있습니다.

2. 각 message_extras 태그에 대한 키-값 페어를 입력하세요.

3. 캠페인 또는 캔버스가 발송된 후, Braze는 발송 시간에 동적 데이터를 커런츠 또는 Snowflake 데이터 공유 발송 이벤트를 통해 message_extras 필드에 첨부합니다.

구문 검사

위에서 설명한 태그 표준과 일치하지 않는 다른 입력은 커런츠 또는 Snowflake에 전달되지 않을 수 있습니다. 다음 중 어느 것도 포함하지 않도록 구문이나 형식을 확인하십시오:

• 존재하지 않거나 비어 있거나 잘못 입력된 구분 기호
• 중복 키(Braze는 처음으로 발견된 키-값 페어를 보내는 기본값을 사용합니다)
• 키 또는 값이 정의되기 전에 추가 텍스트
• 순서가 맞지 않는 키와 값
  • 예를 들어, {% message_extras :value 123 :key test %}

커런츠에 프로모션 코드 정보 보내기

프로모션 코드와 message_extras결합하여 커런츠에 프로모션 코드 정보를 전송할 수 있습니다. 태그를capture 사용하여 프로모션 코드를 변수에 저장한 후, 해당 변수를 에서 참조하세요message_extras:

1
2
3
4
5
{% capture code %}
{% promotion('puttshacktest2') %}
{% endcapture %}
Use {{code}} for an exclusive discount!
{% message_extras :key cardscode :value {{code}} %}

고려 사항

• 키-값이 1KB를 초과하면 잘립니다.
• 공백은 문자 수에 포함됩니다. Braze는 앞뒤 공백을 생략합니다.
• 결과 JSON은 문자열 값만 출력합니다.
• Liquid 변수를 키 또는 값으로 포함할 수는 있지만 message_extras 내에 다른 Liquid 태그를 사용할 수는 없습니다.
  • 예를 들어 다음과 같은 Liquid를 사용할 수 있습니다: {% assign value = '123' %} {% assign key = 'test' %} {% message_extras :key {{key}} :value {{value}} %}

Frequently asked questions

이벤트 보내기에서 message_extras 필드를 열기 및 클릭과 같은 참여 이벤트에 연결하려면 어떻게 해야 하나요?

dispatch_id가 생성되어 전송 이벤트에 제공되며, 특정 클릭, 열람 또는 전달된 이벤트와 연결할 수 있는 고유 식별자로 사용할 수 있습니다. 이 필드는 커런츠 또는 Snowflake에서 사용하고 쿼리할 수 있습니다. dispatch_id동작에 대해 자세히 알아보세요.

message_extras 을 인앱 메시지와 함께 사용할 수 있나요?

네, 사용자의 기기가 다음 최소 SDK 버전에서 실행되는 한 message_extras를 인앱 메시지에서 사용할 수 있습니다.