Treasure Data users can use data from a tracking pixel to send events to Treasure Data.

Prerequisites

• Basic knowledge of Treasure Data

Preparing the URL

You must set up authentication and specify a path before you can add the postback that is used by Treasure Data.

Authentication

Every request must contain authentication information, provided by the special td_write_key URL parameter. The API key can be retrieved from TD Console. It’s recommended to use write-only API key.

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

Parameters

Specify these two parameters within a path.

• {database}: specify the destination database name in the URL. Only alphabet, numbers, or _ are allowed.

• {table}: specify destination table name in URL. only alphabet, numbers, or _ are allowed.

Any URL parameter, except special parameters listed as follows, is considered as a column inside the record.

• td_format: Specify pixel

• td_write_key: As described in Authentication.

• td_record_time: Specify a UNIX timestamp value to set time column in Treasure Data. If it’s not specified, the time records that are received are used.

• td_global_id: If td_global_id=td_global_id in the query string of postback URL is added, then the API adds a column named td_global_id with value of actual td_global_id into the record.

• td_ip: If td_ip=td_ip in the query string of postback URL is added, then the API adds a column named td_ip with the value of source IP into the record.

• td_ua: If td_ua=td_ua in the query string of postback URL is added, then the API adds a column named td_ua with the value of actual user-agent into the record.

• td_redirect: The API can redirect to the specified URL. The URL must be encoded. If the td_redirect value includes td_global_id as a parameter, then the API replaces it with an actual value.

All parameter values are considered as strings, and you cannot change the value type at the ingestion time with a tracking pixel.

For example URL structure would be something like this:

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...

Use with <img> Tag

Use the URL with an img HTML tag as the postback to Treasure Data.

<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..." />