پرش به مطلب اصلی

غیرفعال یا فعال کردن SDK

به طور پیش‌فرض، Adtrace SDK هنگامی که اپ باز است اجرا می‌شود. می‌توانید SDK را غیرفعال و مجدداً فعال کنید تا ردیابی را متوقف و از سر بگیرید. وقتی SDK غیرفعال است، هیچ داده‌ای به سرورهای ادتریس ارسال نمی‌کند.

مهم

setEnabled را فقط بعد از اولین Session می‌توانید فراخوانی کنید. این تنظیم بین Session ها باقی می‌ماند. اگر SDK را غیرفعال کنید، تا زمانی که دوباره فعال نکنید غیرفعال می‌ماند.

فراخوانی setEnabled قبل از appDidLaunch نادیده گرفته می‌شود. ابتدا SDK را مقداردهی اولیه کنید، سپس ردیابی را تغییر دهید.

برخلاف حالت آفلاین، غیرفعال کردن SDK ردیابی را کاملاً متوقف می‌کند. در حالی که SDK غیرفعال است هیچ داده‌ای ثبت نمی‌شود.

غیرفعال کردن SDKحالت آفلاین
ثبت دادهکاملاً متوقف می‌شودبه صورت محلی ادامه می‌یابد
ارسال شبکهمعلق می‌شودمعلق می‌شود
بین Session ها باقی می‌ماندبله، تا زمان فعال‌سازی مجدد غیرفعال می‌ماندخیر، هر بار راه‌اندازی آنلاین شروع می‌شود
هنگام فعال‌سازی مجدددوره غیرفعال را replay نمی‌کندداده‌های در صف را با timestamp های صحیح ارسال می‌کند

Method signature

+ (void)setEnabled:(BOOL)enabled;
پارامترنوعتوضیح
enabledBOOLبرای فعال کردن SDK YES / true تنظیم کنید. برای غیرفعال کردن SDK NO / false تنظیم کنید.

غیرفعال کردن SDK

setEnabled را با NO / false روی Adtrace فراخوانی کنید تا ردیابی روی دستگاه جاری متوقف شود.

[Adtrace setEnabled:NO];

فعال کردن SDK

setEnabled را با YES / true فراخوانی کنید تا ردیابی از سر گرفته شود.

[Adtrace setEnabled:YES];

بررسی فعال بودن SDK

isEnabled را فراخوانی کنید تا ببینید SDK در حال حاضر فعال است یا خیر.

Method signature

+ (BOOL)isEnabled;

وقتی SDK فعال است YES / true و وقتی غیرفعال است NO / false برمی‌گرداند.

مثال

BOOL enabled = [Adtrace isEnabled];