SauceLinkSDK는 iOS 앱에서 사용자 행동을 추적하고 SauceLink 서버로 이벤트 데이터를 전송하는 SDK입니다.
iOS 14.0+
Swift 5.5+
Xcode 13.0+
Xcode에서:
File > Add Package Dependencies... 선택
URL 입력: https://github.com/mobidoo-official/SauceLinkSDK-iOS.git
"Add Package" 클릭
Podfile에 다음을 추가하세요:
Note : Xcode 16 이상에서 빌드 에러 발생 시, Build Settings에서 ENABLE_USER_SCRIPT_SANDBOXING을 NO로 설정하세요.
다운로드 압축 해제
SauceLinkSDK.xcframework를 Xcode 프로젝트로 드래그Target > General > Frameworks, Libraries, and Embedded Content에서 "Embed & Sign" 선택
Application 시작 시 SDK를 초기화합니다.
Parameter Required Type Description partnerUniqueId True StringSauce로부터 발급받은 파트너 고유 ID sdkToken True StringSauce로부터 발급받은 파트너 SDK 토큰 environment False EnvironmentAPI 환경 설정 (.stage, .prod), 기본값: .prod completion False Result<Void, Error> -> Void초기화 결과 Callback
Swift
import SauceLinkSDK
@main
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
// Callback 미사용
SauceLink.shared.configure(
partnerUniqueId: "발급받은 파트너ID",
sdkToken: "sla_발급받은_SDK토큰"
)
// Callback 사용
SauceLink.shared.configure(
partnerUniqueId: "발급받은 파트너ID",
sdkToken: "sla_발급받은_SDK토큰",
environment: .prod
) { result in
switch result {
case .success:
print("SDK 초기화 성공")
case .failure(let error):
print("SDK 초기화 실패: \(error.localizedDescription)")
}
}
return true
}
}Swift
import SwiftUI
import SauceLinkSDK
@main
struct MyApp: App {
init() {
SauceLink.shared.configure(
partnerUniqueId: "발급받은 파트너ID",
sdkToken: "sla_발급받은_SDK토큰"
)
}
var body: some Scene {
WindowGroup {
ContentView()
}
}
}앱스킴으로 앱 진입 시 트래킹 링크 값을 SDK에 업데이트해야 합니다.
Parameter Required Type Description slink True String?앱스킴을 통해 전달된 slink 값 slinkT False String?sLink 만료 시간 (Unix Timestamp). nil일 경우 7일 후 자동 만료
Swift
import SauceLinkSDK
func application(_ app: UIApplication,
open url: URL,
options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
let components = URLComponents(url: url, resolvingAgainstBaseURL: false)
let slink = components?.queryItems?.first(where: { $0.name == "slink" })?.value
let slinkT = components?.queryItems?.first(where: { $0.name == "sLinkT" })?.value
SauceLink.shared.updateSlink(slink, slinkT)
return true
}Swift
import SauceLinkSDK
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
guard let url = URLContexts.first?.url else { return }
let components = URLComponents(url: url, resolvingAgainstBaseURL: false)
let slink = components?.queryItems?.first(where: { $0.name == "slink" })?.value
let slinkT = components?.queryItems?.first(where: { $0.name == "sLinkT" })?.value
SauceLink.shared.updateSlink(slink, slinkT)
}Swift
import SauceLinkSDK
@main
struct MyApp: App {
var body: some Scene {
WindowGroup {
ContentView()
.onOpenURL { url in
let components = URLComponents(url: url, resolvingAgainstBaseURL: false)
let slink = components?.queryItems?.first(where: { $0.name == "slink" })?.value
let slinkT = components?.queryItems?.first(where: { $0.name == "sLinkT" })?.value
SauceLink.shared.updateSlink(slink, slinkT)
}
}
}
}Parameter Required Type Description product_id True String상품 코드 product_name True String상품명 price True String상품 가격 discount_price True String상품 할인 가격
Parameter Required Type Description product_id True String상품 코드 product_name True String상품명 price True String상품 가격 discount_price True String상품 할인 가격 quantity True Int상품 수량
Parameter Required Type Description product True ProductDetailInfo상품 상세 정보 callback False Result<Void, Error> -> Void결과 Callback
Swift
import SauceLinkSDK
let product = ProductDetailInfo(
product_id: "prod-12345",
product_name: "플라스틱 해머",
price: "10000",
discount_price: "8500"
)
SauceLink.shared.trackProductDetail(product: product)Parameter Required Type Description orderId True String주문 번호 products True [OrderProductInfo]주문 상품 정보 리스트 callback False Result<Void, Error> -> Void결과 Callback
Swift
import SauceLinkSDK
let orderId = "order-67890"
let products = [
OrderProductInfo(
product_id: "prod-12345",
product_name: "플라스틱 해머",
price: "10000",
discount_price: "8500",
quantity: 1
),
OrderProductInfo(
product_id: "prod-67890",
product_name: "플라스틱 포크",
price: "5000",
discount_price: "4500",
quantity: 2
)
]
SauceLink.shared.trackOrderComplete(orderId: orderId, products: products)Parameter Required Type Description orderId True String주문 번호 products True [OrderProductInfo]주문 상품 정보 리스트 callback False Result<Void, Error> -> Void결과 Callback
Swift
import SauceLinkSDK
let orderId = "order-67890"
let products = [
OrderProductInfo(
product_id: "prod-12345",
product_name: "플라스틱 해머",
price: "10000",
discount_price: "8500",
quantity: 1
)
]
SauceLink.shared.trackOrderCancel(orderId: orderId, products: products)Parameter Required Type Description userData True UserData사용자 정보
Parameter Required Type Description userId False String?사용자 고유 ID
Swift
import SauceLinkSDK
let userData = UserData(userId: "user-12345")
SauceLink.shared.setUserData(userData)Parameter Required Type Description eventName True String이벤트 이름 properties False [String: Any]?이벤트 속성 completion False (Bool, Int?) -> Void결과 Callback (성공 여부, HTTP 상태 코드)
Swift
import SauceLinkSDK
SauceLink.shared.sendEvent("button_click", properties: [
"button_name": "purchase",
"screen": "product_detail"
]) { success, statusCode in
if success {
print("이벤트 전송 성공")
}
}Property Type Description isInitialized BoolSDK 초기화 완료 여부 isTokenValid Bool토큰 인증 성공 여부 lastAuthStatusCode Int마지막 인증 HTTP 상태 코드
Swift
import SauceLinkSDK
let status = SauceLink.shared.getAuthStatus()
print("초기화: \(status.isInitialized)")
print("토큰 유효: \(status.isTokenValid)")
print("상태코드: \(status.statusCode)")환경 용도 .stage스테이징 .prod프로덕션 (기본값)
SDK 사용 예제를 확인하려면 Example 앱을 실행하세요.
Bash
cd Example
pod install
open SauceLinkExample.xcworkspace
SDK 초기화 및 인증 테스트
상품 상세 / 주문 완료 / 주문 취소 이벤트 전송
딥링크 처리 (URL Scheme, Universal Link)
웹뷰 / 네이티브 모드 테스트
