FingerPush Link SDK 따라하기

webView.settings.javaScriptEnabled = true    // JS 필수
webView.settings.domStorageEnabled = true   // localStorage 필수 (세션 저장)

// WKWebView는 JavaScript, localStorage 모두 기본 활성
// .default() dataStore를 사용하면 별도 설정 없이 동작합니다
let config = WKWebViewConfiguration()
config.websiteDataStore = .default()
let webView = WKWebView(frame: view.bounds, configuration: config)

override fun onNewIntent(intent: Intent?) {
    super.onNewIntent(intent)
    intent?.data?.let { uri ->
        val sessionId = uri.getQueryParameter("fplink_sid")
        val goalType  = uri.getQueryParameter("fplink_goal_type")
        val urlId     = uri.getQueryParameter("fplink_url_id")
        val campaignId = uri.getQueryParameter("fplink_cid")

        if (sessionId != null) {
            webView.evaluateJavascript("""                localStorage.setItem('fplink_session_id', JSON.stringify({
                    sessionId: '$sessionId',
                    expiresAt: new Date(Date.now() + 30*24*60*60*1000).toISOString(),
                    platform: 'android',
                    source: 'deeplink',
                    urlId: ${urlId ?: "null"},
                    campaignId: ${campaignId ?: "null"}
                }));
                // SDK 메모리의 세션 ID도 즉시 갱신
                if(window.tracker) window.tracker.refreshSession('$sessionId');
                ${if (goalType != null) "if(window.tracker) tracker.setGoalType('$goalType');" else ""}
            """.trimIndent(), null)
        }
    }
}

func handleUniversalLink(_ url: URL) {
    let components = URLComponents(url: url, resolvingAgainstBaseURL: false)
    let sessionId = components?.queryItems?.first(where: { $0.name == "fplink_sid" })?.value
    let goalType  = components?.queryItems?.first(where: { $0.name == "fplink_goal_type" })?.value
    let urlId     = components?.queryItems?.first(where: { $0.name == "fplink_url_id" })?.value
    let campaignId = components?.queryItems?.first(where: { $0.name == "fplink_cid" })?.value

    if let sid = sessionId {
        let urlIdJs = urlId ?? "null"
        let cidJs = campaignId ?? "null"
        let script = """
            localStorage.setItem('fplink_session_id', JSON.stringify({
                sessionId: '\(sid)',
                expiresAt: new Date(Date.now() + 30*24*60*60*1000).toISOString(),
                platform: 'ios',
                source: 'universal_link',
                urlId: \(urlIdJs),
                campaignId: \(cidJs)
            }));
            // SDK 메모리의 세션 ID도 즉시 갱신
            if(window.tracker) window.tracker.refreshSession('\(sid)');
            \(goalType.map { "if(window.tracker) tracker.setGoalType('\($0)');" } ?? "")
        """
        webView.evaluateJavaScript(script, completionHandler: nil)
    }
}

<activity android:name=".MainActivity"
    android:exported="true"
    android:launchMode="singleTask">

    <!-- 앱 링크 (단축 URL 클릭 시 앱 열기) -->
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="https"
              android:host="fplink.net" />
    </intent-filter>
</activity>

// Xcode → Signing & Capabilities → + Associated Domains
// 아래 도메인을 추가하세요:

applinks:fplink.net
applinks:your-custom.fplink.net   // 커스텀 도메인 사용 시

// Android 브릿지 (addJavascriptInterface로 등록)
if (window.FPLink) {
    window.FPLink.onGoalCompleted('purchase', 29900);
}

// iOS 브릿지 (WKScriptMessageHandler로 등록)
if (window.webkit && window.webkit.messageHandlers.FPLink) {
    window.webkit.messageHandlers.FPLink.postMessage({
        action: 'goalCompleted',
        goalType: 'purchase',
        goalValue: 29900
    });
}

// 1. 콘솔에서 단축 URL 생성
//    URL ID: 123, 단축 URL: fplink.net/abc
//    원본: https://shop.example.com/shoes

// 2. 사용자가 fplink.net/abc 클릭
//    → 서버: fplink_sid=UUID 생성 + fplink_url_id=123 추가
//    → 리다이렉트: https://shop.example.com/shoes?fplink_sid=xxx&fplink_url_id=123

// 3. SDK가 URL에서 fplink_sid + fplink_url_id 자동 감지 → 세션 + URL 연결
var tracker = new FPLinkTracker({
    baseUrl: 'https://fplink.net',
    apiKey: 'YOUR_API_KEY',
    appId: 42,
    platform: 'web'
});
// → SDK init()이 fplink_sid를 자동 감지하고 서버에 세션 등록

// 4. 이후 모든 이벤트/퍼널/전환이 URL ID 123에 귀속
tracker.trackEvent('product_view', { productId: 'P-001' });
tracker.trackGoal('purchase', 29900, 'KRW');

// 캠페인 URL: fplink.net/c/summer-sale (캠페인 ID: 456)
// 사용자 클릭 → fplink_sid + fplink_cid=456 자동 연결

// SDK 코드는 동일 — 추가 설정 불필요!
var tracker = new FPLinkTracker({
    baseUrl: 'https://fplink.net',
    apiKey: 'YOUR_API_KEY',
    appId: 42,
    platform: 'web'
});

// 이벤트/전환이 캠페인 456에 자동 귀속
tracker.trackPurchase(29900, 'KRW');
// → 콘솔: 캠페인 상세 → 사용자 여정 분석에서 확인

// 퍼널 이벤트에 urlId, campaignId 직접 지정
tracker.trackFunnelEvent('CLICKED', {
    urlId: 123,
    campaignId: 456
});

// 이후 퍼널 이벤트에서는 인스턴스에 저장된 값 자동 사용
tracker.trackFunnelEvent('APP_OPENED');
tracker.trackGoal('purchase', 29900, 'KRW');
// → urlId: 123, campaignId: 456 자동 포함