دستگاه‌های Huawei (ردیابی OAID)

OAID plugin

OAID یک advertising ID است که MSA (Mobile Security Alliance) اعلام کرد تمام دستگاه‌های ساخته شده در چین باید آن را ارائه دهند. می‌توانید از آن برای attribution و ردیابی دستگاه‌های Android در بسیاری از بازارها که Google Play Services در دسترس نیست استفاده کنید.

OAID plugin Adtrace Android SDK را قادر می‌سازد مقدار OAID دستگاه را علاوه بر سایر شناسه‌های دستگاه که به طور پیش‌فرض جستجو می‌کند بخواند. OAID در تمام دستگاه‌های استفاده کننده از MSA SDK یا HMS (Huawei Mobile Service) در دستگاه‌های Huawei قابل خواندن است.

قبل از شروع، مطمئن شوید یکپارچه‌سازی را خوانده‌اید و Adtrace SDK را با موفقیت در اپ خود یکپارچه کرده‌اید.

برای فعال‌سازی OAID plugin فقط برای خواندن OAID دستگاه‌های Huawei، می‌توانید مرحله اضافه کردن MSA SDK به اپ را رد کنید.

اضافه کردن OAID plugin به اپ

اگر از Maven استفاده می‌کنید، وابستگی OAID plugin زیر را به فایل build.gradle خود کنار وابستگی موجود Adtrace SDK اضافه کنید:

implementation 'io.adtrace:android-sdk:2.5.1'
implementation 'io.adtrace:android-sdk-plugin-oaid:2.5.1'

همچنین می‌توانید Adtrace OAID plugin را به عنوان فایل JAR اضافه کنید که می‌توانید از صفحه releases ما دانلود کنید.

اضافه کردن MSA SDK به اپ

توجه: برای خواندن OAID از دستگاه‌های Huawei نیازی به اضافه کردن MSA SDK نیست. OAID plugin می‌تواند از Huawei Mobile Service (نسخه ۲.۶.۲ یا جدیدتر) برای این کار استفاده کند.

برای فعال‌سازی OAID plugin برای خواندن مقادیر OAID با MSA SDK، MSA SDK (فایل AAR) را در دایرکتوری libs پروژه خود کپی کنید و وابستگی را تنظیم کنید. همچنین باید supplier config.json را در دایرکتوری assets پروژه خود کپی کنید.

توجه: MSA SDK توسط Adtrace OAID plugin نسخه ۲.۰.۱ و بعد از آن پشتیبانی می‌شود.

تنظیمات Proguard

اگر از Proguard استفاده می‌کنید و اپ خود را در Google Play Store منتشر نمی‌کنید، می‌توانید تمام قوانین مرتبط با Google Play Services و کتابخانه‌های install referrer را در تنظیمات Proguard حذف کنید.

از تمام قوانین بسته io.adtrace.sdk مانند این استفاده کنید:

-keep public class io.adtrace.sdk.** { *; }

اگر MSA SDK AAR را به عنوان وابستگی اضافه می‌کنید، قوانین زیر را اضافه کنید:

-keep class com.bun.miitmdid.core.** { *; }

استفاده از plugin

برای خواندن مقادیر OAID، قبل از شروع SDK AdTraceOaid.readOaid(applicationContext) را فراخوانی کنید:

AdTraceOaid.readOaid(applicationContext);

// ...

AdTrace.onCreate(config);

برای متوقف کردن خواندن مقادیر OAID توسط SDK، AdTraceOaid.doNotReadOaid() را فراخوانی کنید.