تنظیم پارامترهای Callback Session

پارامترهای Callback Session به صورت محلی ذخیره می‌شوند و با هر Session و هر رویداد که Adtrace SDK ضبط می‌کند ارسال می‌شوند. این مقادیر در سطح SDK هستند، نه مرتبط با یک AdTraceEvent واحد.

هنگامی که یک پارامتر Session اضافه می‌کنید، SDK آن را ذخیره می‌کند بنابراین نیازی نیست در هر Session یا فراخوانی track دوباره آن را تنظیم کنید.

کلیدهای تکراری

اضافه کردن همان کلید پارامتر Callback Session دوباره تأثیری ندارد. مقدار اول نگه داشته می‌شود.

می‌توانید متدهای پارامتر Session را قبل از AdTrace.onCreate() فراخوانی کنید تا در Session نصب گنجانده شوند. اگر به یک مقدار برای نصب نیاز دارید اما تنها پس از راه‌اندازی می‌توانید آن را بخوانید، از تأخیر در شروع SDK استفاده کنید.

	پارامترهای Callback Session	پارامترهای Callback رویداد
API	AdTrace.addSessionCallbackParameter(key, value)	event.addCallbackParameter(key, value)
محدوده	هر Session و رویداد	یک رویداد
چه زمانی تنظیم کنیم	هر زمانی (شامل قبل از مقداردهی اولیه SDK)	قبل از AdTrace.trackEvent()
تعارض کلید	پارامتر رویداد برنده می‌شود	بر پارامتر Session تقدم دارد

Session در مقابل Callback های SDK

این صفحه درباره پارامترهای URL Callback (داده key-value ارسال شده با Session و رویداد) است. برای listener های Success callbacks / Failure callbacks هنگامی که SDK package ارسال می‌کند، به ارسال اطلاعات Callback مراجعه کنید.

اضافه کردن پارامترهای Callback Session

Method signature

public static void addSessionCallbackParameter(String key, String value)

پارامتر	نوع	توضیح
key	String	نام پارامتر Callback.
value	String	مقدار پارامتر Callback.

مثال

Java

AdTrace.addSessionCallbackParameter("foo", "bar");

Kotlin

AdTrace.addSessionCallbackParameter("foo", "bar")

WebBridge

AdTrace.addSessionCallbackParameter("foo", "bar");

پارامترهای Callback Session با پارامترهای Callback که به رویداد اضافه می‌کنید ادغام می‌شوند. پارامترهای Callback رویداد تقدم دارند: اگر همان کلید در Session و در یک رویداد وجود داشته باشد، مقدار رویداد ارسال می‌شود.

حذف پارامترهای Callback Session

Method signature

public static void removeSessionCallbackParameter(String key)

پارامتر	نوع	توضیح
key	String	کلید پارامتر Callback Session برای حذف.

مثال

Java

AdTrace.removeSessionCallbackParameter("foo");

Kotlin

AdTrace.removeSessionCallbackParameter("foo")

WebBridge

AdTrace.removeSessionCallbackParameter("foo");

بازنشانی پارامترهای Callback Session

Method signature

public static void resetSessionCallbackParameters()

تمام کلیدها و مقادیر پارامتر Callback Session را حذف می‌کند.

مثال

Java

AdTrace.resetSessionCallbackParameters();

Kotlin

AdTrace.resetSessionCallbackParameters()

WebBridge

AdTrace.resetSessionCallbackParameters();

ارسال پارامترهای Session در نصب

قبل از AdTrace.onCreate() addSessionCallbackParameter را فراخوانی کنید وقتی مقدار باید در Session نصب موجود باشد:

Java

AdTrace.addSessionCallbackParameter("user_segment", "premium");

AdTraceConfig config = new AdTraceConfig(this, appToken, environment);
AdTrace.onCreate(config);

Kotlin

AdTrace.addSessionCallbackParameter("user_segment", "premium")

val config = AdTraceConfig(this, appToken, environment)
AdTrace.onCreate(config)

اگر مقدار در زمان راه‌اندازی آماده نیست، به جای مقداردهی اولیه فوری از تأخیر در شروع SDK استفاده کنید.

مرتبط

• ارسال اطلاعات Callback
• ردیابی رویدادها
• تأخیر در شروع SDK
• پیکربندی