Titanium Quick Start


We no longer offer support for this plugin, and it will be removed by July 2018.

For questions, please contact support@tune.com.

The TUNE plugin for Titanium provides application session and event tracking functionality via the TUNE native SDKs.

To begin tracking sessions, you must first integrate the Titanium plugin with your app. You may track in-app events – such as purchases, game levels, and any other user engagement – once you have initiated measureSession.

With this Quick Start, you can get the Titanium plugin up and tracking in no time.

Supported TMC Solutions

The TUNE plugin for Titanium supports the following TUNE Marketing Console solutions:

  • Attribution Analytics
  • App Store Analytics

Downloading the Plugin

Please first view the Using Titanium Modules document for instructions on how to use this module in your application. Note that you may have to unzip the module files yourself – Titanium doesn’t always find them within the .zip files as it’s supposed to.

The TUNE module can be downloaded from our repo:

Titanium module (in the dist folder)

As well as the Appcelerator Marketplace:

Android module
iOS module

Before you can download the TUNE SDK, make sure to add your app to the Attribution Analytics platform.


var mobileAppTracker = require("ti.mobileapptracker");
mobileAppTracker.initTracker("your_advertiser_ID", "your_conversion_key");
// Only if you have pre-existing users before MAT SDK implementation, identify these users
// using this code snippet.
// Otherwise, pre-existing users will be counted as new installs the first time they run your app.
//var isExistingUser = ...
//if (isExistingUser) {
//    mobileAppTracker.setExistingUser(true); 

* The Android INSTALL_REFERRER receiver is automatically added via mobile/android/timodule.xml

Advertising Identifiers

To increase the consistency and ease of attribution, consider collecting device identifiers as described in Unique Identifiers for Attribution.


The Google Advertising ID is automatically collected by the Titanium plugin.


The Apple Advertising ID is automatically collected by the Titanium plugin.

Things to Keep in Mind

The “your_advertiser_ID” and the “your_conversion_key” values correlate to the Advertiser ID and Conversion Key provided to you when you created the Mobile App (Step 3 in “Create Mobile App”) in platform. See Finding Advertiser ID and Conversion Key document for reference.

If your app already has a pre-existing user base (people who have already installed your app), TUNE has several options to flag these users as Pre-Existing Users to prevent attributing these users to a marketing partner. For information about migrating existing users, please visit handle existing users prior to SDK implementation.

Testing & Troubleshooting

To test the TUNE SDK implementation in your mobile app, you can do so straight from the Attribution Analytics platform itself rather than creating a test environment. Please visit Testing Your Mobile App.

Measuring Events

After you implement the TUNE SDK in your mobile app and start logging sessions, you can move on to logging a wide variety of in-app events such as registrations and in-app purchases.

By logging and analyzing in-app events, you can more efficiently optimize both the functionality of your app and your advertising strategies. Bottom line? Understanding how your users interact with your mobile app directly impacts your ability to build effective and profitable advertising campaigns by enabling you to compare retention, engagement, and lifetime value (LTV) to your costs.

Or to build your own custom event, please visit Event Builder.

In-App Events

Achievement Unlocked

Gaining access to additional functionality; generally by completion of a particular event or level.

Add to Cart

Including items in one's virtual shopping cart to be purchased.

Add to Wishlist

Including items in one's virtual list of wanted items not to be readily purchased.

Added Payment Info

Including one's payment information to be used for making purchases.

Checkout Initiated

Starting the checkout process once items have been added to one's cart and ready to complete the purchase.

Content View

Looking at or inspecting content on a page; essentially the rendering of the page.


Requesting someone to do something; for example, a friend invite or an app invite.

Level Achieved

Completing the necessary requirements to move on to the next stage; generally applies to gaming apps.


The process by which an individual gains access to their account by identifying and authenticating themselves.


Completing a purchase transaction in which one has bought an item.


Assigning a value to something according to a particular scale; e.g. 4 stars.


The act or process of entering information about one's self to create an account.


Arranging to have something (such as a table or seat) held for one's use at a later time.


Actively looking for or seeking out something via a keyword.


Giving others access to something; e.g. sending a link online content.

Spent Credits

Applying accumulated rewards/points as payment for an item.

Tutorial Complete

Finishing a lesson or instructions on how to do/achieve something.