커스텀 이벤트 속성정보

이 문서에서는 커스텀 이벤트 속성정보, 예상 형식, 메시징 및 세분화에 활용하는 방법, 커스텀 이벤트 속성정보 저장에 대해 설명합니다.

커스텀 이벤트 속성정보는 이벤트의 특정 발생을 설명하는 커스텀 이벤트 메타데이터 또는 속성입니다. 이러한 속성정보는 트리거 조건을 더 세밀하게 설정하고, 메시징에서 개인화를 강화하며, 전환을 추적하고, 원시 데이터 내보내기를 통해 더 정교한 분석을 생성하는 데 사용할 수 있습니다.

커스텀 이벤트 속성정보는 Braze 프로필에 저장되지 않으므로 데이터 포인트를 기록하지 않습니다(예외 사항은 데이터 포인트를 참조하세요).

사용자의 이벤트 속성정보 값 확인하기

특정 사용자의 커스텀 이벤트 속성정보 값을 확인하려면 설정에 따라 다음 옵션을 사용할 수 있습니다:

• Currents: 고객 행동 이벤트가 활성화되어 있으면 이벤트 속성정보가 Currents 내보내기에 포함됩니다.
• 이벤트 사용자 로그: 해당 사용자가 테스트 사용자이고 최근에 이벤트를 수행한 경우, 이벤트와 해당 속성정보가 설정 > 이벤트 사용자 로그에 표시됩니다.
• 세분화: 해당 속성정보에 대해 커스텀 이벤트 속성정보 저장이 활성화되어 있으면 이벤트 속성정보 필터를 사용하여 Segment를 생성하고 사용자가 조건에 해당하는지 확인할 수 있습니다.

중요

각 커스텀 이벤트 또는 구매에는 최대 256개의 고유한 커스텀 이벤트 속성정보를 포함할 수 있습니다. 커스텀 이벤트 또는 구매가 256개를 초과하는 속성정보와 함께 기록되면 처음 256개만 캡처되어 사용할 수 있습니다.

예상 형식

속성정보 값은 오브젝트여야 합니다. 키는 속성정보 이름(비어 있지 않은 문자열, 255자 이하, 선행 $ 없음)이고, 값은 속성정보 값입니다. 지원되는 데이터 유형, 형식 요구 사항 및 페이로드 제한에 대해서는 데이터 유형을 참조하세요.

커스텀 이벤트 속성정보의 데이터 유형을 변경할 수 있지만, 데이터가 수집된 후 데이터 유형을 변경할 때의 영향에 유의하세요.

예약 키

예약 키를 이벤트 속성정보 이름으로 사용할 수 없습니다. properties 오브젝트에서 예약 키를 사용하면 “Invalid ‘properties’ field” 오류가 반환됩니다.

커스텀 이벤트 속성정보 사용하기

커스텀 이벤트 속성정보는 Campaign 트리거 조건을 설정하고, 전환을 추적하며, 메시징을 개인화하는 데 사용할 수 있습니다.

메시지 트리거

커스텀 이벤트 속성정보를 사용하여 특정 Campaign 또는 Canvas의 오디언스를 더 세밀하게 좁힐 수 있습니다. 예를 들어, 이커머스 애플리케이션에서 사용자가 장바구니를 유기했을 때 메시지를 보내려면 price라는 커스텀 이벤트 속성정보를 추가하여 타겟 오디언스를 개선하고 Campaign 개인화를 강화할 수 있습니다.

중첩된 커스텀 이벤트 속성정보는 실행 기반 전달에서도 지원됩니다.

메시지 개인화

메시징 템플릿 내에서 개인화를 위해 커스텀 이벤트 속성정보를 사용할 수도 있습니다. 트리거 이벤트와 함께 실행 기반 전달을 사용하는 모든 Campaign은 해당 이벤트의 커스텀 이벤트 속성정보를 메시징 개인화에 활용할 수 있습니다.

필터 관련 고려사항

