Install

Requirements

Tealium Universal Data Hub account
Xamarin Community Edition+

The code for the Tealium C# library is stored in Github.

Download: Tealium C# Library

Import the Tealium folder into your solution.

using TealiumCSharp;

Initialize

Once the Tealium for C# package is installed you are ready to start coding. Use the following code to initialize with the following parameters:

account - the name of your account.
profile - the name of your profile within your account.
environment - “qa” or “prod”
visitorID - a 32 character alphanumeric string identifer that should be unique to a user, app instance.
modules - (optional) modules to be initialized with library. Default modules if none provided: AppDataModule, CollectModule, LoggerModule.
dataSourceKey - (optional) the data source key from UDH.
overrideCollectUrl - (optional) custom endpoint for the Tealium Collect service.
optionalData - (optional) dictionary for module use. Null acceptable.

Config tealConfig = new Config("account",
                               "profile",
                               "environment",
                               "visitorID",
                               new string[] { <modules> },
                               "dataSourceKey",
                               "overrideCollectUrl",
                               new Dictionary<string, object> optionalData);
Tealium tealium = new Tealium(tealConfig);

Track Events

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

eventName - a name to identify the event
customData - (optional) custom data dictionary to send with track call
completion - (optional) completion block to trigger after track call

tealium.Track("eventName",
    customData,
    (success, info, error)=>) {
        Debug.WriteLine("eventTrackComplete: was successful: " + success);
});

Below are two convenience methods for calling Track() without the optional parameters:

// track call with only an event name
tealium.Track("My Event");

// track call with event name and optional data dictionary
Dictionary<sting, object> customData = new Dictionary()
{
   {"foo1", new string[]{"a","12"}},
   {"foo2", "bar2"},
   {"foo3", "bar3"}
};
tealium.Track("My Event", customData);

Xamarin Mobile Applications

If you are building a mobile application in Xamarin you will use bindings to our iOS and Android libraries.