پرش به مطلب اصلی
نسخه: 2.6.0

Push token

از push token ها برای Audience Builder و client callback ها استفاده می‌شود. همچنین برای ردیابی uninstall و reinstall ضروری هستند.

بعد از اینکه اپ شما برای remote notification ثبت‌نام کرد و توکن دستگاه APNs را دریافت کرد (و هر زمان که آن توکن تغییر کرد)، آن را با setDeviceToken: به ادتریس پاس دهید.

این متد را روی Adtrace بعد از شروع SDK فراخوانی کنید، معمولاً از application:didRegisterForRemoteNotificationsWithDeviceToken: در app delegate خود.

Method signature​

+ (void)setDeviceToken:(nonnull NSData *)deviceToken;
پارامترنوعتوضیح
deviceTokenNSDataتوکن دستگاه APNs از didRegisterForRemoteNotificationsWithDeviceToken. مقدار NSData را مستقیماً پاس دهید. آن را برای SDK native به string تبدیل نکنید.

تنظیم push token (SDK native)​

برای remote notification ثبت‌نام کنید، سپس وقتی iOS آن را تحویل داد توکن را به ادتریس ارسال کنید.

AppDelegate.m
- (void)application:(UIApplication *)application
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [Adtrace setDeviceToken:deviceToken];
}

مطمئن شوید اپ شما درخواست مجوز notification می‌کند و registerForRemoteNotifications را قبل از انتظار برای این callback فراخوانی می‌کند.

WebBridge / WebView SDK​

اگر از WebView دسترسی به push token دارید، در JavaScript فراخوانی کنید:

Adtrace.setPushToken('{YourPushToken}');

{YourPushToken} را با رشته توکن از native یا web push setup خود جایگزین کنید.

زمان فراخوانی​

setDeviceToken: را در این موارد فراخوانی کنید:

  1. وقتی iOS برای اولین بار توکن دستگاه را بعد از registerForRemoteNotifications تحویل می‌دهد
  2. هر زمان که Apple توکن را refresh کرده و didRegisterForRemoteNotificationsWithDeviceToken را مجدداً فراخوانی می‌کند

توکن را بعد از appDidLaunch ارسال کنید تا SDK در حین ثبت آن در حال اجرا باشد.