دریافت اطلاعات دستگاه
Adtrace SDK متدهای کمکی را شامل می‌شود که شناسه‌های دستگاه را برمی‌گردانند. از این شناسه‌ها در callback ها، یکپارچه‌سازی‌های server-side یا mapping داخلی دستگاه استفاده کنید.
| متد | مقدار برگشتی | استفاده معمول |
|---|---|---|
adid | شناسه دستگاه ادتریس (adid) | mapping دستگاه بعد از install، placeholder های callback، testing console |
idfa | iOS Identifier for Advertisers (IDFA) | deduplication cross-service، placeholder های callback مانند {idfa} |
برای تنظیم یک شناسه دستگاه خارجی سفارشی قبل از init SDK، به تنظیم شناسه دستگاه خارجی مراجعه کنید. این صفحه خواندن adid و IDFA را پوشش می‌دهد.
شناسه دستگاه ادتریس
Method signature
+ (nullable NSString *)adid;
ادتریس یک شناسه دستگاه ادتریس یکتا (adid) برای هر دستگاه تولید می‌کند. adid را فراخوانی کنید تا این شناسه را به عنوان NSString برگرداند.
adid فقط بعد از اینکه ادتریس install اپ را ردیابی کرد در دسترس است. قبل از مقداردهی اولیه SDK و ردیابی موفق install نمی‌توانید آن را بخوانید.
مثال
- Objective-C
- Swift
- Javascript
NSString *adid = [Adtrace adid];
let adid = Adtrace.adid()
let adid = Adtrace.getAdid();
ID for Advertisers (IDFA)
Method signature
+ (nullable NSString *)idfa;
IDFA (Identifier for Advertisers) یک شناسه مخصوص دستگاه در دستگاه‌های Apple است. idfa را فراخوانی کنید تا این شناسه را به عنوان NSString برگرداند.
برخی سرویس‌های آنالیتیک نیاز دارند شناسه‌های دستگاه و client را برای جلوگیری از گزارش تکراری هماهنگ کنید. همچنین می‌توانید {idfa} را به عنوان placeholder پارامتر callback یا پارامتر callback Session پاس دهید.
در iOS 14+، IDFA فقط زمانی در دسترس است که کاربر ردیابی را مجاز کرده باشد. قبل از انتظار برای مقدار غیر nil، با App Tracking Transparency درخواست مجوز کنید. اگر کاربر ردیابی را رد کند یا هنوز prompt نشده باشد، idfa ممکن است nil برگرداند.
کاربران همچنین می‌توانند ad tracking را در تنظیمات سیستم محدود کنند. فرض نکنید IDFA همیشه موجود است.
مثال
- Objective-C
- Swift
- Javascript
NSString *idfa = [Adtrace idfa];
let idfa = Adtrace.idfa()
Adtrace.getIdfa(function(idfa) {
console.log('IDFA = ' + idfa);
});
در یکپارچه‌سازی‌های WebBridge، getIdfa asynchronous است و مقدار را در callback تحویل می‌دهد.