منصوبے کے بارے میں

# TelemetryDeck Kotlin SDK ایک Kotlin لائبریری جو Android ایپلیکیشنز سے [TelemetryDeck](https://telemetrydeck.com) تک تجزیاتی سگنل بھیجنے کے لیے ہے، جو پرائیویسی پر مبنی تجزیاتی پلیٹ فارم ہے۔ SDK Android API 23+ اور Kotlin 2.3.x پر چلتا ہے۔ ## بنیادی صلاحیتیں **سگنل بھیجنا** — فوری طور پر تجزیاتی سگنل فائر کرنے کے لیے `TelemetryDeck.send("eventName")` کال کریں، یا بعد میں منتقلی کے لیے قطار میں ڈالنے کے لیے `TelemetryDeck.signal("eventName")` استعمال کریں۔ **سیشن ٹریکنگ** — خود بخود نئی انسٹالز کا پتہ لگاتا ہے، سیشن کا دورانیہ ناپتا ہے، اور برقراری میٹرکس (اوسط سیشن سیکنڈز، استعمال شدہ الگ دن، کل سیشن شمار) کا حساب لگاتا ہے۔ سیشن کی حالت ڈیوائس پر مقامی طور پر محفوظ ہوتی ہے اور ان انسٹال پر صاف ہو جاتی ہے۔ **صارف کی شناخت** — بطور ڈیفالٹ ڈیوائس کے دائرے میں ایک گمنام شناخت کنندہ تیار کرتا ہے۔ `defaultUser` کے ذریعے حسب ضرورت صارف شناخت کنندگان کی حمایت کرتا ہے (بھیجنے سے پہلے ہیش کیا جاتا ہے) یا حسب ضرورت `TelemetryDeckIdentityProvider` نفاذ۔ **ماحولیاتی پیرامیٹرز** — ہر سگنل کو خود بخود ڈیوائس میٹا ڈیٹا (ماڈل، OS، اسکرین ریزولوشن، واقفیت، فن تعمیر، برانڈ، ٹائم زون)، ایپ میٹا ڈیٹا (ورژن، بلڈ نمبر)، اور SDK میٹا ڈیٹا سے افزودہ کرتا ہے۔ نیز رسائی کی ترتیبات (فونٹ اسکیل iOS سائز کیٹیگریز سے منسلک، بولڈ ٹیکسٹ، رنگ الٹنا، موشن کم کریں، ڈارک/لائٹ اسکیم) حاصل کرتا ہے۔ **نیویگیشن سگنلز** — اسکرینوں کے درمیان صارف کے بہاؤ کو ٹریک کریں `TelemetryDeck.navigate(source, destination)` کے ساتھ، یا ہر راستے کی تبدیلی پر اسے کال کریں خودکار روٹ ٹریکنگ کے لیے۔ **دورانیہ ٹریکنگ** — نامزد دورانیہ سگنلز شروع اور روکیں (`startDurationSignal` / `stopAndSendDurationSignal`) مخصوص واقعات جیسے وزرڈ مراحل پر صرف ہونے والے وقت کی پیمائش کے لیے۔ **حصول میں مدد** — `acquiredUser(channel)`، `leadStarted(leadId)`، اور `leadConverted(leadId)` کے لیے سہولتی طریقے۔ **کیلنڈر پیرامیٹرز** — ہر بھیجے جانے والے سگنل میں ہفتے کا دن، مہینے کا دن، سال کا ہفتہ، سہ ماہی، دن کا گھنٹہ، ویک اینڈ فلیگ، اور مزید شامل کرتا ہے۔ **خریداری ٹریکنگ** — `purchaseCompleted()` مارکیٹ پلیس ملکی کوڈ اور پروڈکٹ ID کے ساتھ ایپ میں خریداریاں ریکارڈ کرتا ہے۔ **صرف میموری میں موڈ** — بلڈر پر `inMemoryOnly(true)` کال کریں تاکہ ڈسک پر لکھے بغیر چلے، سینڈ باکسڈ پروسیسز کے لیے موزوں۔ صارف کی شناخت ہر لانچ پر دوبارہ تیار ہوتی ہے؛ اس موڈ میں نئی انسٹال کا پتہ لگانا اور برقراری میٹرکس دستیاب نہیں ہیں۔ ## انسٹالیشن `build.gradle` میں شامل کریں: ```groovy implementation 'com.telemetrydeck:kotlin-sdk:7.2.0' ``` `AndroidManifest.xml` میں انٹرنیٹ کی اجازت شامل کریں: ```xml <uses-permission android:name="android.permission.INTERNET" /> ``` مینی فیسٹ میٹا ڈیٹا یا پروگرامیٹک بلڈر کے ذریعے ترتیب دیں: ```kotlin val builder = TelemetryDeck.Builder() .appID("YOUR-APP-ID") .showDebugLogs(true) .defaultUser("anonymous-user") TelemetryDeck.start(applicationContext, builder) ``` ## پرووائیڈرز اور حسب ضرورت SDK ایک پرووائیڈر پلگ ان سسٹم استعمال کرتا ہے۔ بلٹ ان پرووائیڈرز میں `EnvironmentParameterProvider`، `PlatformContextProvider`، `AccessibilityProvider`، `SessionTrackingSignalProvider`، اور `CalendarParameterProvider` شامل ہیں۔ حسب ضرورت افزودگی `DefaultParameterProvider`، `DefaultPrefixProvider`، یا `TelemetryDeckIdentityProvider`، `TelemetryDeckSessionManagerProvider`، اور حسب ضرورت بیک اینڈز کے لیے `TelemetryDeckStorage` کو لاگو کرکے شامل کی جا سکتی ہے۔