دریافت اطلاعات دستگاه

Adtrace SDK متدهای کمکی را فراهم می‌کند که شناسه‌های دستگاه را بازمی‌گردانند. از این ID ها در Callback ها، یکپارچه‌سازی‌های سمت سرور، یا رویدادهای S2S استفاده کنید.

متد	بازمی‌گرداند	استفاده معمول
getAdid()	شناسه دستگاه Adtrace (adid)	S2S زمانی که gps_adid در دسترس نیست، نگاشت دستگاه داخلی
getGoogleAdId()	Google Play Services advertising ID (gps_adid)	دستگاه‌های Google Play، S2S، placeholder های Callback
getAmazonAdId()	Amazon Advertising ID	دستگاه‌های Amazon / Fire OS

شناسه دستگاه Adtrace

Method signature

public static String getAdid()

Adtrace یک شناسه دستگاه Adtrace منحصربه‌فرد (adid) برای هر دستگاه تولید می‌کند. getAdid را فراخوانی کنید تا این ID را به عنوان String بازگرداند.

مهم

adid تنها پس از ردیابی نصب اپ توسط Adtrace در دسترس است. قبل از مقداردهی اولیه SDK و ردیابی موفق نصب نمی‌توانید آن را بخوانید.

مثال

Java

String adid = AdTrace.getAdid();

Kotlin

val adid = AdTrace.getAdid()

Javascript

let adid = AdTrace.getAdid();

Google Play Services advertising ID

Method signature

public static void getGoogleAdId(Context context, OnDeviceIdsRead onDeviceIdRead)

پارامتر	نوع	توضیح
context	Context	Context اندروید (مثلاً Activity یا Application شما).
onDeviceIdRead	OnDeviceIdsRead	Callback که Google advertising ID را دریافت می‌کند.

Google Play Services Advertising ID (GPS ADID) یک شناسه خاص دستگاه در Android است.

کاربران می‌توانند با Opt out of Ads Personalization از اشتراک‌گذاری GPS ADID خود انصراف دهند. هنگامی که آن تنظیم فعال است، SDK یک رشته صفر بازمی‌گرداند.

مهم

اگر Android 12 (API level 31) یا بالاتر را هدف قرار می‌دهید، مجوز com.google.android.gms.AD_ID را به اپ خود اضافه کنید. بدون آن نمی‌توانید Google advertising ID را بخوانید.

مثال

Java

AdTrace.getGoogleAdId(this, new OnDeviceIdsRead() {
    @Override
    public void onGoogleAdIdRead(String googleAdId) {
        // ...
    }
});

Kotlin

AdTrace.getGoogleAdId(this, object : OnDeviceIdsRead {
    override fun onGoogleAdIdRead(googleAdId: String) {
        // ...
    }
})

Javascript

AdTrace.getGoogleAdId(function (googleAdId) {
    // ...
});

Amazon Advertising ID

Method signature

public static String getAmazonAdId(final Context context)

پارامتر	نوع	توضیح
context	Context	Context اندروید که اپ در آن اجرا می‌شود. getApplicationContext() / applicationContext را ترجیح دهید.

Amazon Advertising ID (Amazon Ad ID) یک شناسه خاص دستگاه در دستگاه‌های Amazon / Fire OS است.

مثال

Java

String amazonAdId = AdTrace.getAmazonAdId(getApplicationContext());

Kotlin

val amazonAdId = AdTrace.getAmazonAdId(applicationContext)

Javascript

let amazonAdId = AdTrace.getAmazonAdId();

مرتبط

• دریافت اطلاعات attribution
• ردیابی Uninstall / Reinstall
• پیکربندی