// build.gradle.kts (app)
dependencies {
    implementation("com.vialink:sdk:1.0.0")
}

// Application.kt
class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()

        ViaLinkSDK.init(this, "YOUR_API_KEY")
    }
}

// 딥링크 콜백 등록 (SDK 3.1+: (DeepLinkData?) -> Unit)
// handleIntent 호출 시 항상 1회 호출:
//   - data != null : App Link 진입 → data.path로 라우팅
//   - data == null : 일반 진입(아이콘 탭 등) → 기본 화면 유지
ViaLinkSDK.onDeepLink { data ->
    if (data == null) {
        Log.d("ViaLink", "일반 진입 — 기본 화면 유지")
        return@onDeepLink
    }
    Log.d("ViaLink", "경로: ${data.path}")
    Log.d("ViaLink", "파라미터: ${data.params}")
}

// 디퍼드 딥링크 콜백 (SDK 3.2+: 앱 진입 시 매번 1회 호출)
// - 첫 실행: 5초 안에 매칭 결과 결정 즉시 호출 (timeout/실패 시 error)
// - 비첫 실행: 즉시 (null, null) — /v1/open 호출 X (organic과 동일 의미)
ViaLinkSDK.onDeferredDeepLink { data, error ->
    when {
        error != null -> Log.w("ViaLink", "디퍼드 매칭 실패: ${error.code}")
        data == null  -> Log.d("ViaLink", "organic 또는 비첫 실행 — 일반 진입")
        else          -> Log.d("ViaLink", "디퍼드: ${data.path}")
    }
}

// Activity에서 진입 Intent 처리 (SDK 3.1+: 일반 진입에서도 콜백 호출)
class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        ViaLinkSDK.handleIntent(intent)        // 항상 호출
    }

    override fun onNewIntent(intent: Intent) {
        super.onNewIntent(intent)
        ViaLinkSDK.handleIntent(intent)
    }
}

// 구매 완료
ViaLinkSDK.track("purchase", mapOf(
    "product_id" to "12345",
    "revenue" to 29900,
    "currency" to "KRW"
))

// 회원가입
ViaLinkSDK.track("signup")

// 장바구니 추가
ViaLinkSDK.track("add_to_cart", mapOf("product_id" to "12345"))

import com.vialink.sdk.ViaLinkSDK
import com.vialink.sdk.model.PaymentInitiatedArgs
import kotlinx.coroutines.launch

// 결제창 띄우기 직전 (Coroutine scope 안에서)
lifecycleScope.launch {
    try {
        val result = ViaLinkSDK.payment.initiated(
            PaymentInitiatedArgs(
                orderId = "ORD-2026-0001",
                amount = 19900.0,
                currency = "KRW",
                paymentMethod = "card",
                metadata = mapOf("productId" to "prod-001"),
            )
        )
        // result.success, result.paymentEventId
        Log.d("ViaLink", "payment_event_id=${result.paymentEventId}")
    } catch (e: IllegalArgumentException) {
        // 입력 검증 실패 (orderId 형식, amount, currency)
    } catch (e: Exception) {
        // 네트워크 오류
    }
}

lifecycleScope.launch {
    val result = ViaLinkSDK.createLink(
        path = "/product/12345",
        data = mapOf("promo_code" to "FRIEND_SHARE"),
        campaign = "referral",
        linkType = "dynamic", // 클릭 추적 필요 (생략 시 "static")
        iosUrl = "https://apps.apple.com/app/id123456",
        androidUrl = "https://play.google.com/store/apps/details?id=com.example",
        webUrl = "https://www.example.com/product/12345",
        ogTitle = "여름 세일 특가",
        ogDescription = "지금 확인하세요!",
        ogImageUrl = "https://cdn.example.com/promo.jpg",
        channel = "email",
        feature = "product_share",
        tags = listOf("summer", "sale"),
        expiresAt = "2026-12-31T23:59:59Z"
    )

    result.onSuccess { shortUrl ->
        // shortUrl: "https://vialink.app/{your-slug}/xYz12"
        val sendIntent = Intent().apply {
            action = Intent.ACTION_SEND
            putExtra(Intent.EXTRA_TEXT, shortUrl)
            type = "text/plain"
        }
        startActivity(Intent.createChooser(sendIntent, "공유하기"))
    }
}

