---
updatedAt: 2025-09-17T19:24:53.000Z
agentTools:
  projectIndex: https://developers.karte.io/llms.txt
---

# tracker.link

リンクトラッキング

<div className="callout callout-danger">
  <h4>tracker（タグv1）のサポート終了について</h4>
  <p>trackerを利用したタグv1は、サポートの終了を予定しています。詳細は下記をご覧ください。</p>
  <p><a href="https://support.karte.io/post/13FROpQZRRn7h8jMHEXKjv">タグv1のサポート終了のご案内とタグv2移行のお願い | KARTEサポートサイト</a></p>
</div>

<div className="callout callout-danger">
  <h4>本機能は廃止予定です</h4>
  <p>タグv1のサポート終了とともに、本機能は廃止される予定です。新規の利用はお控えください。</p>
</div>

リンクのクリックをトラッキングします。

* リンクがクリックされる前にtracker.linkを実行してください
* JavaScriptでページ遷移を実装している場合などには動作しないケースがあります

<div className="callout callout-warning">
  <h4>tracker.link利用時の注意</h4>
  <p>tracker.linkは、サイト改修無しでも簡易的にリンクトラッキングを実装する手段です。</p>
  <p>一方で、サイト側のリンク実装によっては、イベントトラッキングが失敗したり、サイト側の動作に影響があったりするケースもあります。<br />そのような場合は、サイト改修や、トラッキング用スクリプトのカスタマイズが必要になります。</p>
</div>

### Syntax：

```javascript
tracker.link(dom_selector, values);
```

### Arguments：

| Name               | Type   | Required | Default | Description                                                                |
| ------------------ | ------ | -------- | ------- | -------------------------------------------------------------------------- |
| dom\_selector      | String | -        | "a"     | トラッキングしたいDOMを示すCSSセレクタ                                                     |
| values             | Object | -        | {}      | トラッキングしたいオブジェクトを追加します。<br />（a linkからhref、targetと、xpathがデフォルトでトラッキングされます。） |
| values.event\_name | String | -        | "link"  | イベント名                                                                      |

### Code Example：

```javascript
tracker.link("#linkbtn", {
  event_name: 'foo_button_click',
  foo_field: 42
});
```

### Event Data Example：

```json
{
  href: "https://example.com/path",
  target: "_blank",
  xpath: "/html/body/h1",
  foo_field: 42
}
```