Settings for Event Characteristics | TUNE Docs (Legacy)

The following table shows a complete list of all the Event Characteristics setter methods that you can call in the AA SDK. To find the appropriate calls, select the platform/plugin that your app supports. For information about more custom setter methods please visit the Custom SDK Settings forum.

Event Characteristics
Parameter	Type	Description
Content ID	String	To pass in the Event Content ID (International Article Number (EAN) when applicable, or other product or content identifier), you can set the Content ID by calling the `setEventContentId` method for the SDK.
Content Type	String	To pass in the Event Content Type (for example, “shoes”), you can set the Content Type by calling the `setEventContentType` method for the SDK.
Date 1	Datetime	To pass the date of the Event, you can set the first Date by calling the`setEventDate1` method for the SDK.
Date 2	Datetime	To pass a second date for the Event, you can set the second Date by calling the `setEventDate2` method for the SDK.
Level	Integer	To pass in the Event level, you can set the Level by calling the`setEventLevel` method for the SDK.
Quantity	Integer	To pass in a Quantity tied to the Event, you can set the Quantity by calling the `setEventQuantity` method for the SDK.
Rating	Double	To pass in a Rating for an Event, you can set the Rating by calling the `setEventRating` method for the SDK.
Search String	String	To pass in the Search String tied to an Event, you can set the Search String by calling `setEventSearchString` method for the SDK.
Currency Code	Double	The SDK sets the currency to “USD” by default. You can override the default currency by setting the currency using the “setCurrencyCode” method. Please see ISO Currency Codes for a list of acceptable currency codes.
Custom Attributes	String	To pass in any specific attribute about an event, the SDK provides `setEventAttribute1` through `setEventAttribute5` methods so you can associate arbitrary string content with any event.

Preferred Platform and Version and Version and Version and Version and Version and Version and Version and Version and Version and Version

Event Characteristics Adobe Air Plugin Version 3.2-3.7

mobileAppTracker.setEventContentId("content_id");
mobileAppTracker.setEventContentType("content_type");
mobileAppTracker.setEventDate1(date1);
mobileAppTracker.setEventDate2(date2);
mobileAppTracker.setEventLevel(level);
mobileAppTracker.setEventQuantity(quantity);
mobileAppTracker.setEventRating(rating);
mobileAppTracker.setEventSearchString("search_string");
mobileAppTracker.setEventAttribute1("my custom value");
mobileAppTracker.setEventAttribute2("my custom value");
mobileAppTracker.setEventAttribute3("my custom value");
mobileAppTracker.setEventAttribute4("my custom value");
mobileAppTracker.setEventAttribute5("my custom value");

Event Characteristics Android SDK Version 4.0+

TuneEvent tuneEvent = new TuneEvent("event_name")
                        .withContentId("content_id")
                        .withContentType("content_type")
                        .withDate1(date1)
                        .withDate2(date2)
                        .withLevel(level)
                        .withQuantity(quantity)
                        .withRating(rating)
                        .withSearchString("search_string")
                        .withAttribute1("my custom value")
                        .withAttribute2("my custom value")
                        .withAttribute3("my custom value")
                        .withAttribute4("my custom value")
                        .withAttribute5("my custom value");
tune.measureEvent(tuneEvent);

Event Characteristics Android SDK Version 3.8-3.11

MATEvent matEvent = new MATEvent("event_name")
                        .withContentId("content_id")
                        .withContentType("content_type")
                        .withDate1(date1)
                        .withDate2(date2)
                        .withLevel(level)
                        .withQuantity(quantity)
                        .withRating(rating)
                        .withSearchString("search_string")
                        .withAttribute1("my custom value")
                        .withAttribute2("my custom value")
                        .withAttribute3("my custom value")
                        .withAttribute4("my custom value")
                        .withAttribute5("my custom value");
mobileAppTracker.measureEvent(matEvent);

Event Characteristics Android SDK Version 3.2-3.7

mobileAppTracker.setEventContentId("content_id");
mobileAppTracker.setEventContentType("content_type");
mobileAppTracker.setEventDate1(date1);
mobileAppTracker.setEventDate2(date2);
mobileAppTracker.setEventLevel(level);
mobileAppTracker.setEventQuantity(quantity);
mobileAppTracker.setEventRating(rating);
mobileAppTracker.setEventSearchString("search_string");
mobileAppTracker.setEventAttribute1("my custom value");
mobileAppTracker.setEventAttribute2("my custom value");
mobileAppTracker.setEventAttribute3("my custom value");
mobileAppTracker.setEventAttribute4("my custom value");
mobileAppTracker.setEventAttribute5("my custom value");

Event Characteristics Cocos2dx Plugin Version 3.2-3.7

PluginParam pContentId("content_id");
pluginMat->callFuncWithParam("setEventContentId", &pContentId, NULL);
 
