Data Sources

Data Sources

by Community Manager ‎04-27-2017 10:53 AM - edited ‎08-09-2017 09:18 AM (1,236 Views)

Data Sources represent the various platforms where you install Tealium to collect data for the Universal Data Hub. This article covers how Data Sources work, how to add them to your account, and where to use them within the UDH.

Topics covered:

Table of Contents Placeholder

What is a Data Source?

A Data Source is any system that sends data to the Universal Data Hub. These systems include websites, native mobile apps, or any custom application that has visitor event data to be collected. These systems are represented in UDH as Data Sources. A Data Source is platform specific and provides the necessary code and instructions to complete an installation.

Each time you install Tealium in a new application or website you will create a corresponding Data Source in UDH.  This Data Source will come with a generated unique value called a data source key. This key is used in the code to match the installation to the Data Source in UDH.

These are some examples of the types of Data Sources available:

  • iQ Tag Management (websites)
  • iOS (native mobile)
  • Android (native mobile)
  • Apple TV
  • Roku
  • Python
  • Java
  • HTTP API

All Data Sources have a name and description to indicate the platform where they are installed. Some Data Sources also have settings related to the specific platform of the installation.

Once a Data Source is created in UDH and the code is installed with the data source key, you can easily identify the events being sent from that Data Source using Live Events. From there you can fuel Connectors with specific Data Sources to match events from their source origin to their intended destination.

How is a Data Source used?

Data Sources are used to easily identify and keep track of your applications that send data to Tealium. Data Sources can be used in the following areas:

  • Installing Code

    To begin installing Tealium, you first create a Data Source for the platform on which your application is built (eg. JavaScript, iOS, Android, Python, etc.). The Data Source provides the installation code and instructions for that platform. Each Data Source is uniquely identified with a data source key. This key is used in your code to identify the installation as data is sent to Tealium.
  • Live Events

    Once you have installed Tealium into your application and ensured the data source key is in place, Data Sources can be used in Live Events to quickly verify that UDH is receiving data properly.  In Live Events select a Data Source to filter the display to only show events coming from that Data Source. Getting event data from your Data Source installation to appear in Live Events is the first step to a successful implementation.  

Now you're ready to get started. Before proceeding be sure you have access to the installation code of the targeted platform (for a website, this means having access to iQ Tag Management).

Adding a Data Source

To add a Data Source:

  1. Go to Data Sources and click Add Data Source.
  2. Select the target language/platform of your installation.
  3. Enter a name and description.
  4. Click Save.

The following properties of a Data Source can be changed:

  • Name - a descriptive name for the data source eg. "Tealium Digital Velocy App"
  • Notes - additional information about the data source
  • Labels - apply labels to help organize your account
  • Custom Logo URL - a URL (https) to your own logo for easy brand identification (replaces the default platform logo)
  • Custom Homepage URL - a URL to the website or application for quick reference

Installation Code

This area provides everything you need for the installation: a data source key, a sample code snippet, and links to the installation guides.

To install your Data Source:

  1. Expand the Data Source details.
  2. Copy the Data Source Key value.
  3. Paste the value into your code according to the installation instructions.

Settings

This area shows the available settings for this type of Data Source. Settings vary between platforms. For changes to take effect you must Save/Publish your account. This section is not applicable to all platforms.

Verifying a Data Source

Once you have saved and published your UDH account with the new Data Source and installed the Data Source Key in the relevant platform, you are ready to verify the setup using Live Events. Events from the new installation are identified by the attribute tealium_datasource. This attribute will be used to create a new Stream to look for the unique Data Source Key value.

To add a Stream to verify your Data Source:

  1. From Live Events click Add Stream.
  2. Enter a Title to match your Data Source eg. "Data Source - My Website"
  3. Create the following condition: tealium_datasource EQUALS {YOUR_DATA_SOURCE_KEY}
  4. Click Save.
  5. Save and publish.

data-source-stream-condition.jpg

Next, select this Stream in the Live Events view. Then, in your installation, trigger some test events and watch them arrived in Live Events.

FAQ 

What if I'm using iQ Tag Management for my website or mobile app?

If you are using iQ Tag Management then technically you already have a data source installed. You can still create a Data Source for the appropriate platform and then follow the guide to Data Sources for iQ