TealiumPaid
This plugin might require a paid license, or might take a share of your app's earnings. Check the plugin's repo for more information.
This plugin provides a TypeScript wrapper around the Tealium Cordova plugin for Ionic Native.
For full documentation, see https://community.tealiumiq.com/t5/Mobile-Libraries/Tealium-for-Cordova/ta-p/17618
Repo: https://github.com/Tealium/cordova-plugin
Installation
- Install the Cordova and Ionic Native plugins:
$ '' $ npm install --save @ionic-native/tealium@4
- Add this plugin to your app's module
Supported platforms
- Android
- iOS
Usage
import { Tealium, TealConfig } from '@ionic-native/tealium'; constructor(private tealium: Tealium) { } ... let tealConfig: TealConfig = { account: "<your-account>", profile: "<your-profile>", environment: "<your-environment>", // usually "dev", "qa" or "prod" isLifecycleEnabled: "true", // pass "false" to disable lifecycle tracking isCrashReporterEnabled: "false", // pass "true" to enable crash reporter (Android only) instance: "<your-instance-name" // an arbitrary instance name. use the same instance name for all subsequent API calls } this.tealium.init(tealConfig).then(()=>{ this.tealium.trackView({"screen_name": "homescreen"}); });
Instance Members
init(config)
This function initializes the Tealium Cordova plugin. This should usually be done inside the “deviceReady” handler.
Param | Type | Details |
---|---|---|
config | TealConfig |
Returns: Promise<any>
Returns a promise that resolves when something happens
trackView(dataObject, instanceName)
This function tracks a view event in the Tealium Cordova plugin
Param | Type | Details |
---|---|---|
dataObject | any | The JSON data object containing your key-value pairs |
instanceName | string | Your arbitrary Tealium instance name provided at init time |
Returns: Promise<any>
Returns a promise that resolves when something happens
trackEvent(dataObject, instanceName)
This function tracks a link event in the Tealium Cordova plugin
Param | Type | Details |
---|---|---|
dataObject | any | The JSON data object containing your key-value pairs |
instanceName | string | Your arbitrary Tealium instance name provided at init time |
Returns: Promise<any>
Returns a promise that resolves when something happens
track(eventType, dataObject, instanceName)
This function tracks a custom event in the Tealium Cordova plugin
Param | Type | Details |
---|---|---|
eventType | string | The event type, link or view |
dataObject | any | The JSON data object containing your key-value pairs |
instanceName | string | Your arbitrary Tealium instance name provided at init time |
Returns: Promise<any>
Returns a promise that resolves when something happens
addPersistent(keyName, value, instanceName)
This function adds data to the Tealium persistent data store
Param | Type | Details |
---|---|---|
keyName | string | The key name that this data will be stored under for later retrieval |
value | any | The value to be stored as persistent data |
instanceName | string | Your arbitrary Tealium instance name provided at init time |
Returns: Promise<any>
Returns a promise that resolves when something happens
addVolatile(keyName, value, instanceName)
This function adds data to the Tealium volatile data store
Param | Type | Details |
---|---|---|
keyName | string | The key name that this data will be stored under for later retrieval |
value | any | The value to be stored as volatile data |
instanceName | string | Your arbitrary Tealium instance name provided at init time |
Returns: Promise<any>
Returns a promise that resolves when something happens
removeVolatile(keyName, instanceName)
This function removes data from the Tealium volatile data store
Param | Type | Details |
---|---|---|
keyName | string | The key name that this data will removed from the Tealium data store |
instanceName | string | Your arbitrary Tealium instance name provided at init time |
Returns: Promise<any>
Returns a promise that resolves when something happens
removePersistent(keyName, instanceName)
This function removes data from the Tealium persistent data store
Param | Type | Details |
---|---|---|
keyName | string | The key name that this data will removed from the Tealium data store |
instanceName | string | Your arbitrary Tealium instance name provided at init time |
Returns: Promise<any>
Returns a promise that resolves when something happens
getPersistent(keyName, instanceName, callback)
This function retrieves a value from the Tealium Persistent data store
Param | Type | Details |
---|---|---|
keyName | string | The key name that this data will retrieved from the Tealium data store |
instanceName | string | Your arbitrary Tealium instance name provided at init time |
callback | any | A callback function that will be called when the data has been retrieved |
Returns: Promise<any>
Returns a promise that resolves when something happens
getVolatile(keyName, instanceName, callback)
This function retrieves a value from the Tealium Volatile data store
Param | Type | Details |
---|---|---|
keyName | string | The key name that this data will retrieved from the Tealium data store |
instanceName | string | Your arbitrary Tealium instance name provided at init time |
callback | any | A callback function that will be called when the data has been retrieved |
Returns: Promise<any>
Returns a promise that resolves when something happens
addRemoteCommand(commandName, instanceName, callback)
This function adds a remote command for later execution
Param | Type | Details |
---|---|---|
commandName | string | The command name for this Remote Command |
instanceName | string | Your arbitrary Tealium instance name provided at init time |
callback | any | A callback function that will be called when the data has been retrieved |
Returns: Promise<any>
Returns a promise that resolves when something happens
getVisitorId()
This function retrieves the Tealium Visitor ID
Returns: Promise<any>
Returns a promise that resolves when something happens
TealConfig
Param | Type | Details |
---|---|---|
account | string | Your Tealium account name |
profile | string | Your Tealium profile name |
environment | string | Your Tealium environment name (dev, qa, prod) |
instance | string | Arbitrary instance name string. Must be consistent for all calls to Tealium API. |
isLifecycleEnabled | string | Enables ("true") or disables ("false") lifecycle reporting. Default true if omitted. (optional) |
collectDispatchURL | string | Not usually required. Sets a custom URL override for dispatches to UDH. (optional) |
collectDispatchProfile | string | Your Tealium UDH profile. Only active if you do not have collectDispatchURL set. (optional) |
isCrashReporterEnabled | string | Enables ("true") or disables ("false") Crash Reporter module for Android. Default false if omitted. (optional) |