import com.vialink.sdk.ViaLinkSDK;
import com.vialink.sdk.model.CreateLinkOptions;
import java.util.Map;
import java.util.List;

// 풀 옵션 — CreateLinkOptions Builder 사용 (Callback)
CreateLinkOptions opts = new CreateLinkOptions.Builder()
    .data(Map.of("promo_code", "FRIEND_SHARE"))
    .campaign("referral")
    .linkType("dynamic")
    .iosUrl("https://apps.apple.com/app/id123456")
    .androidUrl("https://play.google.com/store/apps/details?id=com.example")
    .webUrl("https://www.example.com/product/12345")
    .ogTitle("여름 세일 특가")
    .ogImageUrl("https://cdn.example.com/promo.jpg")
    .channel("email")
    .feature("product_share")
    .tags(List.of("summer", "sale"))
    .expiresAt("2026-12-31T23:59:59Z")
    .build();
ViaLinkSDK.createLinkAsync(
    "/product/12345",
    opts,
    shortUrl -> { /* 성공 (메인 스레드) */ },
    err -> Log.e("ViaLink", "링크 생성 실패", err)
);

// CompletableFuture 스타일 (minSdk 24+)
ViaLinkSDK.createLinkFuture("/product/12345", opts)
    .thenAccept(shortUrl -> { /* 성공 */ })
    .exceptionally(err -> { /* 실패 */ return null; });

// 단순 호출 — 폴백/OG 등 옵션이 필요 없을 때
ViaLinkSDK.createLinkAsync(
    "/product/12345",
    Map.of("promo_code", "FRIEND_SHARE"),
    "referral",
    "dynamic",
    shortUrl -> {},
    err -> {}
);

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

    <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="vialink.app"

            android:pathPrefix="/{your-slug}/" />
    </intent-filter>
</activity>

Xcode > File > Add Package Dependencies
URL: https://github.com/aresjoydev/vialink-ios-sdk

import ViaLinkCore

// AppDelegate
func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions ...) -> Bool {
    ViaLinkSDK.shared.configure(apiKey: "YOUR_API_KEY")
    return true
}

// 또는 SwiftUI App
@main
struct MyApp: App {
    init() {
        ViaLinkSDK.shared.configure(apiKey: "YOUR_API_KEY")
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
                .onOpenURL { url in
                    ViaLinkSDK.shared.handleURL(url)
                }
        }
    }
}

// 딥링크 콜백 등록 (SDK 3.1+: (DeepLinkData?) -> Void)
// 진입 알림 시 항상 1회 호출:
//   - data != nil : Universal Link 진입 → data.path로 라우팅
//   - data == nil : 일반 진입(아이콘 탭 등) → 기본 화면 유지
ViaLinkSDK.shared.onDeepLink { data in
    guard let data = data else {
        print("일반 진입 — 기본 화면 유지")
        return
    }
    print("경로: \(data.path)")
    print("파라미터: \(data.params)")
}

// 디퍼드 딥링크 콜백 (SDK 3.2+: 앱 진입 시 매번 1회 호출)
// - 첫 실행: 5초 안에 매칭 결과 결정 즉시 호출 (timeout/실패 시 error)
// - 비첫 실행: 즉시 (nil, nil) — /v1/open 호출 X (organic과 동일 의미)
ViaLinkSDK.shared.onDeferredDeepLink { data, error in
    if let error = error {
        print("디퍼드 매칭 실패: \(error.code.rawValue)")
    } else if let data = data {
        print("디퍼드: \(data.path)")
    } else {
        print("organic 또는 비첫 실행 — 일반 진입")
    }
}

// SceneDelegate에서 Universal Link 처리 + 일반 진입 알림 (3.1+)
func scene(_ scene: UIScene,
           willConnectTo session: UISceneSession,
           options: UIScene.ConnectionOptions) {
    if let activity = options.userActivities.first {
        ViaLinkSDK.shared.handleUniversalLink(activity)
    } else if let urlContext = options.urlContexts.first {
        ViaLinkSDK.shared.handleURL(urlContext.url)
    } else {
        ViaLinkSDK.shared.notifyAppLaunch()        // 일반 진입
    }
}