• API 호출: API 호출 시 “is blank” 필터를 사용하면, 호출에서 제외된 커스텀 이벤트 속성정보는 “blank”로 간주됩니다. 예를 들어, "event_property": ""를 포함하면 해당 사용자는 “not blank”로 간주됩니다.
• 정수: 숫자 커스텀 이벤트 속성정보로 필터링할 때 숫자가 매우 큰 경우 “exactly” 필터를 사용하지 마세요. 숫자가 너무 크면 특정 길이에서 반올림될 수 있어 필터가 예상대로 작동하지 않을 수 있습니다.

비교를 위한 타입 변환

Liquid 조건문에서 이벤트 속성정보를 사용할 때, 정수 이벤트 속성정보를 초과, 미만, 같음 등의 연산자로 비교하면 Liquid error: comparison of String with 0 failed 오류가 발생할 수 있습니다. 이는 Liquid가 기본적으로 속성정보를 문자열로 처리하기 때문입니다.

이를 해결하려면 비교 전에 plus: 0 필터를 사용하여 속성정보를 숫자로 변환하세요:

1
2
3
4
{% assign time_spent = {{event_properties.${time_spent}}} | plus: 0 %}
{% if time_spent >= 100 %}
  Great job completing the level quickly!
{% endif %}

예를 들어, 게임 앱에서 레벨을 완료한 사용자에게 메시지를 보내려면 해당 레벨을 완료하는 데 걸린 시간 속성정보로 메시지를 더욱 개인화할 수 있습니다.

다음 메시지는 조건 로직을 사용하여 세 가지 다른 세그먼트에 맞게 개인화됩니다. time_spent라는 커스텀 이벤트 속성정보는 {{event_properties.${time_spent}}}를 호출하여 메시지에 포함할 수 있습니다.

1
2
3
4
5
6
7
8
{% assign time_spent = {{event_properties.${time_spent}}} | plus: 0 %}
{% if time_spent < 600 %}
Incredible work, hero! Are you ready to test your skills against other powerful heroes? Visit the Arena for real-time battles with top players from around the globe.
{% elsif time_spent < 1800 %}
Great job, hero! Don't forget to visit the town store between levels to upgrade your tools.
{% else %}
Well done, hero! Talk to villagers for tips on how to beat levels faster and unlock more rewards.
{% endif %}

경고

사용자에게 인터넷 연결이 없는 경우, 템플릿화된 커스텀 이벤트 속성정보(예: {{event_properties.${time_spent}}})가 포함된 트리거 인앱 메시지는 실패하여 표시되지 않습니다.

인앱 메시지를 템플릿화된 인앱 메시지로 전달하게 하는 Liquid 태그의 전체 목록은 자주 묻는 질문을 참조하세요.

Canvas

Canvas에서 context와 event_properties는 서로 다른 용도로 사용됩니다:

• context: Canvas 진입을 트리거한 이벤트 또는 API 호출의 속성정보입니다. 첫 번째 메시지 단계를 포함하여 모든 메시지 단계에서 context를 사용할 수 있습니다.
• event_properties: 여정 중에 발생하는 커스텀 이벤트 또는 구매의 속성정보입니다. 작업 경로 단계 이후의 첫 번째 메시지 단계에서만 사용할 수 있으며, Everyone Else 경로나 이후 메시지 단계에서는 사용할 수 없습니다.

중요

Canvas의 첫 번째 메시지 단계에서는 event_properties 대신 context를 사용하거나, 메시지 단계 앞에 작업 경로 단계를 추가하세요. 예외: 인앱 메시지의 경우, 해당 이벤트가 Canvas 진입 트리거일 때 첫 번째 메시지 단계에서 event_properties를 사용할 수 있습니다.

자세한 내용은 컨텍스트 및 이벤트 속성정보와 Canvas 진입 속성정보 및 이벤트 속성정보를 참조하세요.

세분화

이벤트 속성정보 세분화를 사용하여 수행된 커스텀 이벤트와 해당 이벤트에 연결된 속성정보를 기반으로 사용자를 타겟팅할 수 있습니다. 이를 통해 구매 및 커스텀 이벤트별 세분화 시 필터링 옵션이 확장됩니다.

