> For the complete documentation index, see [llms.txt](https://docs.immedio.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.immedio.io/immedio-box/guides/integrations/tracking-token.md).

# トラッキングトークンを発行する

トラッキングトークンを発行する

これまではリードを事前に一括登録する手段がなく、対象者がトラッキングリンクにアクセスして初めてリードがimmedio Box上に作成される運用でした。また、登録済みリードのトラッキングトークンを一覧で取り出す手段もありませんでした。

今回のリリースにより、CSVを使ってリードを一括で作成できるようになり、各リードに発行されるトラッキングトークンを一覧でダウンロードできるようになりました。これにより、メール配信ツールやレター施策で「リードごとに固有のトラッキングリンク」を差し込みやすくなります。

### 使い方

#### CSVインポート（リードの一括作成）

1. immedio Boxの管理画面を開く
2. リード管理画面を開き、CSVインポートのメニューを選択する
3. 画面に表示されるサンプルCSVをダウンロードし、メールアドレス列を埋める
4. 作成したCSVをアップロードする
5. アップロード完了後、リードが一括作成され、各リードにトラッキングトークン（ltk）が発行される

#### CSVダウンロード（リード一覧の取得）

1. immedio Boxの管理画面を開く
2. リード管理画面を開き、CSVダウンロードのメニューを選択する
3. 以下のいずれかのスコープを選択してダウンロードする
   * 現テナントの全リード
   * 特定のCSVでアップロードされたリード
4. ダウンロードしたCSVには、各リードのメールアドレスとトラッキングトークン（ltk）が含まれる

#### トラッキングトークンについて（あわせて変更）

* トラッキングリンクのクエリパラメータがこれまでの `?tk=xx` から、今回のリリースより `?ltk=xx` に変更されます
* `tk` 付きの旧リンクでアクセスされた場合は、自動的に `ltk` 付きのリンクへリダイレクトされるため、過去に配布したリンクは引き続きご利用いただけます
* これまでの `tk` は「リード × コンテンツ」の組み合わせごとに発行されていましたが、新しい `ltk` は1リードにつき1つだけ発行されます
* 特定コンテンツの `ltk` 付きリンクは、トラッキングリンク画面の「共有」からコピーできます

### Use case

* **アウトバウンドメール**：ターゲットリストをCSVでインポートしてリードを一括作成し、ダウンロードしたCSVのトラッキングトークンをメール配信ツールに差し込んで、開封・閲覧ログをimmedio Box上で個別に追跡する
* **外部ツールとのID連携**：すでに自社のCRM・MAに登録済みのリードを、メールアドレスをキーにimmedio Box側にも一括登録し、トラッキングトークンを外部ツール側に書き戻す

### 注意事項

* 本機能はProfessionalプランでのみご利用いただけます
* CSVインポート時点では企業リサーチ（ドメイン分析AI）は実行されません。インポートしたリードに何らかのアクション（トラッキングリンクの閲覧など）が発生した時点で初めて企業リサーチが動きます
* 過去に配布した `?tk=xx` 形式のリンクは `?ltk=xx` 形式へ自動リダイレクトされますが、外部システムにリンクを保存している場合は、新規発行分から `ltk` 形式に切り替わる点をご認識ください


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.immedio.io/immedio-box/guides/integrations/tracking-token.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
