ارسال اطلاعات Callback

Callback هایی را تنظیم کنید تا هنگامی که Adtrace SDK اطلاعات را به Adtrace ارسال می‌کند، کد خودتان اجرا شود. می‌توانید Callback هایی برای Session و رویداد تنظیم کنید.

این listener ها را در نمونه AdTraceConfig قبل از فراخوانی AdTrace.onCreate() ثبت کنید. برای نحوه ایجاد config به پیکربندی مراجعه کنید.

برای listener های attribution، به دریافت اطلاعات attribution مراجعه کنید. برای Callback های deep link deferred، به Deep linking deferred مراجعه کنید.

مهم

باید Callback های خود را قبل از مقداردهی اولیه SDK ثبت کنید.

یک Callback موفق به معنای ارسال package توسط SDK است. این همیشه به معنای ظاهر شدن داده در آمار پنل نیست. رویدادها تنها پس از ردیابی موفق نصب برای آن دستگاه در پنل نشان داده می‌شوند.

Callback های Session

Callback های Session را هنگامی که SDK اطلاعات Session ارسال می‌کند تنظیم کنید.

• Success callbacks هنگامی که SDK Session را با موفقیت ارسال می‌کند اجرا می‌شوند.
• Failure callbacks هنگامی که ارسال شکست می‌خورد اجرا می‌شوند.

داده پاسخ

Property	نوع	توضیح
message	String	پیام از سرور، یا یک خطای لاگ شده توسط SDK.
timestamp	String	Timestamp از سرورهای Adtrace.
adid	String	شناسه دستگاه Adtrace منحصربه‌فرد.
jsonResponse	JSONObject	شیء JSON با پاسخ سرور.
willRetry	boolean	فقط در شکست. true اگر SDK بعداً تلاش کند package را مجدداً ارسال کند.

Success callbacks

Method signature

public void setOnSessionTrackingSucceededListener(OnSessionTrackingSucceededListener listener)

این مثال timestamp را هنگامی که SDK Session را ضبط کرد لاگ می‌کند.

Java

import android.util.Log;
import io.adtrace.sdk.AdTrace;
import io.adtrace.sdk.AdTraceConfig;
import io.adtrace.sdk.AdTraceSessionSuccess;
import io.adtrace.sdk.OnSessionTrackingSucceededListener;

AdTraceConfig config = new AdTraceConfig(this, appToken, environment);
config.setOnSessionTrackingSucceededListener(new OnSessionTrackingSucceededListener() {
    @Override
    public void onFinishedSessionTrackingSucceeded(AdTraceSessionSuccess sessionSuccessResponseData) {
        Log.v("AdTrace", "Session recorded at " + sessionSuccessResponseData.timestamp);
    }
});
AdTrace.onCreate(config);

Kotlin

import android.util.Log
import io.adtrace.sdk.AdTrace
import io.adtrace.sdk.AdTraceConfig
import io.adtrace.sdk.OnSessionTrackingSucceededListener

val config = AdTraceConfig(this, appToken, environment)
config.setOnSessionTrackingSucceededListener(OnSessionTrackingSucceededListener { sessionSuccessResponseData ->
    Log.v("AdTrace", "Session recorded at ${sessionSuccessResponseData.timestamp}")
})
AdTrace.onCreate(config)

Javascript

function sessionSuccess(sessionSuccessResponseData) {
    console.log("Session recorded at " + sessionSuccessResponseData.timestamp);
}

let config = new AdTraceConfig(appToken, environment);
config.setSessionSuccessCallback(sessionSuccess);
AdTrace.onCreate(config);

Failure callbacks

Method signature

public void setOnSessionTrackingFailedListener(OnSessionTrackingFailedListener listener)

این مثال پیام شکست Session را لاگ می‌کند.

Java

import android.util.Log;
import io.adtrace.sdk.AdTrace;
import io.adtrace.sdk.AdTraceConfig;
import io.adtrace.sdk.AdTraceSessionFailure;
import io.adtrace.sdk.OnSessionTrackingFailedListener;

AdTraceConfig config = new AdTraceConfig(this, appToken, environment);
config.setOnSessionTrackingFailedListener(new OnSessionTrackingFailedListener() {
    @Override
    public void onFinishedSessionTrackingFailed(AdTraceSessionFailure sessionFailureResponseData) {
        Log.v("AdTrace", "Session recording failed. Response: " + sessionFailureResponseData.message);
    }
});
AdTrace.onCreate(config);

Kotlin

import android.util.Log
import io.adtrace.sdk.AdTrace
import io.adtrace.sdk.AdTraceConfig
import io.adtrace.sdk.OnSessionTrackingFailedListener

val config = AdTraceConfig(this, appToken, environment)
config.setOnSessionTrackingFailedListener(OnSessionTrackingFailedListener { sessionFailureResponseData ->
    Log.v("AdTrace", "Session recording failed. Response: ${sessionFailureResponseData.message}")
})
AdTrace.onCreate(config)

