تأخیر در شروع SDK
تأخیر در شروع Adtrace SDK به اپ شما زمان میدهد تا پارامترهای Session (مانند شناسههای یکتا) را قبل از ارسال Session install بگیرد.
تأخیر اولیه را بر حسب ثانیه با setDelayStart: روی instance ADTConfig خود قبل از فراخوانی [Adtrace appDidLaunch:] / Adtrace.appDidLaunch(...) تنظیم کنید. برای نحوه ایجاد config، به پیکربندی مراجعه کنید.
Method signature
- (void)setDelayStart:(double)delayStart;
همچنین میتوانید property delayStart را مستقیماً روی ADTConfig تنظیم کنید.
| پارامتر | نوع | توضیح |
|---|---|---|
delayStart | double | تأخیر بر حسب ثانیه قبل از ارسال Session install اولیه توسط SDK. حداکثر مقدار پشتیبانی شده 10.0 ثانیه است. |
تنظیم تأخیر شروع
- Objective-C
- Swift
- Javascript
[adtraceConfig setDelayStart:5.5];
یا property را مستقیم تنظیم کنید:
adtraceConfig.delayStart = 5.5;
adtraceConfig?.delayStart = 5.5
adtraceConfig.setDelayStart(5.5);
با 5.5 ثانیه، Adtrace SDK Session install اولیه یا هیچ رویدادی که در این بازه ایجاد شده را ارسال نمیکند.
رفتار در طول تأخیر
| مرحله | رفتار SDK |
|---|---|
| در طول تأخیر | Session install اولیه و هر رویدادی که ایجاد میکنید نگه داشته میشوند. |
| بعد از پایان تأخیر | پارامترهای Session به Session install تأخیری و رویدادها ضمیمه میشوند، سپس SDK عملکرد عادی را از سر میگیرد. |
اگر sendFirstPackages را زودتر فراخوانی کنید | مانند زمانی که تایمر منقضی میشود: دادههای نگه داشته شده ارسال میشوند و SDK فوری از سر گرفته میشود. |
تأخیر شروع فقط در طول Session install (اولین مقداردهی اولیه SDK روی یک دستگاه) اعمال میشود، نه در هر بار باز شدن اپ.
ارسال زودتر از موعد
اگر پارامترهای Session شما قبل از پایان تأخیر آماده شدند، sendFirstPackages را فراخوانی کنید تا Session install و رویدادهای در صف را فوراً ارسال کنید.
Method signature
+ (void)sendFirstPackages;
مثال
- Objective-C
- Swift
- Javascript
[Adtrace sendFirstPackages];
Adtrace.sendFirstPackages()
Adtrace.sendFirstPackages();
حداکثر زمان تأخیر شروع برای Adtrace SDK ۱۰ ثانیه است.
زمان استفاده
تأخیر شروع را فقط زمانی استفاده کنید که باید پارامترهای Session ضروری را درست قبل از ارسال Session install جمعآوری کنید. تأخیر را تا حد ممکن کوتاه نگه دارید و به محض آماده شدن دادهها sendFirstPackages را فراخوانی کنید.
اگر پارامترهای Session قبل از راهاندازی در دسترس هستند، بهتر است آنها را با تنظیم پارامترهای callback Session قبل از appDidLaunch تنظیم کنید به جای delay کردن SDK.