Deeplink

مرور کلی

ما از deep linking روی پلتفرم‌های iOS و Android پشتیبانی می‌کنیم.

اگر از URL های ردیاب Adtrace با فعال‌سازی deep linking استفاده می‌کنید، می‌توانید اطلاعات URL deep link و محتوای آن را دریافت کنید. کاربران ممکن است صرف‌نظر از اینکه اپلیکیشن نصب باشد (deep linking معمولی) یا نباشد (deferred deep linking) با URL تعامل داشته باشند.

در deep linking معمولی، پلتفرم Android به شما اجازه می‌دهد محتوای deeplink را دریافت کنید؛ اما Android به‌طور خودکار از deferred deep linking پشتیبانی نمی‌کند. برای دسترسی به محتوای deferred deeplink، می‌توانید از Adtrace SDK استفاده کنید.

برای مدیریت deeplink باید تنظیمات را در سطح native در پروژه Xcode (برای iOS) و پروژه Android Studio / Eclipse (برای Android) انجام دهید.

سناریوی معمولی

اطلاعات deep link های معمولی نمی‌تواند در کد C# Unity به شما تحویل داده شود. پس از فعال‌سازی deep linking در اپلیکیشن، اطلاعات را در سطح native دریافت خواهید کرد. برای اطلاعات بیشتر، نحوه فعال‌سازی deep linking برای Android و iOS را ببینید.

سناریوی Deferred

برای دریافت اطلاعات محتوای deferred deeplink، یک متد Callback روی شیء AdTraceConfig تنظیم کنید. این متد یک پارامتر string دریافت می‌کند و محتوای URL در آن تحویل داده می‌شود. با فراخوانی متد setDeferredDeeplinkDelegate آن را تنظیم کنید:

// ...

private void DeferredDeeplinkCallback(string deeplinkURL) {
   Debug.Log("Deeplink URL: " + deeplinkURL);

   // ...
}

AdTraceConfig adtraceConfig = new AdTraceConfig("{YourAppToken}", "{YourEnvironment}");

adtraceConfig.setDeferredDeeplinkDelegate(DeferredDeeplinkCallback);

AdTrace.start(adtraceConfig);

در deferred deep linking، یک تنظیم اضافی وجود دارد که می‌توان روی شیء AdTraceConfig انجام داد. هنگامی که Adtrace SDK اطلاعات deferred deeplink را دریافت کرد، می‌توانید انتخاب کنید که SDK URL را باز کند یا نه. با فراخوانی متد setLaunchDeferredDeeplink روی شیء config این گزینه را تنظیم کنید:

// ...

private void DeferredDeeplinkCallback(string deeplinkURL) {
   Debug.Log ("Deeplink URL: " + deeplinkURL);

   // ...
}

AdTraceConfig adtraceConfig = new AdTraceConfig("{YourAppToken}", "{YourEnvironment}");

adtraceConfig.setLaunchDeferredDeeplink(true);
adtraceConfig.setDeferredDeeplinkDelegate(DeferredDeeplinkCallback);

AdTrace.start(adtraceConfig);

اگر چیزی تنظیم نشود، Adtrace SDK همیشه سعی می‌کند URL را به‌طور پیش‌فرض باز کند.

برای فعال‌سازی پشتیبانی از deep linking، scheme ها را برای هر پلتفرم پشتیبانی‌شده تنظیم کنید.

مدیریت در اپلیکیشن‌های Android

برای تنظیم مدیریت deeplink در اپلیکیشن Android در سطح native، دستورالعمل‌های Android SDK رسمی را دنبال کنید.

این کار باید در پروژه native Android Studio / Eclipse انجام شود.

مدیریت در اپلیکیشن‌های iOS

این کار باید در پروژه native Xcode انجام شود.

برای تنظیم مدیریت deeplink در اپلیکیشن iOS در سطح native، از پروژه Xcode native استفاده کنید و دستورالعمل‌های iOS SDK رسمی را دنبال کنید.