Install

Requirements

• Tealium Universal Data Hub account
• Python 2.7+ 

Install

The Tealium for Python package can be installed using pip (learn more about pip).

Using Python 2:

pip install tealium

Using Python 3:

pip3 install tealium

Initialize

Once the Tealium for Python package is installed you are ready to start coding. Use the following code to import the Tealium module and initialize with the following parameters:

• account - the name of your account
• profile - the name of the profile within your account
• environment - (optional) one of “qa”, or “prod”
• path - (optional) path to save persisted data
• datasource - (optional) the data source key from UDH

It may be necessary to use named parameters when omitting optional parameters from the call, e.g. "datasource" must be named if omitting "path".

from tealium import Tealium
teal = Tealium('account', 'profile', 'environment', datasource:'datasource')

Track

Once the Tealium object has been defined you can begin tracking events with the method trackEvent(), which takes the following parameters:

• event - a name to identify the event
• data - (optional) dictionary with event data as key/value pairs
• callback - (optional) callback function

A function that triggers or responds to an event trigger could look like the following:  

def tealiumCallback(info, success, error=None):
    if error is not None:
        print (info, success, error)
        return
    print (info, success)

eventData = {'someKey': 'someValue'}
teal.trackEvent('someEvent',
                data:eventData,
                callback:tealiumCallback) 

• Sample Python Script

Function Definitions

Tealium()

Creates a Tealium object that will be used to track events.

Tealium(account, profile, environment, path, datasource)

trackEvent()

Creates a Tealium object that will be used to track events.

trackEvent(eventName, data, callback)

resetSessionId()

Reset the session ID. For use when needing to start a new session other than at app start time.

resetSessionId()