func scene(_ scene: UIScene,
           continue userActivity: NSUserActivity) {
    ViaLinkSDK.shared.handleUniversalLink(userActivity)
}

// 구매 완료
ViaLinkSDK.shared.track("purchase", data: [
    "product_id": "12345",
    "revenue": "29900",
    "currency": "KRW"
])

// 회원가입
ViaLinkSDK.shared.track("signup")

import ViaLinkCore

// 결제창 띄우기 직전 (async 컨텍스트 안에서)
Task {
    do {
        let result = try await ViaLinkSDK.shared.payment.initiated(
            PaymentInitiatedArgs(
                orderId: "ORD-2026-0001",
                amount: 19900,
                currency: "KRW",
                paymentMethod: "card",
                metadata: ["productId": "prod-001"]
            )
        )
        print("payment_event_id=\(result.paymentEventId)")
    } catch let error as PaymentError {
        // .invalidOrderId / .invalidAmount / .invalidCurrency / .sdkNotInitialized / .networkFailure
    } catch {
        // 기타 오류
    }
}

let shortUrl = try await ViaLinkSDK.shared.createLink(
    path: "/product/12345",
    data: ["promo_code": "FRIEND_SHARE"],
    campaign: "referral",
    linkType: "dynamic", // 클릭 추적 필요 (생략 시 "static")
    iosUrl: "https://apps.apple.com/app/id123456",
    androidUrl: "https://play.google.com/store/apps/details?id=com.example",
    webUrl: "https://www.example.com/product/12345",
    ogTitle: "여름 세일 특가",
    ogDescription: "지금 확인하세요!",
    ogImageUrl: "https://cdn.example.com/promo.jpg",
    channel: "email",
    feature: "product_share",
    tags: ["summer", "sale"],
    expiresAt: "2026-12-31T23:59:59Z"
)
// shortUrl: "https://vialink.app/{your-slug}/xYz12"

let activityVC = UIActivityViewController(
    activityItems: [shortUrl],
    applicationActivities: nil
)
present(activityVC, animated: true)

1. Xcode > Target > Signing & Capabilities
2. + Capability > Associated Domains
3. 도메인 추가: applinks:vialink.app

npm install vialink-web-sdk

import { ViaLinkWebSDK } from 'vialink-web-sdk';

const sdk = ViaLinkWebSDK.init({
  apiKey: 'YOUR_API_KEY'
});

// 콜백 패턴 (SDK 3.1+: 등록 즉시 현재 URL 1회 파싱)
//   - data != null : ViaLink 딥링크 형식 진입 → data.path로 라우팅
//   - data == null : 일반 진입(랜딩 페이지 등) → 기본 라우트 유지
sdk.onDeepLink((data) => {
  if (!data) {
    console.log('일반 진입 — 기본 라우트 유지');
    return;
  }
  console.log('경로:', data.path);
  console.log('파라미터:', data.params);
  // window.location.href = data.path 또는 라우터 navigate
});

// 동기 추출 패턴 (페이지 로드 시점에 즉시)
const data = sdk.getDeepLinkData();
if (data) {
  console.log('shortCode:', data.shortCode);
}

// 정적 메서드로 임의 URL 파싱
const parsed = ViaLinkWebSDK.parseDeepLinkFromURL(
  'https://vialink.app/{your-slug}/xYz12?ref=share'
);

// 구매 완료
sdk.track('purchase', {
  product_id: '12345',
  revenue: 29900,
  currency: 'KRW'
});

// 즉시 전송
await sdk.flush();

import { ViaLinkWebSDK } from 'vialink-web-sdk';

ViaLinkWebSDK.init({ apiKey: 'YOUR_API_KEY' });

