# utm-tracking

> For tracking utm

Latest version **0.1.3** (published 2021-01-29) · MIT license · 0 weekly downloads

## Install

```sh
npm install utm-tracking
pnpm add utm-tracking
yarn add utm-tracking
bun add utm-tracking
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.3 |
| Published | 2021-01-29 |
| First published | 2021-01-27 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 6 |
| Unpacked size | 4.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Backer-Founder |
| Maintainers | paperhsiao |
| Keywords | utm, url |

## Links

- npm: https://www.npmjs.com/package/utm-tracking
- Repository: https://github.com/BackerFounder/utm-tracking
- Homepage: https://github.com/BackerFounder/utm-tracking#readme
- Issues: https://github.com/BackerFounder/utm-tracking/issues
- npm.io page: https://npm.io/package/utm-tracking

## Dependencies (6)

- [gulp](https://npm.io/package/gulp.md) ^4.0.2
- [gulp-babel](https://npm.io/package/gulp-babel.md) ^8.0.0
- [@babel/core](https://npm.io/package/@babel/core.md) ^7.12.10
- [gulp-rename](https://npm.io/package/gulp-rename.md) ^2.0.0
- [gulp-uglify](https://npm.io/package/gulp-uglify.md) ^3.0.2
- [@babel/preset-env](https://npm.io/package/@babel/preset-env.md) ^7.12.11

## Alternatives

- [base64url](https://npm.io/package/base64url.md) — 6.1M weekly downloads
- [get-installed-path](https://npm.io/package/get-installed-path.md) — 502.9K weekly downloads
- [@uppy/url](https://npm.io/package/@uppy/url.md) — 185.8K weekly downloads
- [@d3fc/d3fc-shape](https://npm.io/package/@d3fc/d3fc-shape.md) — 16.2K weekly downloads
- [localizer](https://npm.io/package/localizer.md) — 226 weekly downloads

## Recent versions

- 0.1.3 (latest) — 2021-01-29
- 0.1.2 — 2021-01-27
- 0.1.1 — 2021-01-27
- 0.1.0 — 2021-01-27

## README

<!-- 專案名稱 -->

# UTM Tracking

- 要在前往的網址上，增加 UTM 相關訊息
- 需要在沒有 UTM 訊息時，但也能判斷是從什麼搜尋引擎來的時候

這時候，你就需要 `UTM Tracking`

## 安裝 & 文件

#### NPM

```bash
npm install utm-tracking
```

#### YARN

```bash
yarn add utm-tracking
```

你可以將它像這樣的方式引入你的專案

```javascript
import utmTracking from 'utm-tracking'
```

## 該如何使用它？

Step1. 以下 function 需要在程式進入點時呼叫

```javascript
// app.js

// 多久刷新 referrerSessions (單位: 分鐘)
utmTracking.setReferrerSessions(30)
```

Step2. 當按下某個按鈕要跳轉頁面的時候

```javascript
btn.addEventListener('click', () => {
  const link = 'http://www.google.com' // Expected URL
  const combinedLink = utmTracking.mergeUrlParams(link)
  window.location.href = combinedLink
})
```

---
_Source: https://npm.io/package/utm-tracking · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._