PluginParam pContentType("content_type");
pluginMat->callFuncWithParam("setEventContentType", &pContentType, NULL);
 
PluginParam pDate1("date1");
pluginMat->callFuncWithParam("setEventDate1", &pDate1, NULL);
 
PluginParam pDate1("date2");
pluginMat->callFuncWithParam("setEventDate2", &pDate2, NULL);
 
PluginParam pLevel("level");
pluginMat->callFuncWithParam("setEventLevel", &pLevel, NULL);
 
PluginParam pQuantity("quantity");
pluginMat->callFuncWithParam("setEventQuantity", &pQuantity, NULL);
 
PluginParam pRating("rating");
pluginMat->callFuncWithParam("setEventRating", &pRating, NULL);
 
PluginParam pSearchString("search_string");
pluginMat->callFuncWithParam("setEventSearchString", &pSearchString, NULL);
 
PluginParam pAttr1("my custom value");
pluginMat->callFuncWithParam("setEventAttribute1", &pAttr1, NULL);
PluginParam pAttr2("my custom value");
pluginMat->callFuncWithParam("setEventAttribute2", &pAttr2, NULL);
PluginParam pAttr3("my custom value");
pluginMat->callFuncWithParam("setEventAttribute3", &pAttr3, NULL);
PluginParam pAttr4("my custom value");
pluginMat->callFuncWithParam("setEventAttribute4", &pAttr4, NULL);
PluginParam pAttr5("my custom value");
pluginMat->callFuncWithParam("setEventAttribute5", &pAttr5, NULL);

Event Characteristics iOS SDK Version 3.9+

MATEvent *event = [MATEvent eventWithName:@"purchase"];
event.contentId = @"5768";
event.contentType = @"shoes";
event.date1 = [NSDate date];
event.date2 = nil;
event.level = 11;
event.quantity = 2;
event.rating = 4.5;
event.searchString = @"black leather shoes";
event.attribute1 = @"men";
event.attribute2 = @"black";
event.attribute3 = @"leather";
event.attribute4 = @"slip-on";
event.attribute5 = @"skid resistant sole";
 
[MobileAppTracker measureEvent:event];

Event Characteristics iOS SDK Version 3.2-3.8

[MobileAppTracker setEventContentId:@"5768"];
[MobileAppTracker setEventContentType:@"shoes"];
[MobileAppTracker setEventDate1:[NSDate date]];
[MobileAppTracker setEventDate2:nil];
[MobileAppTracker setEventLevel:11];
[MobileAppTracker setEventQuantity:2];
[MobileAppTracker setEventRating:4.5];
[MobileAppTracker setEventSearchString:@"black leather shoes"];
[MobileAppTracker setEventAttribute1:@"men"];
[MobileAppTracker setEventAttribute2:@"black"];
[MobileAppTracker setEventAttribute3:@"leather"];
[MobileAppTracker setEventAttribute4:@"slip-on"];
[MobileAppTracker setEventAttribute5:@"skid resistant sole"];
 
[MobileAppTracker measureAction:@"purchase"];

Event Characteristics iOS SDK Version 3.10+

TuneEvent *event = [TuneEvent eventWithName:@"purchase"];
event.contentId = @"5768";
event.contentType = @"shoes";
event.date1 = [NSDate date];
event.date2 = nil;
event.level = 11;
event.quantity = 2;
event.rating = 4.5;
event.searchString = @"black leather shoes";
event.attribute1 = @"men";
event.attribute2 = @"black";
event.attribute3 = @"leather";
event.attribute4 = @"slip-on";
event.attribute5 = @"skid resistant sole";
 
[Tune measureEvent:event];

Event Characteristics Javascript SDK Version 3.2

MobileAppTracker.setEventContentId("content_id");
MobileAppTracker.setEventContentType("content_type");
MobileAppTracker.setEventDate1(date1);
MobileAppTracker.setEventDate2(date2);
MobileAppTracker.setEventLevel(level);
MobileAppTracker.setEventQuantity(quantity);
MobileAppTracker.setEventRating(rating);
MobileAppTracker.setEventSearchString("search_string");
MobileAppTracker.setEventAttribute1("my custom value");
MobileAppTracker.setEventAttribute2("my custom value");
MobileAppTracker.setEventAttribute3("my custom value");
MobileAppTracker.setEventAttribute4("my custom value");
MobileAppTracker.setEventAttribute5("my custom value");

Event Characteristics PhoneGap Plugin Version 3.2-3.7

