Tracker پیش‌فرض

از tracker پیش‌فرض زمانی استفاده کنید که اپ شما از پیش روی یک دستگاه نصب شده است. اولین باری که کاربر آن اپ از پیش نصب‌شده را باز می‌کند، ادتریس install را به tracker که تنظیم کرده‌اید نسبت می‌دهد.

این یک تنظیم read-only است: setDefaultTracker: را روی instance ADTConfig خود قبل از [Adtrace appDidLaunch:] / Adtrace.appDidLaunch(...) فراخوانی کنید. بعد از شروع SDK نمی‌توانید آن را تغییر دهید.

زمان استفاده از tracker پیش‌فرض

Use case	tracker پیش‌فرض تنظیم کنید؟
اپ از پیش نصب‌شده روی دستگاه‌های OEM یا partner	بله
نصب‌های عادی از App Store یا TestFlight با لینک‌های کمپین	خیر، از tracker URL های معمول خود استفاده کنید
Override attribution organic برای کاربران بدون attribution	خیر، tracker پیش‌فرض فقط برای جریان‌های pre-install است

Method signature

- (void)setDefaultTracker:(NSString *)defaultTracker;

همچنین می‌توانید property defaultTracker را مستقیماً روی ADTConfig تنظیم کنید:

@property (nonatomic, copy, nullable) NSString *defaultTracker;

پارامتر	نوع	توضیح
defaultTracker	NSString	توکن tracker ادتریس برای install های از پیش نصب‌شده. فقط توکن را پاس دهید (مثلاً abc123)، نه URL کامل tracker. این مقدار case-sensitive است.

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

1. یک tracker جدید در پنل ادتریس ایجاد کنید. از این tracker برای اندازه‌گیری install های از پیش نصب‌شده استفاده کنید.
2. setDefaultTracker: را روی instance ADTConfig خود قبل از appDidLaunch فراخوانی کنید. برای نحوه ایجاد config، به پیکربندی مراجعه کنید.
3. اپ را build و اجرا کنید، سپس tracker پیش‌فرض را در Xcode console تأیید کنید (به تأیید tracker پیش‌فرض مراجعه کنید).

پنل یک URL کامل tracker نمایش می‌دهد (مثلاً https://app.adtrace.io/abc123). در کد خود، فقط توکن آخر (abc123) را پاس دهید، نه URL کامل.

مثال

Objective-C

AppDelegate.m

NSString *appToken = @"{YourAppToken}";
NSString *environment = ADTEnvironmentSandbox;
ADTConfig *adtraceConfig = [ADTConfig configWithAppToken:appToken
                                             environment:environment];
[adtraceConfig setDefaultTracker:@"{TrackerToken}"];

[Adtrace appDidLaunch:adtraceConfig];

یا property را مستقیم تنظیم کنید:

adtraceConfig.defaultTracker = @"{TrackerToken}";

Swift

AppDelegate.swift

let appToken = "{YourAppToken}"
let environment = ADTEnvironmentSandbox
let adtraceConfig = ADTConfig(appToken: appToken, environment: environment)
adtraceConfig?.defaultTracker = "{TrackerToken}"

Adtrace.appDidLaunch(adtraceConfig)

Javascript

let appToken = '{YourAppToken}';
let environment = AdtraceConfig.EnvironmentSandbox;
let adtraceConfig = new AdtraceConfig(appToken, environment);
adtraceConfig.setDefaultTracker('{TrackerToken}');

Adtrace.appDidLaunch(adtraceConfig);

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

تأیید tracker پیش‌فرض

1. در حین تست سطح لاگ را روی ADTLogLevelVerbose یا ADTLogLevelDebug تنظیم کنید.
2. اپ را روی یک دستگاه با build از پیش نصب‌شده (یا build تست با tracker پیش‌فرض پیکربندی‌شده) build و اجرا کنید.
3. Xcode console اپ در حال اجرا را باز کنید.

باید خطی شبیه زیر ببینید:

Xcode console (نمونه)

Default tracker: 'abc123'

اگر این خط ظاهر نشد، بررسی کنید که setDefaultTracker را قبل از appDidLaunch فراخوانی کرده‌اید و توکن با tracker در پنل مطابقت دارد.

مرتبط

• تنظیم سطح لاگ
• پیکربندی
• شروع کار با iOS SDK
• iOS SDK در GitHub