tracker

3rd ali-mini-programs trackers with umeng

Usage

Um_Key_CIAMID, Um_Key_SourcePage, Um_Key_PageUrl, Um_key_PageParams, Um_Key_CurrentPage, Um_Key_CurrentPageContent will be add to your every recording automatically.

app init

import 'umtrack-alipay';
import pageView from './src/pageView';
import { setTrackerMap } from './src/info';
import { recordMixin } from './src/record';
import trackerMap from './tracker-map';
setTrackerMap(trackerMap)

App({
  mixins: [ pageView, recordMixin ],
  umengConfig: {
    appKey: 'YOUR_UMENG_APPKEY',
  },
  ...
}

page usage

page view

• setting page info at tracker-map

{
  'pages/demo/index': {
    pageName: 'pageName',
    pvKey: 'pagepvKey',
    pvContent: {
      key1: 'value1',
      key2: 'value2'
    }
  },
}

if you want to add additional key-value at pages, bellow is appreciated:

import { createPage } from '@miapp/app';
createPage({
  meta: {
    otherKey1: 'otherValue1',
    otherKey2: 'otherValue2',
  },
  data: {
    ...
  },
  ...
}

comp exposure

setting page.json in your comp's page:

{
  "usingComponents": {
    "exp": "@ubrorg/tracker/lib/index"
  }
}

using <exp> wrappered your comps

<exp appearParam="{{appearParam}}">
  <YOUR-COMP />
</exp>

appearParam: {
  key: 'CompsShow',
  content: {
    key1: 'value1',
    key1: 'value2'
  }
}

custom record

import record from '@ubrorg/tracker/lib/record';
record('key', {
  key1: 'value1',
})

or using record binded at page.

Page({
  methodName() {
    this.record('key', {
      key1: 'value1',
    })
  }
})

plugin's pages&components' record

• step1: plugin's api exports setTracker api to main miniapp, and getTracker api to plugin's pages&components:

let tracker = null;
function setTracker(func) {
  tracker = func;
}
function getTracker() {
  return tracker;
}
module.exports = {
  setTracker,
  getTracker,
}

• step2: miniprogram call setTracker before navigate to plugin page:

import record from '@ubrorg/record/lib/record';
var plugin = requirePlugin("myPlugin");

Page({
  onLoad(query) {
    plugin.setTracker(record);
  },
  onTap() {
    my.navigateTo({
      url: 'plugin://myPlugin/hello-page',
    });
  }
});

• step3: plugin's pages&components using tracker from getTracker api to record:

import { getTracker } from '../../api/trackerApi';
Page({
  onLoad() {
    this.tracker = getTracker();
  },
  onTap(e) {
    this.tracker && this.tracker('cusKey', {
      a: 'b'
    });
  }
})