mobileAppTracker.setEventContentId(successCallback, failureCallback, "content_id");
mobileAppTracker.setEventContentType(successCallback, failureCallback, "content_type");
mobileAppTracker.setEventDate1(successCallback, failureCallback, date1);
mobileAppTracker.setEventDate2(successCallback, failureCallback, date2);
mobileAppTracker.setEventLevel(successCallback, failureCallback, level);
mobileAppTracker.setEventQuantity(successCallback, failureCallback, quantity);
mobileAppTracker.setEventRating(successCallback, failureCallback, rating);
mobileAppTracker.setEventSearchString(successCallback, failureCallback, "search_string");
mobileAppTracker.setEventAttribute1(successCallback, failureCallback, "my custom value");
mobileAppTracker.setEventAttribute2(successCallback, failureCallback, "my custom value");
mobileAppTracker.setEventAttribute3(successCallback, failureCallback, "my custom value");
mobileAppTracker.setEventAttribute4(successCallback, failureCallback, "my custom value");
mobileAppTracker.setEventAttribute5(successCallback, failureCallback, "my custom value");

Event Characteristics Unity Plugin Version 3.9+

TuneItem item1 = new TuneItem();
item1.name = "shoes";
item1.unitPrice = 5;
item1.quantity = 2;
item1.revenue = 10;
item1.attribute1 = "men";
item1.attribute3 = "leather";
 
TuneItem[] eventItems = { item1 };
 
TuneEvent tuneEvent = new TuneEvent("purchase");
tuneEvent.revenue = 10;
tuneEvent.currencyCode = "AUD";
tuneEvent.advertiserRefId = "ref222";
tuneEvent.attribute1 = "men";
tuneEvent.attribute2 = "black";
tuneEvent.attribute3 = "leather";
tuneEvent.attribute4 = "slip-on";
tuneEvent.attribute5 = "skid resistant sole";
tuneEvent.contentType = "shoes";
tuneEvent.contentId = "5768";
tuneEvent.date1 = DateTime.UtcNow;
tuneEvent.level = 11;
tuneEvent.quantity = 2;
tuneEvent.rating = 4.5;
tuneEvent.searchString = "black leather shoes";
tuneEvent.eventItems = eventItems;
// transaction state may be set to the value received from the iOS/Android app store.
tuneEvent.transactionState = 1;
 
#if UNITY_IPHONE
tuneEvent.receipt = "<base64-encoded-receipt-data-from-app-store>";
#endif
 
Tune.MeasureEvent(tuneEvent);

Event Characteristics Windows SDK Version 3.2

mobileAppTracker.SetEventContentId("content_id");
mobileAppTracker.SetEventContentType("content_type");
mobileAppTracker.SetEventDate1(date1);
mobileAppTracker.SetEventDate2(date2);
mobileAppTracker.SetEventLevel(level);
mobileAppTracker.SetEventQuantity(quantity);
mobileAppTracker.SetEventRating(rating);
mobileAppTracker.SetEventSearchString("search_string");
mobileAppTracker.SetEventAttribute1("my custom value");
mobileAppTracker.SetEventAttribute2("my custom value");
mobileAppTracker.SetEventAttribute3("my custom value");
mobileAppTracker.SetEventAttribute4("my custom value");
mobileAppTracker.SetEventAttribute5("my custom value");

Event Characteristics Xamarin Plugin Version 3.2-3.7 for iOS

MobileAppTracker.SetEventContentId("content_id");
MobileAppTracker.SetEventContentType("content_type");
MobileAppTracker.SetEventDate1(date1);
MobileAppTracker.SetEventDate2(date2);
MobileAppTracker.SetEventLevel(level);
MobileAppTracker.SetEventQuantity(quantity);
MobileAppTracker.SetEventRating(rating);
MobileAppTracker.SetEventSearchString("search_string");
MobileAppTracker.SetEventAttribute1("my custom value");
MobileAppTracker.SetEventAttribute2("my custom value");
MobileAppTracker.SetEventAttribute3("my custom value");
MobileAppTracker.SetEventAttribute4("my custom value");
MobileAppTracker.SetEventAttribute5("my custom value");

Event Characteristics Xamarin Plugin Version 3.2-3.7 for Android

MobileAppTracker.Instance.SetEventContentId("content_id");
MobileAppTracker.Instance.SetEventContentType("content_type");
MobileAppTracker.Instance.SetEventDate1(date1);
MobileAppTracker.Instance.SetEventDate2(date2);
MobileAppTracker.Instance.SetEventLevel(level);
MobileAppTracker.Instance.SetEventQuantity(quantity);
MobileAppTracker.Instance.SetEventRating(rating);
MobileAppTracker.Instance.SetEventSearchString("search_string");
MobileAppTracker.Instance.SetEventAttribute1("my custom value");
MobileAppTracker.Instance.SetEventAttribute2("my custom value");
MobileAppTracker.Instance.SetEventAttribute3("my custom value");
MobileAppTracker.Instance.SetEventAttribute4("my custom value");
MobileAppTracker.Instance.SetEventAttribute5("my custom value");

Event Characteristics

Select a preferred platform.