// 결제창 띄우기 직전:
try {
  const result = await ViaLinkWebSDK.payment.initiated({
    orderId: 'ORD-2026-0001',
    amount: 19900,
    currency: 'KRW',
    paymentMethod: 'card',
    metadata: { productId: 'prod-001' },
  });
  console.log('payment_event_id=', result.paymentEventId);
} catch (e) {
  // 입력 검증 실패 또는 네트워크 오류
  console.error(e);
}

const shortUrl = await sdk.createLink(
  '/product/12345',
  { promo_code: 'FRIEND_SHARE' },
  'referral',
  'dynamic', // 클릭 추적 필요 (생략 시 'static')
  {
    iosUrl: 'https://apps.apple.com/app/id123456',
    androidUrl: 'https://play.google.com/store/apps/details?id=com.example',
    webUrl: 'https://www.example.com/product/12345',
    ogTitle: '여름 세일 특가',
    ogDescription: '지금 확인하세요!',
    ogImageUrl: 'https://cdn.example.com/promo.jpg',
    channel: 'email',
    feature: 'product_share',
    tags: ['summer', 'sale'],
    expiresAt: '2026-12-31T23:59:59Z',
  }
);
console.log(shortUrl); // "https://vialink.app/{your-slug}/xYz12"

sdk.showBanner({
  title: '앱에서 보기',
  description: '더 빠른 경험을 위해 앱을 사용하세요',
  buttonText: '열기',
  iosStoreUrl: 'https://apps.apple.com/app/id123456',
  androidStoreUrl: 'https://play.google.com/store/apps/...',
  position: 'bottom',
  theme: 'light'
});

// 배너 숨기기
sdk.hideBanner();

npm install vialink-react-native-sdk
# 또는
yarn add vialink-react-native-sdk

import { ViaLinkSDK } from 'vialink-react-native-sdk';

// App.tsx
function App() {
  useEffect(() => {
    ViaLinkSDK.shared.configure('YOUR_API_KEY');

    return () => {
      ViaLinkSDK.shared.destroy();
    };
  }, []);

  return <Navigation />;
}

// 딥링크 콜백 등록 (SDK 3.1+: (data: DeepLinkData | null) => void)
// 네이티브 진입 알림 시 항상 1회 호출:
//   - data != null : App Links / Universal Links 진입 → data.path로 라우팅
//   - data == null : 일반 진입(아이콘 탭 등) → 기본 라우트 유지
ViaLinkSDK.shared.onDeepLink((data) => {
  if (!data) {
    console.log('일반 진입 — 기본 라우트 유지');
    return;
  }
  console.log('경로:', data.path);
  console.log('파라미터:', data.params);
  navigation.navigate(data.path, data.params);
});

// 디퍼드 딥링크 콜백 (SDK 3.2+: 앱 진입 시 매번 1회 호출)
// - 첫 실행: /v1/open 매칭 결과를 5초 안에 전달 (timeout/실패 시 error)
// - 비첫 실행: 즉시 (null, null) — 네트워크 호출 X (organic과 동일 의미)
ViaLinkSDK.shared.onDeferredDeepLink((data, error) => {
  if (error) {
    console.warn('디퍼드 매칭 실패:', error.code);
    return;
  }
  if (!data) {
    console.log('organic 또는 비첫 실행 — 일반 진입');
    return;
  }
  navigation.navigate(data.path, data.params);
});

// 구매 완료
ViaLinkSDK.shared.track('purchase', {
  product_id: '12345',
  revenue: 29900,
  currency: 'KRW'
});

// 회원가입
ViaLinkSDK.shared.track('signup');

import { ViaLinkSDK } from 'vialink-react-native-sdk';

// 결제창 띄우기 직전:
try {
  const result = await ViaLinkSDK.shared.payment.initiated({
    orderId: 'ORD-2026-0001',
    amount: 19900,
    currency: 'KRW',
    paymentMethod: 'card',
  });
  console.log('payment_event_id=', result.paymentEventId);
} catch (e) {
  // 입력 검증 실패 또는 네트워크 오류
}

