Titanium Quick Start

Jump to: Supported TMC Solutions | Downloading the Plugin | Implementation | Advertising Identifiers | Things to Keep in Mind | Testing & Troubleshooting | Measuring Events | In-App Events

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.

Implementation

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); 
//}
 
mobileAppTracker.measureSession();

Select a preferred platform.

* 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.

Android

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

iOS

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.