پرش به مطلب اصلی

سؤالات متداول (FAQ)

سؤالات رایج درباره پلتفرم‌های Flutter SDK، یکپارچه‌سازی و عیب‌یابی.

عمومی​

Flutter SDK از چه پلتفرم‌هایی پشتیبانی می‌کند؟​

iOS و Android.

آیا تفاوتی بین native Android/iOS SDK و Flutter SDK وجود دارد؟​

خیر. Flutter SDK، native Adtrace Android و iOS SDK را در بر می‌گیرد. رفتار و قابلیت‌ها با یکپارچه‌سازی‌های native زیرین مطابقت دارند.

پیاده‌سازی​

چطور Flutter SDK برای Adtrace را پیدا کنم؟​

در pub.dev به دنبال adtrace بگردید یا از پکیج رسمی استفاده کنید:

adtrace_sdk_flutter در pub.dev

آخرین نسخه را به pubspec.yaml خود اضافه کنید. راهنمای Integration را ببینید.

به نسخه خاصی از Flutter SDK نیاز دارم: کجا آن را پیدا کنم؟​

نسخه‌ها در مخزن GitHub Flutter Adtrace و روی pub.dev برای هر نسخه پکیج فهرست شده‌اند.

چرا پس از یکپارچه‌سازی Flutter SDK داده‌ای در داشبورد Adtrace نمی‌بینم؟​

دلایل رایج:

دلیلراه‌حل
SDK به‌طور کامل یکپارچه نشدهبرای تنظیمات هم native (Android/iOS) و هم Dart، راهنمای Integration را مرور کنید. در صورت ادامه مشکل با پشتیبانی تماس بگیرید.
فیلترهای داشبوردبازه تاریخ، نوع داده، locale و تنظیمات fraud را در پنل بررسی کنید.

برای تست deferred deep link به یک جریان خاص نیاز است:

  1. تأیید کنید URL ردیاب به‌درستی قالب‌بندی شده.
  2. اگر URL ردیاب شامل شناسه دستگاه تست شما نیست، probabilistic matching را برای ردیاب تست در تنظیمات داشبورد فعال کنید.
  3. اپلیکیشن را از دستگاه تست حذف کنید.
  4. دستگاه تست را از طریق Settings → Testing Console در پنل فراموش کنید.
  5. روی URL ردیاب در مرورگر دستگاه کلیک کنید.
  6. ریدایرکت به App Store یا Play Store را نادیده بگیرید.
  7. اپلیکیشن را نصب کرده و SDK را راه‌اندازی کنید (ترجیحاً در sandbox با verbose logging).
  8. در صورت موفقیت، باید نصب ردیابی‌شده، deferred deep link برگشت‌داده‌شده و Callback deferred deep link فراخوانی‌شده را ببینید.

برای جزئیات تنظیمات، Deep linking را ببینید.

ردیابی Install در sandbox کار می‌کند اما در production نه​

Obfuscation (ProGuard، R8 و غیره) ممکن است در build های release کلاس‌های SDK را حذف کند. قوانین ProGuard مورد نیاز را از Proguard settings اضافه کنید.

Could not build module 'adtrace_sdk'​

در Xcode، Build Settings برای target خود را باز کنید و Allow Non-modular Includes in Framework Modules را روی YES تنظیم کنید.

اپلیکیشنم پس از اضافه کردن Adtrace SDK crash می‌کند​

از آخرین نسخه در pub.dev استفاده کنید. نسخه‌های قدیمی‌تر ممکن است با نسخه‌های اخیر Flutter SDK ناسازگار باشند.

اگر crash trace به Adtrace اشاره می‌کند، در GitHub یک issue باز کنید یا با پشتیبانی تماس بگیرید.

چند Event می‌توانم در ازای هر کاربر ارسال کنم و چند پارامتر در ازای هر Event؟​

محدودیتی در تعداد Event یا پارامترهای مقدار وجود ندارد. برای بهترین شیوه‌ها FAQ Event های Android را ببینید و برای استفاده مختص Flutter، ردیابی Event را مطالعه کنید.