커스텀 이벤트의 이벤트 속성정보는 이를 사용하는 모든 Segment에 대해 실시간으로 업데이트됩니다. 데이터 설정 > 커스텀 이벤트로 이동하여 관련 커스텀 이벤트의 속성정보 관리를 선택하면 속성정보를 관리할 수 있습니다. 특정 Segment 필터에서 사용되는 커스텀 이벤트 속성정보는 최대 30일의 조회 기간을 가집니다.

세분화를 위한 이벤트 속성정보 추가

이벤트 속성정보 최신성 및 빈도를 기반으로 Segment를 생성하려면 “Edit Custom Event Property Segmentation” 사용자 권한이 필요합니다.

기본적으로 워크스페이스당 20개의 세분화 가능한 이벤트 속성정보를 사용할 수 있습니다. 이 한도를 늘리려면 Braze 계정 매니저에게 문의하세요.

세분화를 위한 이벤트 속성정보를 추가하려면 다음을 수행하세요:

1. 커스텀 이벤트로 이동하여 속성정보 관리를 선택합니다.
2. 세분화 활성화 토글을 선택하여 세분화를 위한 이벤트 속성정보를 추가합니다. 세분화 시 추가 필터링 옵션에 접근할 수 있습니다.

이벤트 속성정보 세분화 필터에는 다음이 포함됩니다:

• 지난 Y일 동안 속성정보 A의 값이 B인 커스텀 이벤트를 X회 수행한 적이 있습니다.
• 지난 Y일 동안 속성정보 A의 값이 B인 구매를 X회 한 적이 있습니다.
• 1일에서 30일 이내의 기간으로 Segment할 수 있는 기능이 추가되었습니다.

데이터는 해당 이벤트 속성정보를 활성화한 후에만 기록되며, 이벤트 속성정보는 해당 날짜 이후부터만 사용할 수 있습니다.

데이터 포인트

구독 사용량과 관련하여, 다음 필터로 세분화가 활성화된 커스텀 이벤트 속성정보는 커스텀 이벤트 자체에서 계산되는 데이터 포인트 외에 별도의 데이터 포인트로 각각 계산됩니다:

• X Custom Event Property in Y Days
• X Purchase Property in Y Days

Canvas 진입 속성정보 및 이벤트 속성정보

Canvas 사용자 여정에서 Canvas 진입 속성과 이벤트 속성을 사용할 수 있습니다.

• canvas entry properties
• event properties

Canvas 진입 속성은 실행 기반 또는 API로 트리거되는 Canvases에 매핑하는 속성입니다. canvas_entry_properties 오브젝트의 최대 크기 제한은 50KB입니다.

참고

인앱 메시지 채널의 경우, context는 Canvas에서만 참조할 수 있습니다.

다음 Liquid 형식을 사용하여 모든 메시지 단계에서 context를 참조할 수 있습니다: context.${property_name}. 이 방법을 사용하려면 이벤트가 커스텀 이벤트 또는 구매 이벤트여야 합니다.

사용 사례

소매점인 RetailApp에 다음과 같은 요청이 있다고 가정해 보겠습니다: "context" : {"product_name" : "shoes", "product_price" : 79.99}.

RetailApp은 이 Liquid를 사용하여 제품명(shoes)을 메시지로 가져올 수 있습니다: {{context.${product_name}}}.

또한 RetailApp은 구매 이벤트를 트리거한 사용자를 타겟으로 하는 Canvas에서 다양한 product_name 등록정보에 대해 특정 메시지를 전송하도록 트리거할 수 있습니다. 예를 들어, 신발을 구매한 사용자와 다른 제품을 구매한 사용자에게 각각 다른 메시지를 보낼 수 있도록 다음 Liquid를 메시지 단계에 추가할 수 있습니다.

1
2
3
4
5
6
{% if  {{context.${product_name}}} == "shoes" %}
  Your order is set to ship soon. While you're waiting, why not step up your shoe care routine with a little upgrade? Check out our selection of shoelaces and premium shoe polish.
{% else %}
  Your order will be on its way shortly. If you missed something, you have until the end of the week to add more items to your cart for the same discounts.
{% endif %}

기존 Canvas 편집기에 대해 펼치기

