شناسه دستگاه خارجی
شناسه دستگاه خارجی یک مقدار سفارشی است که شما به یک دستگاه یا کاربر اختصاص می‌دهید. از آن برای موارد زیر استفاده کنید:
- شناختن کاربر یکسان در Session ها و پلتفرم‌های مختلف
- Deduplication install ها تا یک کاربر به عنوان چند install جدید شمرده نشود
- حفظ پیوستگی با شناسه‌هایی که از قبل در سیستم‌های دیگر استفاده می‌کنید
شناسه دستگاه خارجی را روی instance ADTConfig خود قبل از فراخوانی [Adtrace appDidLaunch:] / Adtrace.appDidLaunch(...) تنظیم کنید. بعد از شروع SDK نمی‌توانید آن را تغییر دهید.
پشتیبانی از شناسه دستگاه خارجی در پنل ادتریس ممکن است محدود باشد. قبل از اتکا به آن در گزارش‌های production، با تیم ادتریس تأیید کنید.
Method signature
- (void)setExternalDeviceId:(NSString *)externalDeviceId;
همچنین می‌توانید property externalDeviceId را مستقیماً روی ADTConfig تنظیم کنید.
| پارامتر | نوع | توضیح |
|---|---|---|
externalDeviceId | NSString | شناسه سفارشی دستگاه یا کاربر شما. این مقدار case-sensitive است. اگر شناسه‌های دستگاه خارجی import کرده‌اید، مقداری که پاس می‌دهید باید دقیقاً با مقدار import شده مطابقت داشته باشد. |
تنظیم شناسه دستگاه خارجی
setExternalDeviceId: را روی instance ADTConfig خود با شناسه خود فراخوانی کنید. برای نحوه ایجاد config، به پیکربندی مراجعه کنید.
مثال
- Objective-C
- Swift
- Javascript
[adtraceConfig setExternalDeviceId:@"YourExternalDeviceId"];
یا property را مستقیم تنظیم کنید:
adtraceConfig.externalDeviceId = @"YourExternalDeviceId";
adtraceConfig?.externalDeviceId = "YourExternalDeviceId"
adtraceConfig.setExternalDeviceId('YourExternalDeviceId');
اگر به این مقدار در callback ها یا export ها هم نیاز دارید، می‌توانید آن را به عنوان یک پارامتر callback Session پاس دهید.