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:
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();
* 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.
In-App Events
Gaining access to additional functionality; generally by completion of a particular event or level.
Including items in one's virtual shopping cart to be purchased.
Including items in one's virtual list of wanted items not to be readily purchased.
Including one's payment information to be used for making purchases.
Starting the checkout process once items have been added to one's cart and ready to complete the purchase.
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.
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.
Applying accumulated rewards/points as payment for an item.
Finishing a lesson or instructions on how to do/achieve something.