더 이상 기존 편집기를 사용하여 Canvases를 생성하거나 복제할 수 없습니다. 이 섹션은 참조용으로만 제공됩니다. 기존 편집기로 구축된 Canvases의 경우, Canvas 진입 속성은 Canvas의 첫 번째 전체 단계에서만 참조할 수 있습니다.

이벤트 속성은 커스텀 이벤트 및 구매에 대해 설정한 등록정보를 나타냅니다. 이러한 event_properties는 실행 기반 전달이 적용된 Campaigns 및 Canvases에서 사용할 수 있습니다.

중요

Canvas의 첫 번째 메시지 단계에서는 event_properties를 사용할 수 없습니다. 대신 context를 사용하거나 event_properties를 포함하는 메시지 단계 이전에 해당 이벤트가 포함된 행동 경로 단계를 추가해야 합니다.

Canvas에서 커스텀 이벤트 및 구매 이벤트 등록정보는 행동 경로 단계 이후에 오는 모든 메시지 단계에서 Liquid로 사용할 수 있습니다. 이러한 이벤트 등록정보를 참조할 때는 {{event_properties.${property_name}}}를 반드시 사용하세요. 이러한 이벤트는 메시지 구성요소에서 이 방식으로 사용하려면 커스텀 이벤트 또는 구매 이벤트여야 합니다.

행동 경로 다음에 오는 첫 번째 메시지 단계에서는 해당 행동 경로에서 참조된 이벤트와 관련된 이벤트 등록정보를 사용할 수 있습니다. 그러나 이러한 이벤트 등록정보는 사용자가 실제로 해당 동작을 수행한 경우에만 사용할 수 있습니다(다른 모든 사용자 그룹으로 분류되지 않은 경우). 이 행동 경로와 메시지 단계 사이에 다른 단계(다른 행동 경로 또는 메시지 단계가 아닌)를 포함할 수 있습니다.

기존 Canvas 편집기에 대해 펼치기

더 이상 기존 편집기를 사용하여 Canvases를 생성하거나 복제할 수 없습니다. 이 섹션은 참조용으로만 제공됩니다. 기존 Canvas 편집기에서는 스케줄된 전체 단계에서 이벤트 등록정보를 사용할 수 없습니다. 그러나 실행 기반 Canvas의 첫 번째 전체 단계에서는 해당 단계가 스케줄된 경우에도 이벤트 등록정보를 사용할 수 있습니다.

자세한 정보와 예시는 Canvas 진입 속성 및 이벤트 속성을 참조하세요.

중첩 객체

중첩 객체(다른 객체 내부의 객체)를 사용하여 커스텀 이벤트 및 구매의 속성정보로 중첩된 JSON 데이터를 전송할 수 있습니다. 이 중첩 데이터는 메시지에서 개인화된 정보를 템플릿화하고, 메시지 전송을 트리거하며, 사용자를 세분화하는 데 사용할 수 있습니다.

자세한 내용은 중첩 객체 전용 페이지를 참조하세요.

커스텀 이벤트 속성정보 저장

커스텀 이벤트 속성정보는 타겟팅 정밀도를 높이고 메시지를 더욱 개인화된 느낌으로 만들 수 있도록 설계되었습니다. 커스텀 이벤트 속성정보는 Braze 내에서 단기 및 장기 모두 저장할 수 있습니다.

이벤트 속성정보 값을 기반으로 세분화하는 방법은 두 가지가 있습니다.

1. 30일 이내: Braze Segments 내에서 특정 이벤트 속성정보 값의 빈도 및 최근성을 기반으로 이벤트 속성정보 세분화를 사용할 수 있습니다. 이 옵션은 데이터 사용량에 영향을 줍니다.
   
   
2. 30일 이내 및 이후: 단기 및 장기 이벤트 속성정보 세분화를 모두 다루려면 세그먼트 확장을 사용할 수 있습니다. 이 기능은 지난 2년 동안 추적된 커스텀 이벤트 및 이벤트 속성정보를 기반으로 사용자를 세분화합니다. 이 옵션은 데이터 사용량에 영향을 주지 않습니다.

특정 요구 사항에 따른 최적의 접근 방식에 대한 권장 사항은 Braze 고객 성공 매니저에게 문의하세요.