# トラッキングピクセル

Treasure Dataユーザーは、トラッキングピクセルからのデータを使用して、Treasure Dataにイベントを送信できます。

**目次**

* [前提条件](#prerequisites)
* [URLの準備](#preparing-the-url)
  * [認証](#authentication)
  * [パラメータ](#parameters)
* [<img>タグでの使用](#use-with-img-tag)


## 前提条件

* Treasure Dataの基本的な知識


## URLの準備

Treasure Dataが使用するポストバックを追加する前に、認証を設定し、パスを指定する必要があります。

### 認証

すべてのリクエストには、特別な`td_write_key` URLパラメータによって提供される_認証情報_を含める必要があります。APIキーはTreasure コンソールから取得できます。[Write-only APIキー](/products/my-settings/getting-your-api-keys)の使用を推奨します。


```
https://in.treasuredata.com/postback/v3/event/{database}/{table}?td_format=pixel&td_write_key=XXXYYYZZZZ&...
```

### パラメータ

パス内でこれら2つのパラメータを指定します。

* `{database}`: URLで宛先データベース名を指定します。アルファベット、数字、または _ のみが使用できます。
* `{table}`: URLで宛先テーブル名を指定します。アルファベット、数字、または _ のみが使用できます。


以下にリストされている特別なパラメータを除き、すべてのURLパラメータはレコード内の列と見なされます。

* **td_format**: `pixel`を指定
* **td_write_key**: 認証で説明したとおり
* **td_record_time**: UNIXタイムスタンプ値を指定して、Treasure Dataのtime列を設定します。指定されていない場合、レコードが受信された時刻が使用されます。
* **td_global_id**: ポストバックURLのクエリ文字列に`td_global_id=td_global_id`を追加すると、APIは実際のtd_global_idの値を持つ`td_global_id`という名前の列をレコードに追加します。
* **td_ip**: ポストバックURLのクエリ文字列に`td_ip=td_ip`を追加すると、APIはソースIPの値を持つ`td_ip`という名前の列をレコードに追加します。
* **td_ua**: ポストバックURLのクエリ文字列に`td_ua=td_ua`を追加すると、APIは実際のUser-Agentの値を持つ`td_ua`という名前の列をレコードに追加します。
* **td_redirect**: APIは指定されたURLにリダイレクトできます。URLはエンコードされている必要があります。td_redirect値にパラメータとしてtd_global_idが含まれている場合、APIはそれを実際の値に置き換えます。


すべてのパラメータ値は_文字列_と見なされ、トラッキングピクセルを使用した取り込み時に値の型を変更することはできません。

たとえば、URLの構造は次のようになります。


```
https://in.treasuredata.com/postback/v3/event/{database}/{table}
  ?td_format=pixel
  &td_write_key=XXXYYYZZZZ
  &td_global_id=td_global_id
  &td_ip=td_ip
  &td_ua=td_ua
  &your_custom_key1=val1
  &your_custom_key2=val2
  &your_custom_key3=val3...
```

## <img>タグでの使用

**img** HTMLタグでTreasure Dataへのポストバックとして、URLを使用します。


```html
<img src="https://in.treasuredata.com/postback/v3/event/{database}/{table}?td_format=pixel&td_write_key=XXXYYYZZZZ&td_global_id=td_global_id&td_ip=td_ip&td_ua=td_ua&key1=val1&key2=val2&key3=val3..." />
```

メール内のトラッキングに画像タグを使用することは推奨されません。これは、メール送信者のドメインとは異なるドメインからのトラッキングタグを含むメールは、スパムとしてフラグが立てられる可能性が高くなるためです。

さらに、近年、Appleなどのプラットフォームは、オープントラッキングをデフォルトで常にオープンとして扱い始めており、ピクセルベースのオープントラッキングの有効性が低下しています。受信者をランディングページに誘導したり、その他のエンゲージメント方法を含む、より広範なマーケティング戦略を検討してください。