دریافت اطلاعات attribution

هنگامی که کاربر با یک لینک tracker Adtrace یا یک deep link تعامل می‌کند، اطلاعات attribution آن‌ها می‌تواند به‌روز شود. جزئیات attribution توسط کلاس AdTraceAttribution نشان داده می‌شود.

از این راهنما برای:

1. خواندن attribution فعلی با AdTrace.getAttribution().
2. اجرای کد هنگام تغییر attribution با setOnAttributionChangedListener.

نکته

AdTrace.getAttribution() در Adtrace SDK v2.3+ در دسترس است.

Properties AdTraceAttribution

کلاس AdTraceAttribution وضعیت attribution فعلی دستگاه را نگه می‌دارد. هر مقداری که برای کاربر تنظیم نشده باشد به عنوان null بازگردانده می‌شود.

Property	نوع	توضیح
trackerToken	String	Token tracker که دستگاه در حال حاضر به آن attributed است.
trackerName	String	نام tracker که دستگاه در حال حاضر به آن attributed است.
network	String	شبکه‌ای که دستگاه در حال حاضر به آن attributed است.
campaign	String	کمپینی که دستگاه در حال حاضر به آن attributed است.
adgroup	String	Ad group که دستگاه در حال حاضر به آن attributed است.
creative	String	Creative که دستگاه در حال حاضر به آن attributed است.
clickLabel	String	Click label برچسب‌گذاری شده در نصب.
adid	String	شناسه دستگاه Adtrace منحصربه‌فرد.
costType	String	مدل قیمت‌گذاری کمپین (مثلاً cpi). نیاز به cost data در attribution دارد.
costAmount	Double	هزینه نصب. نیاز به cost data در attribution دارد.
costCurrency	String	کد ارز ISO 4217 برای هزینه. نیاز به cost data در attribution دارد.

نکته

فیلدهای هزینه تنها زمانی در دسترس هستند که آن‌ها را با setNeedsCost(true) در AdTraceConfig قبل از AdTrace.onCreate() فعال کنید.

دریافت اطلاعات attribution فعلی

با فراخوانی getAttribution در AdTrace هر زمان که نیاز دارید به attribution فعلی کاربر دسترسی پیدا کنید.

Method signature

public static AdTraceAttribution getAttribution()

مهم

Attribution فعلی تنها پس از ردیابی نصب اپ توسط Adtrace و trigger شدن Callback attribution در دسترس است. قبل از مقداردهی اولیه SDK و اجرای آن Callback نمی‌توانید به attribution دسترسی داشته باشید.

مثال

Java

AdTraceAttribution attribution = AdTrace.getAttribution();

Kotlin

val attribution = AdTrace.getAttribution()

Javascript

let attribution = AdTrace.getAttribution();

سپس فیلدها را از شیء بازگردانده شده بخوانید (مثلاً attribution.trackerToken، attribution.campaign).

Trigger کردن یک تابع هنگام تغییر attribution

مانند جریان Callback attribution، SDK می‌تواند شما را هر زمان که اطلاعات attribution تغییر می‌کند مطلع کند. یک listener را در نمونه AdTraceConfig قبل از AdTrace.onCreate() ثبت کنید.

Method signature

public void setOnAttributionChangedListener(OnAttributionChangedListener listener)

پارامتر	نوع	توضیح
listener	OnAttributionChangedListener	هنگامی که داده attribution تغییر می‌کند فراخوانی می‌شود. یک شیء AdTraceAttribution دریافت می‌کند.

مهم

setOnAttributionChangedListener را قبل از مقداردهی اولیه SDK با AdTrace.onCreate() فراخوانی کنید.

مثال

Java

config.setOnAttributionChangedListener(new OnAttributionChangedListener() {
    @Override
    public void onAttributionChanged(AdTraceAttribution attribution) {
        // از attribution.trackerToken، attribution.campaign، و غیره استفاده کنید.
    }
});

Kotlin

config.setOnAttributionChangedListener { attribution ->
    // از attribution.trackerToken، attribution.campaign، و غیره استفاده کنید.
}

Javascript

function attributionCallback(attribution) {
    // از attribution.trackerToken، attribution.campaign، و غیره استفاده کنید.
}

config.setAttributionCallback(attributionCallback);

برای نحوه ایجاد نمونه AdTraceConfig به پیکربندی مراجعه کنید.

مرتبط

• فعال‌سازی cost data در attribution
• ارسال اطلاعات Callback
• Deep linking deferred
• پیکربندی