Javascript

function sessionFailure(sessionFailureResponseData) {
    console.log("Session recording failed. Response: " + sessionFailureResponseData.message);
}

let config = new AdTraceConfig(appToken, environment);
config.setSessionFailureCallback(sessionFailure);
AdTrace.onCreate(config);

Callback های رویداد

Callback های رویداد را هنگامی که SDK اطلاعات رویداد ارسال می‌کند تنظیم کنید.

• Success callbacks هنگامی که SDK اطلاعات رویداد را به سرورهای Adtrace ارسال می‌کند اجرا می‌شوند.
• Failure callbacks هنگامی که SDK با مشکلی در ارسال اطلاعات روبرو می‌شود اجرا می‌شوند.

داده پاسخ

Property	نوع	توضیح
message	String	پیام از سرور، یا یک خطای لاگ شده توسط SDK.
timestamp	String	Timestamp از سرورهای Adtrace.
adid	String	شناسه دستگاه Adtrace منحصربه‌فرد.
eventToken	String	Event token.
callbackId	String	Callback ID سفارشی تنظیم شده در رویداد با setCallbackId، اگر وجود داشته باشد.
jsonResponse	JSONObject	شیء JSON با پاسخ سرور.
willRetry	boolean	فقط در شکست. true اگر SDK بعداً تلاش کند package را مجدداً ارسال کند.

Success callbacks

Method signature

public void setOnEventTrackingSucceededListener(OnEventTrackingSucceededListener listener)

این مثال timestamp را هنگامی که SDK رویداد را ضبط کرد لاگ می‌کند.

Java

import android.util.Log;
import io.adtrace.sdk.AdTrace;
import io.adtrace.sdk.AdTraceConfig;
import io.adtrace.sdk.AdTraceEventSuccess;
import io.adtrace.sdk.OnEventTrackingSucceededListener;

AdTraceConfig config = new AdTraceConfig(this, appToken, environment);
config.setOnEventTrackingSucceededListener(new OnEventTrackingSucceededListener() {
    @Override
    public void onFinishedEventTrackingSucceeded(AdTraceEventSuccess eventSuccessResponseData) {
        Log.v("AdTrace", "Event recorded at " + eventSuccessResponseData.timestamp);
    }
});
AdTrace.onCreate(config);

Kotlin

import android.util.Log
import io.adtrace.sdk.AdTrace
import io.adtrace.sdk.AdTraceConfig
import io.adtrace.sdk.OnEventTrackingSucceededListener

val config = AdTraceConfig(this, appToken, environment)
config.setOnEventTrackingSucceededListener(OnEventTrackingSucceededListener { eventSuccessResponseData ->
    Log.v("AdTrace", "Event recorded at ${eventSuccessResponseData.timestamp}")
})
AdTrace.onCreate(config)

Javascript

function eventSuccess(eventSuccessResponseData) {
    console.log("Event recorded at " + eventSuccessResponseData.timestamp);
}

let config = new AdTraceConfig(appToken, environment);
config.setEventSuccessCallback(eventSuccess);
AdTrace.onCreate(config);

Failure callbacks

Method signature

public void setOnEventTrackingFailedListener(OnEventTrackingFailedListener listener)

این مثال پیام شکست رویداد را لاگ می‌کند.

Java

import android.util.Log;
import io.adtrace.sdk.AdTrace;
import io.adtrace.sdk.AdTraceConfig;
import io.adtrace.sdk.AdTraceEventFailure;
import io.adtrace.sdk.OnEventTrackingFailedListener;

AdTraceConfig config = new AdTraceConfig(this, appToken, environment);
config.setOnEventTrackingFailedListener(new OnEventTrackingFailedListener() {
    @Override
    public void onFinishedEventTrackingFailed(AdTraceEventFailure eventFailureResponseData) {
        Log.v("AdTrace", "Event recording failed. Response: " + eventFailureResponseData.message);
    }
});
AdTrace.onCreate(config);

Kotlin

import android.util.Log
import io.adtrace.sdk.AdTrace
import io.adtrace.sdk.AdTraceConfig
import io.adtrace.sdk.OnEventTrackingFailedListener

val config = AdTraceConfig(this, appToken, environment)
config.setOnEventTrackingFailedListener(OnEventTrackingFailedListener { eventFailureResponseData ->
    Log.v("AdTrace", "Event recording failed. Response: ${eventFailureResponseData.message}")
})
AdTrace.onCreate(config)

Javascript

function eventFailure(eventFailureResponseData) {
    console.log("Event recording failed. Response: " + eventFailureResponseData.message);
}

let config = new AdTraceConfig(appToken, environment);
config.setEventFailureCallback(eventFailure);
AdTrace.onCreate(config);