const shortUrl = await ViaLinkSDK.shared.createLink(
  '/product/12345',
  { promo_code: 'FRIEND_SHARE' },
  'referral',
  'dynamic', // 클릭 추적 필요 (생략 시 'static')
  {
    iosUrl: 'https://apps.apple.com/app/id123456',
    androidUrl: 'https://play.google.com/store/apps/details?id=com.example',
    webUrl: 'https://www.example.com/product/12345',
    ogTitle: '여름 세일 특가',
    ogImageUrl: 'https://cdn.example.com/promo.jpg',
    channel: 'sms',
    feature: 'product_share',
    tags: ['summer', 'sale'],
    expiresAt: '2026-12-31T23:59:59Z',
  }
);

await Share.share({ message: shortUrl });

// app.json (Expo)
{
  "expo": {
    "ios": {
      "associatedDomains": ["applinks:vialink.app"]
    },
    "android": {
      "intentFilters": [{
        "action": "VIEW",
        "autoVerify": true,
        "data": [{
          "scheme": "https",
          "host": "vialink.app",
          "pathPrefix": "/{your-slug}/"
        }],
        "category": ["BROWSABLE", "DEFAULT"]
      }]
    }
  }
}

Window > Package Manager > + > Add package from git URL:
https://github.com/aresjoydev/vialink-unity-sdk.git

using ViaLink;

public class GameManager : MonoBehaviour
{
    void Start()
    {
        ViaLinkSDK.Instance.Initialize("YOUR_API_KEY");
    }
}

// 딥링크 콜백 (SDK 3.1+: 일반 진입에서도 호출 — data == null로 전달)
ViaLinkSDK.Instance.OnDeepLink += (data) =>
{
    if (data == null)
    {
        Debug.Log("일반 진입 — 기본 화면 유지");
        return;
    }
    Debug.Log($"경로: {data.Path}");
    Debug.Log($"파라미터: {data.Params}");
    SceneManager.LoadScene(data.Path);
};

// 디퍼드 딥링크 콜백 (SDK 3.2+: 앱 진입 시 매번 1회 발생)
// - 첫 실행: /v1/open 매칭 결과를 5초 안에 전달 (timeout/실패 시 error)
// - 비첫 실행: 즉시 (null, null) — 네트워크 호출 X (organic과 동일 의미)
ViaLinkSDK.Instance.OnDeferredDeepLink += (data, error) =>
{
    if (error != null)
    {
        Debug.LogWarning($"디퍼드 매칭 실패: {error.Code}");
        return;
    }
    if (data == null)
    {
        Debug.Log("organic 또는 비첫 실행 — 일반 진입");
        return;
    }
    Debug.Log($"디퍼드 딥링크: {data.Path}");
    SceneManager.LoadScene(data.Path);
};

// 인앱 구매
ViaLinkSDK.Instance.TrackEvent("purchase",
    new Dictionary<string, object>
    {
        { "product_id", "gem_pack_100" },
        { "revenue", 4900 },
        { "currency", "KRW" }
    });

// 레벨 클리어
ViaLinkSDK.Instance.TrackEvent("level_clear",
    new Dictionary<string, object>
    {
        { "level", 10 }
    });

using ViaLink.SDK;

// 결제창 띄우기 직전 (MonoBehaviour 안에서)
ViaLinkSDK.Payment.Initiated(
    new PaymentInitiatedArgs {
        OrderId = "ORD-2026-0001",
        Amount = 19900,
        Currency = "KRW",
        PaymentMethod = "card",
    },
    onSuccess: (result) => {
        Debug.Log($"payment_event_id={result.PaymentEventId}");
    },
    onError: (error) => {
        Debug.LogError($"결제 시도 실패: {error}");
    }
);

ViaLinkSDK.Instance.CreateLink(
    path: "/invite",
    data: new Dictionary<string, object>
    {
        { "inviter_id", PlayerId },
        { "reward", "gem_50" }
    },
    campaign: "friend_invite",
    linkType: "dynamic", // 클릭 추적 필요 (생략 시 "static")
    iosUrl: "https://apps.apple.com/app/id123456",
    androidUrl: "https://play.google.com/store/apps/details?id=com.example",
    webUrl: "https://www.example.com/invite",
    ogTitle: "친구 초대 — 보상 받기",
    ogImageUrl: "https://cdn.example.com/invite.jpg",
    channel: "in_game",
    feature: "friend_invite",
    tags: new List<string> { "invite", "viral" },
    expiresAt: "2026-12-31T23:59:59Z",
    onSuccess: (shortUrl) =>
    {
        // shortUrl: "https://vialink.app/{your-slug}/xYz12"
        GUIUtility.systemCopyBuffer = shortUrl;
        ShowToast("초대 링크가 복사되었습니다!");
    },
    onError: (error) =>
    {
        Debug.LogError($"링크 생성 실패: {error}");
    }
);

