شناسه‌ی یکتا کاربران

Android

اختصاص شناسه سفارشی به کاربران

شما می‌توانید به کاربران خود یک شناسه اختصاص دهید و از این شناسه برای ارسال اعلان تکی به کاربران استفاده کنید.

یکتا نگه داشتن شناسه‌هایی که به کاربران خود اختصاص می‌دهید بر عهده شماست. در صورتی که شناسه‌ای را به بیشتر از یک کاربر اختصاص دهید، موقع ارسال اعلان به آن شناسه همه کاربرانی که آن شناسه به آن‌ها اختصاص داده شده است اعلان را دریافت خواهند کرد.
در مواقعی ممکن است این رفتار مطلوب باشد، مثلا در صورتی که یک کاربر در چند دستگاه لاگین کرده باشد ولی در غیر این صورت توجه داشته باشید که یک شناسه را به بیش از یک کاربر اختصاص ندهید.

سه نوع شناسه قابل اختصاص دادن به کاربران وجود دارد که شما برحسب نیاز از یک یا تعدادی از آن‌ها می‌توانید استفاده کنید.

شناسه	توضیحات	نحوه اختصاص دادن
ایمیل	آدرس ایمیل کاربر	‌PusheUnity.SetUserEmail
شماره تلفن	شماره تلفن کاربر	‌PusheUnity.SetUserPhoneNumber
شناسه دلخواه	هر عبارت دلخواهی که می‌خواهید به عنوان شناسه استفاده کنید	‍PusheUnity.SetCustomId

متد PusheUnity.SetUserEmail

0.6.0

با استفاده از این متد می توانید ایمیل کاربر را به عنوان یک شناسه یکتا برای وی ذخیره کنید و با استفاده از آن اعلان یکتا برای این کاربر ارسال کنید.

var userEmail = "";
PusheUnity.SetUserEmail(userEmail);

نکته: برای حذف ایمیل از قبل ذخیره شده کاربر مقدار null را به عنوان پارامتر به این متد بدهید.

متد PusheUnity.SetUserPhoneNumber

0.6.0

با استفاده از این متد می توانید شماره کاربر را به عنوان شناسه یکتا برای وی‌ دخیره کنید و با استفاده از این شماره به این کاربر اعلان یکتا ارسال کنید.

var phoneNumber = "";
PusheUnity.SetUserPhoneNumber(phoneNumber);

متد PusheUnity.SetCustomId

0.6.0

با استفاده از این متد می توانید یک شناسه یکتا (می توانید از هر مقداری برای شناسه یکتا استفاده کنید فقط مقدار پارامتر باید از نوع string باشد) به کاربر اختصاص دهید تا با این شناسه به کاربر اعلان یکتا ارسال کنید.

const customId = "aCustomIdYouSetForUser";

PusheUnity.SetCustomId(customId);

نکته: برای حذف شناسه از پیش ذخیره شده مقدار null را به عنوان پارامتر به این متد بدهید.

دریافت شناسه یکتا کاربر

0.6.0

علاوه بر شناسه‌های معرفی شده‌ی بالا، دو شناسه دیگر به صورت خودکار به کاربران شما اختصاص داده می‌شود که با استفاده از آن‌ها نیز می‌توانید به کاربران خود اعلان ارسال کنید.

توضیحات این شناسه‌ها در جدول زیر آمده است:

شناسه	توضیحات	نحوه دریافت
DEVICE ID	این شناسه توسط اندروید به کاربران اختصاص داده می‌شود. در گوشی‌های با سیستم عامل پایین‌تر از اندروید ۸، شناسه‌ی Device ID کاربر بین تمامی اپلیکیشن‌های نصب شده بر روی گوشی ثابت است و همچنین پس از حذف و نصب مجدد اپلیکیشن نیز ثابت می‌ماند. در نسخه‌ی اندروید ۸ به بالا، شناسه‌ی Device ID یک کاربر تنها برای اپلیکیشن‌هایی که با کلید‌های یکسان امضا شده باشند یکتا است و برای بقیه‌ی اپلیکیشن‌ها متفاوت است.	‌PusheUnity.GetDeviceId
Advertising ID	این شناسه برای یکتاسازی دیوایس حتی در حالتی که برنامه‌ی شما حذف یا کلیردیتا شود استفاده می‌شود. این شناسه برای ماژول FCM برابر Google Ad id خواهد بود و برای ماژول HMS برابر Huawei OAID می‌باشد. کاربر می‌تواند این شناسه را حذف یا غیرفعال نماید	‌PusheUnity.getAdvertisingId

متد PusheUnity.GetAndroidId

0.6.0

var deviceId = PusheUnity.GetDeviceId();

var androidId = PusheUnity.GetAndroidId(); // DEPRECATED

متد PusheUnity.GetAdvertisingId

var adId = PusheUnity.GetAdvertisingId();

دریافت مقدار شناسه‌های سفارشی

0.6.0

برای دریافت مقادیر شناسه های سفارشی شده که متدهای آن در بالا توضیح داده شد می توانید از متد‌های زیر استفاده کنید. توضیحات این شناسه‌ها در جدول زیر آمده است:

شناسه	توضیحات	نحوه دریافت
شناسه سفارشی UserEmail	شناسه سفارشی ایمیل که توسط شما از قبل ذخیره شده توسط این متد قابل دریافت می‌باشد.	PusheUnity.GetUserEmail
شناسه سفارشی UserPhoneNumber	شناسه سفارشی شماره کاربر که از قبل توسط شما ذخیره شده و توسط این متد قابل دریافت می‌باشد.	PusheUnity.GetUserPhoneNumber
شناسه سفارشی CustomId	شناسه customId که از قبل توسط شما ذخیره شده و توسط این متد قابل دریافت می‌باشد.	PusheUnity.GetCustomId

متد PusheUnity.getUserEmail

0.6.0

این متد مقداری که برای email از قبل توسط PusheUnity.setUserEmail ذخیره شده را برمی‌گرداند. در صورتی که هیچ مقدار ایمیلی از قبل برای آن ذخیره نشده باشد یک string خالی برمی‌گرداند.

var email = PusheUnity.GetUserEmail();

متد PusheUnity.getUserPhoneNumber

0.6.0

این متد مقداری که برای phoneNumber از قبل توسط PusheUnity.setUserPhoneNumber ذخیره شده را برمی‌گرداند. در صورتی که هیچ مقداری از قبل ذخیره نشده باشد یک string خالی بر‌می‌گرداند.

var phone = PusheUnity.GetUserPhoneNumber();

متد PusheUnity.GetCustomId

0.6.0

این متد مقداری که از قبل برای customId توسط PusheUnity.SetCustomId ذخیره شده را بر‌می‌گرداند. در صورتی که هیچ مقداری از قبل ذخیره نشده باشد یک string خالی برمی‌گرداند.

var customId = PusheUnity.GetCustomId();