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(obj, "FPLink") 로 등록한 객체의 메서드를 JSON 문자열 1개로 호출
//   onClicked, onStoreVisited, onAppInstalled, onAppOpened, onDeepLinkResolved,
//   onContentViewed, onActionTaken, onGoalCompleted, onSessionChanged, onReady
//   (없는 메서드는 onFunnelEvent(stage, json) 으로 대신 호출 — READY 는 제외)
window.FPLink.onGoalCompleted('{"event":"GOAL_COMPLETED","goalType":"purchase","goalValue":29900,"serverSuccess":true,...}');

// iOS — WKScriptMessageHandler 이름 "FPLink" 로 객체 1개 전달
window.webkit.messageHandlers.FPLink.postMessage({
    event: 'GOAL_COMPLETED', goalType: 'purchase', goalValue: 29900, serverSuccess: true, ...
});

class FPLinkBridge {
    @JavascriptInterface
    fun onGoalCompleted(json: String) {
        val data = JSONObject(json)
        // data.optString("goalType"), data.optDouble("goalValue"), data.optBoolean("serverSuccess")
    }
}
webView.addJavascriptInterface(FPLinkBridge(), "FPLink")

// 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');
// → 콘솔: 캠페인 목록의 사용자 여정 분석 버튼에서 확인

// 방법 1: 페이지 주소에 파라미터를 붙여 들어오게 하기 (권장)
//   https://shop.example.com/shoes?fplink_url_id=123   (캠페인이면 ?fplink_cid=456)
//   → SDK가 초기화 시 읽어 저장하고, 이후 모든 이벤트/퍼널/전환에 자동 포함 (귀속 기간 기본 7일)

// 방법 2: 호출마다 옵션으로 지정 — 옵션 값은 그 호출에만 실리고 저장되지 않습니다
tracker.trackFunnelEvent('DEEP_LINK_RESOLVED', { urlId: 123 });
tracker.trackFunnelEvent('GOAL_COMPLETED', {
    urlId: 123, goalType: 'purchase', goalValue: 29900, goalCurrency: 'KRW'
});