SDK ์ฐ๋
Hackle iOS SDK ๋ iOS 10 ์ด์์ ์ง์ํฉ๋๋ค.
์์กด์ฑ ์ถ๊ฐ
Hackle iOS SDK๋ Swift Package Manager์ CocoaPods๋ฅผ ์ง์ํฉ๋๋ค.
// ...
dependencies: [
.package(url: "https://github.com/hackle-io/hackle-ios-sdk.git", from: "2.58.0")
],
targets: [
.target(
name: "YOUR_TARGET",
dependencies: ["Hackle"]
)
],
// ...pod 'Hackle', '2.58.0'SDK ์ด๊ธฐํ
SDK๋ฅผ ์ฌ์ฉํ๊ธฐ ์ํด์ ๋ฐ๋์ HackleApp์ ์ด๊ธฐํ ํด์ผ ํฉ๋๋ค. HackleApp์ ์ด๊ธฐํ ํ๊ธฐ ์ํด SDK ํค๊ฐ ํ์ํฉ๋๋ค.
HackleApp์ SDK์ ๊ธฐ๋ฅ์ ์ฌ์ฉํ๊ธฐ ์ํ ๋ฉ์๋๋ค์ ์ ๊ณตํ๋ ํด๋์ค์ ๋๋ค.- SDK ํค๋ ํตํด ์๋น์ค์ ๋์๋ณด๋ ์์ ์์นํ SDK ์ฐ๋ ์ ๋ณด์์ ํ์ธํ์ค ์ ์์ต๋๋ค.
์ด๊ธฐํ ์ ํตํด ์๋ฒ๋ก๋ถํฐ ํ์ํ ์ ๋ณด๋ค์ ๊ฐ์ ธ์์ SDK์ ์ ์ฅํฉ๋๋ค.
์ด๊ธฐํ๋ ๋น๋๊ธฐ๋ก ์คํ๋๋ฉฐ, ์ด๊ธฐํ ์ ๋ง์ง๋ง ํ๋ผ๋ฏธํฐ๋ก ์ฝ๋ฐฑ์ ์ ๋ฌํ๋ฉด SDK ์ฌ์ฉ ์ค๋น๊ฐ ์๋ฃ๋ ๊ฒ์ ์ ์ ์์ต๋๋ค.
์ด๊ธฐํ๊ฐ ์๋ฃ ๋๊ธฐ ์ ์ A/B ํ ์คํธ, ๊ธฐ๋ฅ ํ๋๊ทธ๋ฅผ ํธ์ถํ๋ฉด ๊ธฐ๋ณธ ๊ทธ๋ฃน(A), ๊บผ์ง(false)์ ๋ฆฌํดํฉ๋๋ค.
import Hackle
Hackle.initialize(sdkKey: YOUR_APP_SDK_KEY) {
// SDK ready to use.
}@import Hackle;
[Hackle initializeWithSdkKey:@"YOUR_APP_SDK_KEY" config:[HackleConfig DEFAULT] completion:^{
// SDK ready to use.
}];๊ถ์ฅ ์ด๊ธฐํ ์ ๋ต: ๋ก๋ฉ ํ๋ฉด์ ํตํ ์ด๊ธฐํ
์ฑ์ ์ฆ์ ์์ํ์ง ์๊ณ ์คํ๋ ์ ํ๋ฉด์ ํ์ํ๊ณ SDK๋ฅผ ์ด๊ธฐํํฉ๋๋ค.
์ดํ ์ฝ๋ฐฑ์ ํตํด ์คํ๋ ์ ํ๋ฉด์ ๋ซ๊ณ ์ฌ์ฉ์๊ฐ ์ฑ๊ณผ ์ํธ์์ฉ์ ์์ํ ์ ์๋๋ก ํฉ๋๋ค.
์ด๊ธฐํ ์ ์ฌ์ฉ์ ์ฃผ์
์ ์ ์ ๋ณด๋ฅผ ํฌํจํ์ฌ SDK๋ฅผ ์ด๊ธฐํ ํ ์ ์์ต๋๋ค.
- ์ ์ ์ ๋ณด๋ฅผ ํฌํจํ์ง ์์ผ๋ฉด ๋ก์ปฌ ์คํ ๋ฆฌ์ง์ ์ ์ฅ๋ ์ ์ ์ ๋ณด๋ฅผ ์ฌ์ฉํฉ๋๋ค.
- ๋ก์ปฌ ์คํ ๋ฆฌ์ง์ ์ ์ฅ๋ ์ ์ ์ ๋ณด๊ฐ ์๋ ๊ฒฝ์ฐ Hackle Device ID๋ฅผ device id๋ก ๊ฐ์ง๊ณ ์ ์ ๋ฅผ ์ฌ์ฉํฉ๋๋ค.
์ ์ ์ ๋ณด๋ SDK ์ด๊ธฐํ ์ดํ์๋ ์ ์ ์ ๋ณด ์ค์ ํจ์๋ฅผ ํตํด ์์ ๋กญ๊ฒ ์์ ํ ์ ์์ต๋๋ค.
let user = User.builder()
.userId("142") // ์ฌ์ฉ์ ID
.deviceId("ae2182e0") // ๋๋ฐ์ด์ค ID
.build()
Hackle.initialize(sdkKey: YOUR_APP_SDK_KEY, user: user) {
// SDK ready to use.
}HackleUserBuilder *builder = [HackleUser builder];
[builder userId:@"142"]; // ์ฌ์ฉ์ ID
[builder deviceId:@"ae2182e0"]; // ๋๋ฐ์ด์ค ID
HackleUser *user = [builder build];
[Hackle initializeWithSdkKey:@"YOUR_APP_SDK_KEY" user:user completion:^{
// SDK ready to use.
}];์ด๊ธฐํ ์ค์ ์ ๋ณด
์ค์ ์ ๋ณด๋ฅผ ํฌํจํ์ฌ SDK๋ฅผ ์ด๊ธฐํ ํ ์ ์์ต๋๋ค
let config = HackleConfigBuilder()
.build()
Hackle.initialize(sdkKey: YOUR_APP_SDK_KEY, config: config) {
// SDK ready to use.
}HackleConfigBuilder *builder = [[HackleConfigBuilder alloc] init];
[builder exposureEventDedupIntervalSeconds:1];
HackleConfig *config = [builder build];
[Hackle initializeWithSdkKey:@"YOUR_APP_SDK_KEY" config:config completion:^{
// SDK ready to use.
}];์ค์ ์ต์
์ค์ | ๊ธฐ๋ฅ | ๊ธฐ๋ณธ๊ฐ | ์ง์ ๋ฒ์ |
|---|---|---|---|
exposureEventDedupIntervalSeconds | ๋์ผํ ์ฌ์ฉ์๊ฐ ์ฐ์์ผ๋ก ๋ฐ์์ํจ ๋์ผํ A/B ํ ์คํธ, ๊ธฐ๋ฅํ๋๊ทธ ๋ถ๋ฐฐ๊ฒฐ๊ณผ์ ๋ํ ๋ ธ์ถ ์ด๋ฒคํธ๋ฅผ ์ ๊ฑฐํฉ๋๋ค. ์ต์๊ฐ: 1 ์ต๋๊ฐ:
| 60 (1๋ถ) | 2.7.0+ (2.41.0 ์ดํ๋ถํฐ ์ฑ ์ข ๋ฃ ํ ์ฌ์์ ์์๋ ์ง์ํฉ๋๋ค.) |
eventFlushInterval | ์์ง๋ ์ด๋ฒคํธ๋ฅผ ์๋ฒ๋ก ์ ์กํ๋ ์ฃผ๊ธฐ์ ๋๋ค. ์ต์๊ฐ: 1 ์ต๋๊ฐ: 60 (1๋ถ) | 10 | 2.10.0+ |
sessionTimeoutIntervalSeconds | ์ธ์ ๋ง๋ฃ ์๊ฐ์ ์ค์ ํฉ๋๋ค. | 1800 (30๋ถ) | 2.13.0+ |
pollingIntervalSeconds | ๋์๋ณด๋์์ ์ค์ ํ ์ ๋ณด๋ฅผ ์ฃผ๊ธฐ์ ์ผ๋ก ์ ๋ฐ์ดํธ ํ ์ ์์ต๋๋ค. ์ต์๊ฐ : 60 (1๋ถ) | -1 (์ฃผ๊ธฐ์ ์ผ๋ก ์ ๋ฐ์ดํธํ์ง ์์) | 2.18.0+ |
automaticScreenTracking | ์๋ ํ๋ฉด ์ถ์ ํ์ฑํ ์ฌ๋ถ | true | 2.34.0+ |
์ธ์คํด์ค ๊ฐ์ ธ์ค๊ธฐ
์ด๊ธฐํ ์ดํ ์๋ ์ฝ๋๋ฅผ ํตํด HackleApp ์ธ์คํด์ค๋ฅผ ๊ฐ์ ธ์ฌ ์ ์์ต๋๋ค.
์ด๊ธฐํ ์ด์ ์ ํธ์ถํ๋ฉด nil์ ๋ฆฌํดํฉ๋๋ค. ์ด๊ธฐํ ์ดํ ํธ์ถํด์ผ ํฉ๋๋ค.
let hackleApp = Hackle.app()HackleApp *hackleApp = [Hackle app];๋์๋ณด๋ ์ค์ ์ ๋ณด ๊ฐฑ์
๋์๋ณด๋ ์ค์ ์ ๋ณด๋ฅผ ๋ช ์์ ์ผ๋ก ๊ฐฑ์ ํ ์ ์์ต๋๋ค.
ํด๋น ํจ์๋ 60์ด์ ํ๋ฒ ์ ํ์ ์ผ๋ก ํธ์ถํ ์ ์์ต๋๋ค.
hackleApp.fetch {
// done
}[hackleApp fetch:^{
// done
}];Updated 6 days ago
