SDK ์ฐ๋
JavaScript SDK๋ IE11+ ๋ฐ ๋ชจ๋ ์ฃผ์ ๋ธ๋ผ์ฐ์ ๋ฅผ ์ง์ํฉ๋๋ค.
JavaScript SDK๋ฅผ ์ฌ์ฉํ๊ธฐ ์ํด์๋
Promise,MapAPI๊ฐ ํ์๋ก ์ง์๋์ด์ผ ํฉ๋๋ค.
ํด๋ฆฌํ์ด ํ์ํ๋ค๋ฉดcore-js๋ฅผ ์ด์ฉํ๋ ๊ฒ์ ์ถ์ฒํฉ๋๋ค.
์์กด์ฑ ์ถ๊ฐ
npm install --save @hackler/javascript-sdkyarn add @hackler/javascript-sdk<!-- HTML์ ๊ฒฝ์ฐ ์์กด์ฑ ์ถ๊ฐ ์์
์ด ํ์ํ์ง ์์ต๋๋ค -->SDK ์ด๊ธฐํ
SDK๋ฅผ ์ฌ์ฉํ๊ธฐ ์ํด์ ๋ฐ๋์ HackleClient ๋ฅผ ์ด๊ธฐํ ํด์ผ ํฉ๋๋ค. ์ธ์คํด์ค๋ฅผ ์ด๊ธฐํ ํ๊ธฐ ์ํด SDK ํค๊ฐ ํ์ํฉ๋๋ค.
HackleClient๋ SDK์ ๊ธฐ๋ฅ์ ์ฌ์ฉํ๊ธฐ ์ํ ๋ฉ์๋๋ค์ ์ ๊ณตํ๋ ํด๋์ค์ ๋๋ค.- SDK ํค๋ ํตํด ์๋น์ค์ ๋์๋ณด๋ ์์ ์์นํ SDK ์ฐ๋ ์ ๋ณด์์ ํ์ธํ์ค ์ ์์ต๋๋ค.
import * as Hackle from "@hackler/javascript-sdk";
// YOUR_BROWSER_SDK_KEY๋ก ์ด๊ธฐํ
const hackleClient = Hackle.createInstance("YOUR_BROWSER_SDK_KEY");<!-- ๊ธฐ์กด ์ฝ๋ head ์์ ์ถ๊ฐ -->
<script src="https://cdn2.hackle.io/npm/@hackler/[email protected]/lib/index.browser.umd.min.js"></script>
<script>
// YOUR_BROWSER_SDK_KEY๋ก ์ด๊ธฐํ
window.hackleClient = Hackle.createInstance("YOUR_BROWSER_SDK_KEY");
</script>์ด๊ธฐํ ์๋ฃ
์ด๊ธฐํ ์ ํตํด ์๋ฒ๋ก๋ถํฐ ํ์ํ ์ ๋ณด๋ค์ ๊ฐ์ ธ์์ SDK์ ์ ์ฅํฉ๋๋ค.
์ด๊ธฐํ๋ ๋น๋๊ธฐ๋ก ์คํ๋๋ฉฐ, await์ผ๋ก ์ด๊ธฐํ ์๋ฃ ์ ๊น์ง ๋๊ธฐํ ์ ์์ต๋๋ค.
์ด๊ธฐํ๊ฐ ์๋ฃ ๋๊ธฐ ์ ์ A/B ํ ์คํธ, ๊ธฐ๋ฅ ํ๋๊ทธ๋ฅผ ํธ์ถํ๋ฉด ๊ธฐ๋ณธ ๊ทธ๋ฃน(A), ๊บผ์ง(false)์ ๋ฆฌํดํฉ๋๋ค.
async function initHackle(){
await hackleClient.onInitialized();
// SDK ready to use
}
// deprecated
hackleClient.onReady(() => {
// SDK ready to use
});์ด๊ธฐํ ์ค์ ์ ๋ณด
์ค์ ์ ๋ณด๋ฅผ ํฌํจํ์ฌ SDK๋ฅผ ์ด๊ธฐํ ํ ์ ์์ต๋๋ค.
const config = {
debug: true
};
const hackleClient = Hackle.createInstance("YOUR_BROWSER_SDK_KEY", config);์ค์ ์ต์
ํค | ๊ธฐ๋ฅ | ๊ธฐ๋ณธ๊ฐ | ์ง์ ๋ฒ์ |
|---|---|---|---|
debug | ๋ชจ๋ ๊ธฐ๋ฅ์ ๋ํ ๋ก๊ทธ๋ฅผ ์ฝ์์ ์ถ๋ ฅํฉ๋๋ค. | false | 1.0.0+ |
pollingIntervalMillis | ๋์๋ณด๋์์ ์ค์ ํ ์ ๋ณด๋ฅผ ์ฃผ๊ธฐ์ ์ผ๋ก ์ ๋ฐ์ดํธ ํ ์ ์์ต๋๋ค. ์ต์๊ฐ : 60000 (60์ด) | -1 (์ฃผ๊ธฐ์ ์ผ๋ก ์ ๋ฐ์ดํธํ์ง ์์) | 11.1.0+ |
exposureEventDedupIntervalMillis | ๋์ผํ ์ฌ์ฉ์๊ฐ ์ฐ์์ผ๋ก ๋ฐ์์ํจ ๋์ผํ A/B ํ ์คํธ, ๊ธฐ๋ฅํ๋๊ทธ ๋ถ๋ฐฐ๊ฒฐ๊ณผ์ ๋ํ ๋ ธ์ถ ์ด๋ฒคํธ๋ฅผ ์ ๊ฑฐํฉ๋๋ค. ์ต์๊ฐ: 1000 (1์ด) ์ต๋๊ฐ: 3600000 (1์๊ฐ) | 36000 (1๋ถ / 11.23.0 ์ด์) -1 (์ค๋ณต์ ๊ฑฐ ํ์ง ์์ / 11.23.0 ๋ฏธ๋ง) | 11.1.0+ |
sessionTimeoutMillis | ์ธ์ ๋ง๋ฃ ์๊ฐ์ ์ค์ ํฉ๋๋ค. | 1800000 (30๋ถ) | 11.8.0+ |
devTool | ์ฌ์ฉ์ ํ์์ ์ฌ์ฉํ ์ ์๋๋ก ํฉ๋๋ค. | undefined | 11.13.0+ |
autoOpenDevTool | ์ฌ์ฉ์ ํ์ ๋ฒํผ์ด ์๋์ผ๋ก ๋ํ๋๋๋ก ํ๋ ์ต์ ์ ๋๋ค. | false | 11.13.0+ |
sameSiteCookie | ํตํด ์ฟ ํค์ sameSite ํ๋๊ทธ๋ฅผ ์ค์ ํ๊ณ ์ฟ ํค ๊ฐ์ธ์ ๋ณด ๋ณดํธ ์ ์ฑ ์ ๊ฒฐ์ ํฉ๋๋ค. | Lax | 11.20.0+ |
secureCookie | true ๋ก ์ค์ ํ์๋ฉด ํตํด ์ฟ ํค์ Secure ํ๋๊ทธ๋ฅผ ์ค์ ํฉ๋๋ค. | false | 11.20.0+ |
user | ์ด๊ธฐํ ์์ ์ ์ฌ์ฉ์๋ฅผ ์ฃผ์ ํฉ๋๋ค. | undefined | 11.22.3+ |
์ด๊ธฐํ ์ ์ฌ์ฉ์ ์ฃผ์
config์ user๋ฅผ ์ค์ ํ ๊ฒฝ์ฐ ์ ์ ์ ๋ณด๋ฅผ ํฌํจํ์ฌ SDK๋ฅผ ์ด๊ธฐํ ํ ์ ์์ต๋๋ค.
- ์ ์ ์ ๋ณด๋ฅผ ํฌํจํ์ง ์์ผ๋ฉด ์ฟ ํค์ ์ ์ฅ๋ ์ ์ ์ ๋ณด๋ฅผ ์ฌ์ฉํฉ๋๋ค.
- ์ฟ ํค์ ์ ์ฅ๋ ์ ์ ์ ๋ณด๊ฐ ์๋ ๊ฒฝ์ฐ Hackle Device ID๋ฅผ device id๋ก ๊ฐ์ง๊ณ ์ ์ ๋ฅผ ์ฌ์ฉํฉ๋๋ค.
์ ์ ์ ๋ณด๋ SDK ์ด๊ธฐํ ์ดํ์๋ ์ ์ ์ ๋ณด ์ค์ ํจ์๋ฅผ ํตํด ์์ ๋กญ๊ฒ ์์ ํ ์ ์์ต๋๋ค.
const user = {
userId: "LOGIN_ID",
deviceId: "CUSTOM_DEVICE_ID"
};
const config = {
user: user
};
const hackleClient = Hackle.createInstance("YOUR_BROWSER_SDK_KEY", config);๋์๋ณด๋ ์ค์ ์ ๋ณด ๊ฐฑ์
๋์๋ณด๋ ์ค์ ์ ๋ณด๋ฅผ ๋ช ์์ ์ผ๋ก ๊ฐฑ์ ํ ์ ์์ต๋๋ค.
ํด๋น ํจ์๋ 60์ด์ ํ๋ฒ ์ ํ์ ์ผ๋ก ํธ์ถํ ์ ์์ต๋๋ค.
hackleClient.fetch();Updated 8 days ago
