Business Messages 위젯 자바스크립트 라이브러리는 프로그래매틱 방식으로 Business Messages 위젯의 참여 추적을 초기화하고 사용 설정합니다.
함수 및 속성
함수와 속성을 사용하면 요소 초기화를 세밀하게 제어할 수 있습니다.
Init
Business Messages 위젯으로 사용할 HTML 요소를 동적으로 초기화합니다. 이 함수는 초기화가 완료되면 확인되는 프로미스를 반환합니다.
window.bmwidget.init(HTMLElement, {agentId, context}):Promise
HTMLElement은 위젯으로 초기화할 요소입니다.{agentId, context}는data-bm-widget-agent-id및data-bm-widget-contextHTML 속성 값입니다.
스캔
문서에서 data-bm-widget-agent-id 속성이 포함된 HTML 요소를 스캔하고 이 요소를 Business Messages 위젯으로 변환합니다. window.bmwidget.scan()는 페이지 로드 중과 스크립트 초기화 중에 자동으로 호출됩니다.
window.bmwidget.scan():void
지원됨
사용자 기기가 Business Messages를 지원하는 경우 true인 읽기 전용 부울 플래그입니다.
window.bmwidget.supported:boolean
이벤트
라이브러리는 Business Messages 위젯으로 초기화하는 HTML 요소에서 이벤트를 트리거합니다.
결합 성공
bm-widget-bind-success 요소는 HTML 요소가 비즈니스 메시지 위젯에 성공적으로 바인딩되고 사용할 준비가 되면 트리거됩니다.
domNode.addEventListener('bm-widget-bind-success', (event) => {
console.log(event.data);
});
바인딩 실패
bm-widget-bind-fail 이벤트는 HTML 요소에 결합하려는 시도가 실패하면 트리거됩니다. URL의 유효성을 검사하지 못하거나 일반적으로
HTML 요소를 가져오지 못해서 이러한 문제가 발생할 수 있습니다. URL이 Business Messages 위젯 진입점으로 등록되지 않았거나 사용자 기기가 지원되지 않는 경우 검증에 실패합니다.
event.data 속성에는 실패의 원인이 자세히 설명되어 있습니다.
domNode.addEventListener('bm-widget-bind-fail', (event) => {
console.log(event.data);
});
인텐트 트리거
bm-widget-intent-trigger 이벤트는 사용자가 초기화된 Business Messages 위젯 진입점을 탭할 때 트리거됩니다. 이 이벤트는 탭 신호를 보내지만 Business Messages 대화형 노출 영역이 성공적으로 초기화되었는지는 나타내지 않습니다.
domNode.addEventListener('bm-widget-intent-trigger', (event) => {
console.log(event.data);
});