인앱 메시지 이벤트
인앱 메시지 이벤트에는 세 가지 종류의event.kind가 있습니다:
- 인앱 노출 -
message.iam.impression - 인앱 클릭 -
message.iam.clicked - 인앱 페이지 표시 -
message.iam.page_displayed
인앱 노출
이 이벤트는 메시지가 로드를 완료하고 화면에 표시되는 즉시 발생합니다. 캐러셀을 사용할 때event.data.page_name 및 event.data.page_id를 사용하여 표시된 특정 페이지의 이름과 UUID를 가져올 수 있습니다.
인앱 클릭
이 이벤트는 클릭 작업이 있는 모든 요소 또는 블록(“타겟”이라고도 함)에 적용됩니다.event.data.target_name 및 event.data.target_id를 사용하여 클릭된 특정 타겟의 이름과 UUID를 가져올 수 있으며, event.data.page_name 및 event.data.page_id를 사용하여 타겟이 속한 페이지도 가져올 수 있습니다.
자세한 내용은 인앱 클릭 작업을 참조하세요.
인앱 페이지 표시
이는 캐러셀에만 적용되는 이벤트입니다.event.data.page_name 및 event.data.page_id를 사용하여 표시된 특정 페이지 또는 카드의 이름과 UUID를 가져올 수 있습니다. 첫 번째 카드의 노출은 문서가 로드를 완료하는 즉시 발생합니다. 후속 페이지 노출은 스와이프 시 발생합니다.
인앱 메시지 이벤트 데이터
각event.kind는 인앱 메시지를 만드는 방법에 따라 추가 이벤트 데이터를 가질 수 있습니다.
event.kind가 clicked 또는 page_displayed일 때 표시되는 페이지 또는 카드의 이름입니다. impression 이벤트에는 사용할 수 없습니다.page_name은 어떤 페이지가 표시되었고 해당 페이지에서 무엇이 클릭되었는지 알아내는 데 도움이 됩니다.페이지 이름은 기본적으로 “Card 1”, “Card 2” 등이지만 Block Editor 내에서 이름을 변경할 수 있습니다.
인앱 메시지 이벤트 스트림 생성
이벤트 스트림 설정
이벤트 스트림 설정 및 개인화에 대한 안내는 이벤트 스트림 설정 지침을 검토하세요. 다음은 이벤트 스트림 구성(3단계)을 위한 IAM 관련 단계를 제공합니다.추적하려는 타겟이 올바르게 설정되었는지 확인
이벤트 스트림 요청 본문에서 사용자 지정 이름을 활용하려면 Block 또는 HTML 에디터에서 새 사용자 지정 이름을 수동으로 지정해야 합니다. 사용자 지정 이름이 릴리스되기 전에 존재했던 인앱 메시지는 각 페이지 또는 블록에 대한 사용자 지정 이름으로 인앱이 업데이트될 때까지 이벤트 스트림에서page_name 및 target_name 값을 노출할 수 없습니다.
인앱이 업데이트된 후 그 순간부터 트리거되는 이벤트 스트림 요청은 해당 값에 액세스할 수 있습니다. 언제든지 page_name 및 target_name 값은 해당 순간의 인앱 사용자 지정 이름 상태를 반영하며, 인앱이 다시 업데이트되면 변경될 수 있습니다.
- 블록 에디터
- HTML 에디터
세 가지 이벤트 모두 이 에디터와 함께 사용할 수 있습니다. 블록 에디터를 사용할 때 타겟에 인앱 클릭 작업이 포함되어 있는지 확인하세요. 타겟에는 이미지, 버튼, 닫기 버튼 및 배경 블록이 포함됩니다. 텍스트 블록은 현재 클릭 작업을 지원하지 않으며 포함되지 않습니다.대시보드 환경에서 혼란을 피하기 위해 타겟 사용자 지정 이름은 고유해야 합니다.
고유 ID 활용
모범 사례: 분석 목적으로 이벤트 스트림을 사용할 때message.id, page_id 및 target_id를 사용하여 고유성을 검증하세요. 사용자 지정 이름을 사용할 수 있지만 사람이 읽을 수 있는 형식으로 하나의 IAM 내 요소를 구별하는 데 도움이 되도록 의도되었습니다. 여러 인앱 메시지가 있는 경우 message.id를 사용하여 구별하세요.