위젯 열기/닫기 (open / close)

open / close는 고객사 코드에서 위젯 패널을 직접 열고 닫는 명령형(imperative) 메서드입니다. 기본·커스텀 런처 클릭 없이 코드로 위젯을 제어할 때 사용하며, 개념과 동작은 모든 플랫폼이 동일하고 호출 형태만 플랫폼마다 다릅니다.

open — 위젯 열기

위젯 패널을 엽니다. boot이 만들어 둔 위젯 URL(로그인 상태가 반영된 URL)을 그대로 사용하므로 별도의 인증 처리는 필요 없습니다.

Incento('open');

import Incento from './incento.service';

Incento.open();

IncentoService.shared.open()

IncentoService.open()

close — 위젯 닫기

열려 있는 위젯 패널을 닫습니다. 위젯이 열려 있지 않으면 아무 동작도 하지 않습니다(no-op). 고객사가 자사 UI 흐름(자사 모달 닫힘, 라우트 이동, 결제 완료 화면 전환 등)에서 위젯을 닫는 유일한 수단입니다.

Incento('close');

import Incento from './incento.service';

Incento.close();

IncentoService.shared.close()

IncentoService.close()

사용 시점

• 조건·시점 기반 자동 오픈 — 결제 완료 직후 리워드 위젯 노출, 장바구니 금액 도달, A/B 분기 등 사용자 제스처 없이 코드로 오픈
• 자사 UI 흐름에서 위젯 닫기 — 자사 모달 닫힘·라우트 이동·결제 완료 화면 전환 등
• 마크업·셀렉터 의존 없음 — JS 호출만으로 즉시 동작하므로 SPA 동적 렌더링에서도 race condition이 없음

직접 만든 버튼으로 위젯을 여는 커스텀 런처 패턴(기본 런처 숨김 + open 호출)은 각 플랫폼 가이드의 커스텀 런처 절을 참고하세요: SPA · MPA · iOS · Android.

출처 구분

open으로 연 전환은 분석에서 **eventType 'E'**로 집계됩니다. URL 파라미터 기반 자동 오픈(incento_popup)과는 구분되므로, 고객사가 자체 트리거로 연 케이스를 분리해 분석할 수 있습니다.