flutter pub add vialink_flutter_plugin

import 'package:vialink_flutter_plugin/vialink_flutter_plugin.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await ViaLinkSDK.instance.configure(apiKey: 'YOUR_API_KEY');

  runApp(const MyApp());
}

// 딥링크 콜백 (SDK 3.1+: (DeepLinkData?) -> void)
// 진입 알림 시 항상 1회 호출:
//   - data != null : App Links / Universal Links 진입 → data.path로 라우팅
//   - data == null : 일반 진입(아이콘 탭 등) → 기본 라우트 유지
ViaLinkSDK.instance.onDeepLink((data) {
  if (data == null) {
    print('일반 진입 — 기본 라우트 유지');
    return;
  }
  print('경로: ${data.path}');
  print('파라미터: ${data.params}');
  Navigator.pushNamed(context, data.path,
      arguments: data.params);
});

// 디퍼드 딥링크 콜백 (SDK 3.2+: 앱 진입 시 매번 1회 호출)
// - 첫 실행: /v1/open 매칭 결과를 5초 안에 전달 (timeout/실패 시 error)
// - 비첫 실행: 즉시 (null, null) — 네트워크 호출 X (organic과 동일 의미)
ViaLinkSDK.instance.onDeferredDeepLink((data, error) {
  if (error != null) {
    debugPrint('디퍼드 매칭 실패: ${error.code}');
    return;
  }
  if (data == null) {
    debugPrint('organic 또는 비첫 실행 — 일반 진입');
    return;
  }
  Navigator.pushNamed(context, data.path, arguments: data.params);
});

// 구매 완료
ViaLinkSDK.instance.track('purchase', data: {
  'product_id': '12345',
  'revenue': 29900,
  'currency': 'KRW',
});

// 회원가입
ViaLinkSDK.instance.track('signup');

import 'package:vialink_flutter_plugin/vialink_flutter_plugin.dart';

// 결제창 띄우기 직전:
try {
  final result = await ViaLinkSDK.instance.payment.initiated(
    PaymentInitiatedArgs(
      orderId: 'ORD-2026-0001',
      amount: 19900,
      currency: 'KRW',
      paymentMethod: 'card',
      metadata: {'productId': 'prod-001'},
    ),
  );
  print('payment_event_id=${result.paymentEventId}');
} on ArgumentError catch (e) {
  // 입력 검증 실패
  print(e);
} catch (e) {
  // PlatformException 또는 기타 오류
}

final shortUrl = await ViaLinkSDK.instance.createLink(
  path: '/product/12345',
  data: {'promo_code': 'FRIEND_SHARE'},
  campaign: 'referral',
  linkType: 'dynamic', // 클릭 추적 필요 (생략 시 'static')
  iosUrl: 'https://apps.apple.com/app/id123456',
  androidUrl: 'https://play.google.com/store/apps/details?id=com.example',
  webUrl: 'https://www.example.com/product/12345',
  ogTitle: '여름 세일 특가',
  ogDescription: '지금 확인하세요!',
  ogImageUrl: 'https://cdn.example.com/promo.jpg',
  channel: 'email',
  feature: 'product_share',
  tags: ['summer', 'sale'],
  expiresAt: '2026-12-31T23:59:59Z',
);
// shortUrl: "https://vialink.app/{your-slug}/xYz12"

await Share.share(shortUrl);

# iOS: ios/Runner/Runner.entitlements
# Associated Domains 추가:
#   applinks:vialink.app

# Android: android/app/src/main/AndroidManifest.xml
# <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="vialink.app"
#     android:pathPrefix="/{your-slug}/" />
# </intent-filter>