نسخه: 3.0.0+

پیکربندی

از متدهای این راهنما برای پیکربندی رفتار Adtrace Android SDK استفاده کنید.

SDK از دو نوع پیکربندی پشتیبانی می‌کند:

نوع	زمان تنظیم	قابل تغییر پس از مقداردهی اولیه؟
فقط خواندنی	در `AdTraceConfig` قبل از `AdTrace.onCreate()`	خیر
پویا	در `AdTrace` در هر زمانی پس از شروع SDK	بله

ایجاد یک نمونه AdTraceConfig

گزینه‌های فقط خواندنی در یک شیء AdTraceConfig قرار می‌گیرند. آن شیء را بسازید، گزینه‌های مورد نیاز را تنظیم کنید، سپس آن را به AdTrace.onCreate() پاس دهید.

Method signature

public AdTraceConfig(
    Context context,
    String appToken,
    String environment,
    boolean allowSuppressLogLevel
)

همچنین می‌توانید از constructor سه‌آرگومانی استفاده کنید وقتی نیازی به suppress logging ندارید:

public AdTraceConfig(Context context, String appToken, String environment)

پارامترهای الزامی

پارامتر	نوع	توضیح
`context`	`Context`	Context اندروید جایی که اپ در حال اجرا است. `Application` یا `Activity` context خود را پاس دهید (مثلاً `this` در `Application.onCreate`).
`appToken`	`String`	App token Adtrace شما از پنل Adtrace.
`environment`	`String`	محیط SDK. از `AdTraceConfig.ENVIRONMENT_SANDBOX` برای تست، یا `AdTraceConfig.ENVIRONMENT_PRODUCTION` برای انتشار استفاده کنید.
`allowSuppressLogLevel`	`boolean`	آرگومان چهارم اختیاری. اگر می‌خواهید `LogLevel.SUPPRESS` را مجاز کنید، `true` تنظیم کنید. برای نگه داشتن لاگ عادی `false` تنظیم کنید (یا آن را حذف کنید).

مثال

Java
Kotlin
Javascript

import android.app.Application;
import io.adtrace.sdk.AdTrace;
import io.adtrace.sdk.AdTraceConfig;

public class GlobalApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        String appToken = "{YourAppToken}";
        String environment = AdTraceConfig.ENVIRONMENT_SANDBOX;
        AdTraceConfig config = new AdTraceConfig(this, appToken, environment);
        // گزینه‌های فقط خواندنی را اینجا در `config` تنظیم کنید، سپس:
        AdTrace.onCreate(config);
    }
}

import android.app.Application
import io.adtrace.sdk.AdTrace
import io.adtrace.sdk.AdTraceConfig

class GlobalApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        val appToken = "{YourAppToken}"
        val environment = AdTraceConfig.ENVIRONMENT_SANDBOX
        val config = AdTraceConfig(this, appToken, environment)
        // گزینه‌های فقط خواندنی را اینجا در `config` تنظیم کنید، سپس:
        AdTrace.onCreate(config)
    }
}

let appToken = "{YourAppToken}";
let environment = AdTraceConfig.EnvironmentSandbox;
let config = new AdTraceConfig(appToken, environment);
// گزینه‌های فقط خواندنی را اینجا در `config` تنظیم کنید، سپس:
AdTrace.onCreate(config);

{YourAppToken} را با app token خود از پنل Adtrace جایگزین کنید.

پیکربندی فقط خواندنی

گزینه‌های فقط خواندنی در نمونه AdTraceConfig قبل از مقداردهی اولیه SDK تنظیم می‌شوند. پس از در حال اجرا بودن SDK قابل تغییر نیستند.

باید هر گزینه‌ای که نیاز دارید قبل از فراخوانی AdTrace.onCreate() پیکربندی کنید.

تنظیم سطح لاگ

کنترل میزان نوشتن Adtrace SDK در لاگ‌های دستگاه

تنظیم external device ID

تنظیم ID سفارشی دستگاه یا کاربر قبل از مقداردهی اولیه SDK

تأخیر در شروع SDK

تأخیر در راه‌اندازی SDK برای اتصال پارامترهای Session با تأخیر

فعال‌سازی event buffering

دسته‌بندی رویدادها و ارسال آن‌ها یک بار در دقیقه

فعال‌سازی ردیابی در پس‌زمینه

ارسال درخواست‌های SDK هنگامی که اپ در پس‌زمینه است

فعال‌سازی cost data در attribution

شامل کردن فیلدهای هزینه کمپین در داده‌های attribution

تنظیم tracker پیش‌فرض

Attribution نصب‌های پیش‌نصب شده با یک tracker پیش‌فرض

پیکربندی پویا

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

برخلاف گزینه‌های فقط خواندنی در AdTraceConfig، برای اعمال یک تغییر پویا نیازی به راه‌اندازی مجدد SDK ندارید.

غیرفعال‌سازی SDK

توقف یا از سرگیری ردیابی در دستگاه فعلی

حالت آفلاین

ذخیره درخواست‌ها به صورت محلی و ارسال آن‌ها هنگام بازگشت آنلاین

تنظیم push token

ارسال توکن‌های FCM برای اندازه‌گیری uninstall و reinstall