کتابخانه متریکس برای Android Webview
- اضافهکردن کتابخانه متریکس به پروژه
- راهاندازی کتابخانه
- امکانات و قابلیتها
- نشست (session)
- شناسه نشست
- شماره نشست جاری
- رویداد (event)
- ساختن یک رویداد سفارشی
- مشخص کردن Attributeهای پیشفرض همهی رویدادها
- ساختن رویداد درآمدی
- دریافت شناسه دستگاههای متریکس
- امضاء
- شمارش پاک کردن اپلیکیشن
- دریافت اطلاعات کمپین
- Deep Linking
- سناریو استاندارد
- سناریو deferred
- مشخص کردن tracker پیشفرض برای نصبهای organic
- تفکیک نصبهای organic براساس استورهای مختلف
۱. مخزن متریکس را در فایل build.gradle
مربوط به پروژه خود در قسمت allprojects
اضافه کنید:
allprojects {
repositories {
// ...
mavenCentral()
}
}
۲. وابستگی کتابخانه متریکس را در فایل build.gradle
مربوط به اپلیکیشن خود اضافه کنید:
dependencies {
// ...
implementation "ir.metrix:webview:1.0.5"
}
۱. شناسه اپلیکیشن خود را به صورت meta-data
در فایل AndroidManifest.xml
اپلیکیشن خود قرار دهید:
<manifest>
...
<application>
...
<!-- خطوط زیر را اضافه کنید و کلید اپلیکیشن خود را جایگزین نمایید -->
<meta-data
android:name="metrix_appId"
android:value="APP_ID" />
</application>
</manifest>
APP_ID
: کلید اپلیکیشن شما که از پنل متریکس دریافت میکنید.
۲. پس از دریافت اشارهگر به Webview
خود:
- متد
webView.getSettings().setJavaScriptEnabled(true)
را جهت فعالسازیjavascript
درwebview
فراخوانی کنید. - متد
MetrixBridge.registerAndGetInstance(webview)
را جهت فعالسازی واسط متریکس میان کتابخانه وwebview
فراخوانی کنید. - در صورت نیاز به تغییر
webview
میتوانید متدMetrixBridge.setWebView(newWebview)
را فراخوانی کنید. - جهت غیرفعال کردن واسط، متد
MetrixBridge.unregister()
را فراخوانی کنید.
با انجام این مراحل، کلاس Activity
شما مشابه قطعه کد زیر خواهد بود:
public class MainActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
WebView webView = (WebView) findViewById(R.id.webView);
webView.getSettings().setJavaScriptEnabled(true);
webView.setWebChromeClient(new WebChromeClient());
webView.setWebViewClient(new WebViewClient());
MetrixBridge.registerAndGetInstance(webview);
try {
webView.loadUrl("file:///android_asset/MetrixExample-WebView.html");
} catch (Exception e) {
e.printStackTrace();
}
}
@Override
protected void onDestroy() {
MetrixBridge.unregister();
super.onDestroy();
}
}
به این ترتیب کتابخانه متریکس با موفقیت در اپلیکیشن شما فعال شده است و واسط Javascript
متریکس به عنوان راه ارتباطی میان کتابخانه متریکس و صفحات بارگذاری شده شما در webview
عمل خواهد کرد.
جهت ارتباط با کتابخانه متریکس و استفاده از امکانات آن مانند ارسال رویداد، در فایل HTML
خود، فایل Javascript
متریکس را که در پوشه assets
قرار دارد به صورت زیر import کنید:
<script type="text/javascript" src="metrix.js"></script>
به این ترتیب میتوانید در فایل HTML
خود متدهای Metrix
را فراخوانی کنید.