پیکربندی

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

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

نوع	زمان تنظیم	بعد از init قابل تغییر است؟
Read-only	روی ADTConfig قبل از appDidLaunch	خیر
Dynamic	روی Adtrace در هر زمان بعد از شروع SDK	بله

ایجاد یک instance از ADTConfig

گزینه‌های read-only روی یک شیء ADTConfig قرار می‌گیرند. آن شیء را ایجاد کنید، گزینه‌های مورد نیاز را تنظیم کنید، سپس آن را به [Adtrace appDidLaunch:] / Adtrace.appDidLaunch(...) بدهید.

پارامترهای اجباری

پارامتر	نوع	توضیح
appToken	String	توکن اپلیکیشن ادتریس از پنل ادتریس.
environment	String	برای تست ADTEnvironmentSandbox و برای انتشار ADTEnvironmentProduction استفاده کنید.
allowSuppressLogLevel	BOOL / Bool	اختیاری. اگر می‌خواهید ADTLogLevelSuppress مجاز باشد، YES / true تنظیم کنید.

مثال

Objective-C

AppDelegate.m

NSString *appToken = @"{YourAppToken}";
NSString *environment = ADTEnvironmentSandbox;
ADTConfig *adtraceConfig = [ADTConfig configWithAppToken:appToken
                                             environment:environment];
// گزینه‌های read-only را اینجا روی adtraceConfig تنظیم کنید، سپس:
[Adtrace appDidLaunch:adtraceConfig];

Swift

AppDelegate.swift

let appToken = "{YourAppToken}"
let environment = ADTEnvironmentSandbox
let adtraceConfig = ADTConfig(appToken: appToken, environment: environment)
// گزینه‌های read-only را اینجا روی adtraceConfig تنظیم کنید، سپس:
Adtrace.appDidLaunch(adtraceConfig)

{YourAppToken} را با توکن اپلیکیشن از پنل ادتریس جایگزین کنید.

پیکربندی Read-only

گزینه‌های read-only روی instance ADTConfig شما قبل از مقداردهی اولیه SDK تنظیم می‌شوند. در حین اجرای SDK قابل تغییر نیستند.

قبل از فراخوانی appDidLaunch، هر گزینه‌ای که نیاز دارید را پیکربندی کنید.

تنظیم سطح لاگ

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

تنظیم شناسه دستگاه خارجی

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

تأخیر شروع SDK

تأخیر در راه‌اندازی SDK برای ضمیمه کردن پارامترهای Session دیرهنگام

فعال‌سازی event buffering

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

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

ادامه ردیابی هنگامی که اپ به پس‌زمینه منتقل می‌شود

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

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

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

نسبت دادن اپ‌های از پیش نصب‌شده با یک tracker پیش‌فرض

پیکربندی Dynamic

گزینه‌های پیکربندی dynamic می‌توانند بعد از شروع SDK تغییر کنند. این متدها را در هر زمان در طول lifecycle SDK روی Adtrace فراخوانی کنید.

برخلاف گزینه‌های read-only روی ADTConfig، برای اعمال یک تغییر dynamic نیازی به راه‌اندازی مجدد SDK ندارید.

غیرفعال کردن SDK

توقف موقت یا از سرگیری ردیابی روی دستگاه جاری

حالت آفلاین

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

تنظیم push token

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

مراحل بعدی

بعد از پیکربندی ADTConfig، یکپارچه‌سازی خود را در شروع کار با iOS SDK مقداردهی اولیه و تست کنید، سپس اقدامات را با ردیابی رویداد ردیابی کنید.