غیرفعال یا فعال کردن SDK
به طور پیش‌فرض، Adtrace SDK هنگامی که اپ باز است اجرا می‌شود. می‌توانید SDK را غیرفعال و مجدداً فعال کنید تا ردیابی را متوقف و از سر بگیرید. وقتی SDK غیرفعال است، هیچ داده‌ای به سرورهای ادتریس ارسال نمی‌کند.
setEnabled را فقط بعد از اولین Session می‌توانید فراخوانی کنید. این تنظیم بین Session ها باقی می‌ماند. اگر SDK را غیرفعال کنید، تا زمانی که دوباره فعال نکنید غیرفعال می‌ماند.
فراخوانی setEnabled قبل از appDidLaunch نادیده گرفته می‌شود. ابتدا SDK را مقداردهی اولیه کنید، سپس ردیابی را تغییر دهید.
برخلاف حالت آفلاین، غیرفعال کردن SDK ردیابی را کاملاً متوقف می‌کند. در حالی که SDK غیرفعال است هیچ داده‌ای ثبت نمی‌شود.
| غیرفعال کردن SDK | حالت آفلاین | |
|---|---|---|
| ثبت داده | کاملاً متوقف می‌شود | به صورت محلی ادامه می‌یابد |
| ارسال شبکه | معلق می‌شود | معلق می‌شود |
| بین Session ها باقی می‌ماند | بله، تا زمان فعال‌سازی مجدد غیرفعال می‌ماند | خیر، هر بار راه‌اندازی آنلاین شروع می‌شود |
| هنگام فعال‌سازی مجدد | دوره غیرفعال را replay نمی‌کند | داده‌های در صف را با timestamp های صحیح ارسال می‌کند |
Method signature
+ (void)setEnabled:(BOOL)enabled;
| پارامتر | نوع | توضیح |
|---|---|---|
enabled | BOOL | برای فعال کردن SDK YES / true تنظیم کنید. برای غیرفعال کردن SDK NO / false تنظیم کنید. |
غیرفعال کردن SDK
setEnabled را با NO / false روی Adtrace فراخوانی کنید تا ردیابی روی دستگاه جاری متوقف شود.
- Objective-C
- Swift
- Javascript
[Adtrace setEnabled:NO];
Adtrace.setEnabled(false)
Adtrace.setEnabled(false);
فعال کردن SDK
setEnabled را با YES / true فراخوانی کنید تا ردیابی از سر گرفته شود.
- Objective-C
- Swift
- Javascript
[Adtrace setEnabled:YES];
Adtrace.setEnabled(true)
Adtrace.setEnabled(true);
بررسی فعال بودن SDK
isEnabled را فراخوانی کنید تا ببینید SDK در حال حاضر فعال است یا خیر.
Method signature
+ (BOOL)isEnabled;
وقتی SDK فعال است YES / true و وقتی غیرفعال است NO / false برمی‌گرداند.
مثال
- Objective-C
- Swift
- Javascript
BOOL enabled = [Adtrace isEnabled];
let enabled = Adtrace.isEnabled()
let enabled = Adtrace.isEnabled();