لایه وب (Web SDK)

پس از تکمیل شروع با TWA SDK، بخش وب اپ TWA شما از Adtrace Web SDK برای نصب (در اولین باز شدن)، session‌ها، رویدادها، callbackها و attribution استفاده می‌کند.

هیچ API رویداد یا callback خاص TWA وجود ندارد. تنها مرحله خاص TWA این است که شناسه‌های دستگاه را از launch URL نیتیو به initSdk منتقل کنید (به مقداردهی اولیه Web SDK مراجعه کنید). پس از آن، مستندات Web SDK را دنبال کنید.

ارسال gps_adid از native به web الزامی است

قبل از رویدادها یا callbackها، مطمئن شوید Android native مقدار gps_adid را به initSdk رسانده است. بدون این handoff، attribution نصب TWA ناقص می‌ماند.

TWA چه تفاوتی با browser PWA دارد؟

موضوع	Browser PWA	TWA
شناسه‌های دستگاه	توسط Web SDK در مرورگر خوانده می‌شوند	از Android نیتیو از طریق پارامترهای query در launch URL منتقل می‌شوند
شناسه تست نصب	web_uuid در Testing Console	gps_adid در Testing Console
دستگاه تست	مرورگر روی موبایل توصیه می‌شود	گوشی موبایل واقعی یا شبیه‌ساز Google Play الزامی است
مقداردهی اولیه Android SDK نیتیو	برای attribution استفاده نمی‌شود	فقط برای خواندن gps_adid قبل از راه‌اندازی استفاده می‌شود

همه چیز دیگر ( trackEvent، attributionCallback، partner parameterها، درآمد، deduplication و غیره) با Web SDK یکسان است.

قبل از رویدادها و callbackها

ابتدا نصب

قبل از ارسال رویدادها یا اتکا به callbackهای attribution، تأیید کنید نصب برای دستگاه ثبت شده است. اگر هیچ نصبی ثبت نشده باشد، Adtrace ممکن است رویدادها را ذخیره کند اما آن‌ها در آمار پنل نمایش داده نمی‌شوند.

۱. یکپارچه‌سازی TWA شامل initSdk Web SDK را کامل کنید. ۲. روی یک گوشی موبایل واقعی یا شبیه‌ساز Google Play تست کنید. ۳. نصب را در Testing Console با استفاده از gps_adid تأیید کنید.

اگر gps_adid در سمت وب وجود ندارد، به سوالات متداول مراجعه کنید.

راهنماهای Web SDK

از این مستندات برای جزئیات پیاده‌سازی استفاده کنید. نام‌های API، پارامترها و مثال‌ها در TWA یکسان هستند.

ردیابی رویداد

trackEvent، درآمد، callback params و deduplication

ویژگی‌های تکمیلی

Attribution callback، getAttribution، partner params و گزینه‌های session

یکپارچه‌سازی Web SDK

راه‌اندازی script، گزینه‌های initSdk و environment

مرجع سریع

// همان Web SDK پس از TWA initSdk (با gps_adid از launch URL)
Adtrace.trackEvent({
  eventToken: 'YOUR_EVENT_TOKEN',
});

Adtrace.initSdk({
  appToken: 'YOUR_APP_TOKEN',
  environment: 'sandbox',
  gps_adid: gpsAdidFromLaunchUrl,
  attributionCallback: function (e, attribution) {
    // همان callback Web SDK
  },
});

مطالب مرتبط

• شروع با TWA SDK
• ردیابی حذف و نصب مجدد
• سوالات متداول
• اپ demo Web SDK
• پروژه نمونه TWA