Back

The Tealium Collect service can be used by sending data directly to an endpoint associated with your account. The format is a simple URL with query string parameters, similar to many tag pixels you've seen before. This endpoint can be used in applications where you might be unable to implement on of our standard installation libraries (such as JavaScript or iOS).

A newer Tealium Collect Pixel is available as the Tealium Collect HTTP API.

Table of Contents Placeholder

Resource URL 

The Tealium Collect URL collects data via the query string parameters. The following parameters are required:

  • tealium_account - The account name for AudienceStream/Tealium iQ
  • tealium_profile - The profile name where you have AudienceStream configured for Audiences or EventStream
  • tealium_vid - The Visitor ID or secondary ID such as Device ID from which the tracking request originates
  • tealium_trace_id - [optional] - Only used when testing with the Trace feature

All additional parameters added to the query string are treated as your data layer.

//collect.tealiumiq.com/vdata/i.gif?tealium_account=ACCOUNT&tealium_profile=PROFILE&tealium_vid=ID&name1=value1&name2=value2

Examples

Email Tracking

Tracking email impressions usually requires manually adjusting the HTML code. And since JavaScript is not allowed in emails, using the Tealium Collect Pixel is the perfect solution to send email tracking data directly to the UDH.

Let's use a Cyber Monday Promotion email as an example, using the following data layer:

{
    "page_type" : "email",
    "email_id"  : "cyber_monday_2016"
}

The corresponding Tealium Collect Pixel would be:

//collect.tealiumiq.com/vdata/i.gif?tealium_vid=1234567890&tealium_account=ACCOUNT&tealium_profile=PROFILE&page_type=email&email_id=cyber_monday_2016

This pixel can then be added as a 1x1 pixel to your HTML email to track impressions.

Special Formatting

Some integrations within the UDH support variables in the form of an array of items in a  URI-Encoded JSON format. The expected format for a list of items (Array) would be as follows:

Variable: product_id=["prod1","prod2","prod3"]

Collect Pixel format: product_id=%5B%22prod1%22%2C%22prod2%22%2C%22prod3%22%5D