Coordinator API

startCoordinator()

퍼널 및 규칙 정의로 coordinator를 초기화합니다.

const coordinator = startCoordinator({
  funnels: [...],
  nudgeRules: [...],
  runner: { run: ... },
  cooldownStorage,
  exposureStorage,
  getUserPersonalTier: (userId) => 'free' | 'pro',
});

파라미터

파라미터	필수	설명
funnels	예	퍼널 정의 배열
nudgeRules	예	규칙 정의 배열
runner	예	액션 실행 핸들러
cooldownStorage	예	쿨다운 영속성
exposureStorage	예	노출 로그 영속성
getUserPersonalTier	아니오	사용자 등급 resolver 함수

사용법

const coordinator = startCoordinator({
  funnels: [paywallFunnel],
  nudgeRules: [paywallRule],
  runner: {
    run: async (action) => {
      if (action.type === 'paywall') {
        showPaywall(action.data);
      }
    },
  },
  cooldownStorage: new NudgeCooldownStorage({ storage: localStorage }),
  exposureStorage: new NudgeExposureLogStorage({ storage: localStorage }),
  getUserPersonalTier: (userId) => getUserTier(userId),
});

메서드

coordinator.cleanup();

Coordinator를 중지하고 구독을 정리합니다.

모범 사례

한 번만 초기화: 애플리케이션 시작 시 coordinator를 한 번만 생성합니다.

• React: 빈 의존성 배열로 useEffect 내부에서
• React Native: 빈 의존성 배열로 useEffect 내부에서
• Vanilla JS: 애플리케이션 진입점에서

중복 방지: 여러 coordinator 인스턴스는 중복 액션 실행을 유발할 수 있습니다.

다음 단계

• 타입 - TypeScript 정의
• 저장소 서비스 - 영속성 설정