<p align="center">
  <img src="https://user-images.githubusercontent.com/10026019/44260701-d84b6e80-a247-11e8-9d79-5f82be615c84.png" width="300"/>
  <b>tracker</b>
</p>

<p align="center">
	<a href="https://www.npmjs.com/package/@anka-dev/tracker">
	<img src="https://badge.fury.io/js/%40anka-dev%2Ftracker.svg"/>
	</a>
</p>

# 使用

## 安装

以下两种安装方式随意选择:

- 通过 npm 安装: `npm install @anka-dev/tracker --save`
- 下载该仓库下 dist/anka-tracker.min.js 文件

## 初始化

将 anka-tracker.min.js 和 配置文件 anka-tracker.config.js 放置在小程序的开发目录中（两者必须在同一文件夹下）

```shell
├── anka-tracker.config.js
├── anka-tracker.js
├── anka-tracker.js.map
├── anka.config.json
├── app.js
├── app.json
├── app.wxss
├── dist
│   └── index.js
├── pages
│   ├── index
│   └── log
├── project.config.json
└── utils
    └── util.js
```

在 `app.js` 中引入 tracker：

```javascript
// app.js
const { tracker } = require('./anka-tracker.js')
```

并在恰当的时机初始化：

```javascript
// app.js
onLaunch (options) {
	this.onLaunchOption = options
	this.tracker = tracker

	wx.login({
		complete: () => {
			// 只有初始化成功后才会开始打点请求
			// demo 里我们选择登录后初始化
			tracker.asyncInitWithCommonData({
				// 传入 commonData
				open_id: 'mock_open_id',
				union_id: 'mock_union_id'
			}).then(() => {
				console.log('初始化成功，开始执行打点任务')
			})
		}
	})
},
```

## API

提供两个打点 API 供开发者使用，建议配置 `autoPageView` 使用自动打点。

```javascript
getApp().tracker.evt('click_btn', {
	page_id: this.pageId,
	custom_data: 'custom_data'
})

getApp().tracker.pv('__viewPage', {
	page_id: 'log',
	page_type: 'common',
	page_title: '详情页',
	page_level: 'tabbar_page'
})
```

# 参考

- [./src/types/BxTracker.d.ts](./src/types/BxTracker.d.ts)

- [./src/types/types.d.ts](./src/types/types.d.ts)
