Purchase

The purchase event occurs when a user completes the checkout process. If these purchase events are for in-app purchases, then use our in-app purchase verification with this event as well. Each SKU or line item in the shopping cart should have its own event item. Note: You can also setup the SDK to collect in-app purchase validation receipts from both the Apple® iTunes® App Store and Google Play™ Store.

• User ID (recommended)
• Facebook User ID (recommended if authentication with Facebook)
• Twitter User ID (recommended if authentication with Twitter)
• Google User ID (recommended if authentication with Google)
• Latitude (optional)
• Longitude (optional)
• Altitude (optional)
• Event Items Array of event items passed into measureEvent (recommended)
  • Event item (SKU) for a purchase should include:
    • Name – name of the item
    • Product ID – SKU
    • Unit Price – individual price of one unit
    • Quantity – number of items purchased
    • Revenue – total value of the purchase
• Order or Receipt ID (recommended; passed as referenceID into measureEvent)
• Revenue (recommended; passed into measureAction)
  • NOTE: You can also pass a negative purchase value to reflect transactions like refunds. This negative value will also be included in the Sum total in reporting.
• Currency Code (recommended if Revenue set; passed into measureEvent)

Tune.instance.setUserId("userId");
Tune.instance.setFacebookUserId("facebookUserId");
Tune.instance.setGoogleUserId("googleUserId");
Tune.instance.setTwitterUserId("twitterUserId");
Tune.instance.setLocation(47.61, -122.33, 55);
 
var tuneEvent:Dictionary = new Dictionary();
tuneEvent.name = "purchase";
tuneEvent.revenue = 0.99;
tuneEvent.currency = "USD";
tuneEvent.advertiserRefId = "12999748531";
tuneEvent.eventItems = eventItems;
 
Tune.instance.measureEvent(tuneEvent);

mobileAppTracker.setUserId("userId");
mobileAppTracker.setFacebookUserId("facebookUserId");
mobileAppTracker.setGoogleUserId("googleUserId");
mobileAppTracker.setTwitterUserId("twitterUserId");
mobileAppTracker.setLocation(47.61, -122.33, 55);
 
var matEvent:Dictionary = new Dictionary();
matEvent.name = "purchase";
matEvent.revenue = 0.99;
matEvent.currency = "USD";
matEvent.advertiserRefId = "12999748531";
matEvent.eventItems = eventItems;
 
mobileAppTracker.measureEvent(matEvent);

ITune tune = Tune.getInstance();
tune.setUserId("userId");
tune.setFacebookUserId("facebookUserId");
tune.setGoogleUserId("googleUserId");
tune.setTwitterUserId("twitterUserId");
tune.setLocation(location);
tune.measureEvent(new TuneEvent(TuneEvent.PURCHASE)
                                   .withEventItems(eventItems)
                                   .withRevenue(0.99)
                                   .withCurrencyCode("USD")
                                   .withAdvertiserRefId("12999748531"));

Tune tune = Tune.getInstance();
tune.setUserId("userId");
tune.setFacebookUserId("facebookUserId");
tune.setGoogleUserId("googleUserId");
tune.setTwitterUserId("twitterUserId");
tune.setLocation(location);
tune.measureEvent(new TuneEvent(TuneEvent.PURCHASE)
                                   .withEventItems(eventItems)
                                   .withRevenue(0.99)
                                   .withCurrencyCode("USD")
                                   .withAdvertiserRefId("12999748531"));

sdkbox::PluginTune::setUserId("userId");
sdkbox::PluginTune::setFacebookUserId("facebookUserId");
sdkbox::PluginTune::setGoogleUserId("googleUserId");
sdkbox::PluginTune::setTwitterUserId("twitterUserId");
sdkbox::PluginTune::setLatitude(47.61f, -122.33f, 55f);
 
TuneEvent event;
event.eventName = "purchase";
event.revenue = 0.99;
event.currencyCode = "USD";
event.refId = "12999748531";
event.eventItems = eventItems;
 
sdkbox::PluginTune::measureEvent(event);

TuneEventItem *item1 = [TuneEventItem eventItemWithName:@"ball1" unitPrice:3.99 quantity:2];
TuneEventItem *item2 = [TuneEventItem eventItemWithName:@"ball2" unitPrice:9.99 quantity:1 revenue:9.99 attribute1:@"red" attribute2:@"inflatable" attribute3:@"rubber" attribute4:nil attribute5:nil];
NSArray *eventItems = @[item1, item2];
 
[Tune setUserId:@"US13579"];
[Tune setFacebookUserId:@"321321321321"];
[Tune setGoogleUserId:@"11223344556677"];
[Tune setTwitterUserId:@"1357924680"];
 
TuneLocation *loc = [TuneLocation new];
loc.latitude = @(9.142276);
loc.longitude = @(-79.724052);
loc.altitude = @(15.);
[Tune setLocation:loc];
 
TuneEvent *event = [TuneEvent eventWithName:TUNE_EVENT_PURCHASE];
event.eventItems = eventItems;
event.refId = @"ref13571";
event.revenue = 13.97;
event.currencyCode = @"USD";
 
[Tune measureEvent:event];

MobileAppTracker.setUserId("userId");
MobileAppTracker.setFacebookUserId("facebookUserId");
MobileAppTracker.setGoogleUserId("googleUserId");
MobileAppTracker.setTwitterUserId("twitterUserId");
MobileAppTracker.setLatitude(47.61);
MobileAppTracker.setLongitude(-122.33);
MobileAppTracker.setAltitude(55);
MobileAppTracker.measureAction({"eventName":    "purchase",
                                "revenue":      0.99,
                                "currencyCode": "USD",
                                "referenceId":  "12999748531",
                                "eventItems":   eventItems});

window.plugins.tunePlugin.setUserId("userId");
window.plugins.tunePlugin.setFacebookUserId("facebookUserId");
window.plugins.tunePlugin.setGoogleUserId("googleUserId");
window.plugins.tunePlugin.setTwitterUserId("twitterUserId");
window.plugins.tunePlugin.setLocationWithAltitude(47.61, -122.33, 55);
 
var tuneEvent = {
    "name": "purchase",
    "eventItems": eventItems,
    "revenue": 0.99,
    "currency": "USD",
    "advertiserRefId": "12999748531"
};
 
window.plugins.tunePlugin.measureEvent(tuneEvent);

mobileAppTracker.setUserId("userId");
mobileAppTracker.setFacebookUserId("facebookUserId");
mobileAppTracker.setGoogleUserId("googleUserId");
mobileAppTracker.setTwitterUserId("twitterUserId");
mobileAppTracker.setLocationWithAltitude(47.61, -122.33, 55);
 
var matEvent = {
    "name": "purchase",
    "eventItems": eventItems,
    "revenue": 0.99,
    "currency": "USD",
    "advertiserRefId": "12999748531"
};
 
mobileAppTracker.measureEvent(matEvent);

using TuneSDK;
 
Tune.SetUserId("userId");
Tune.SetFacebookUserId("facebookUserId");
Tune.SetGoogleUserId("googleUserId");
Tune.SetTwitterUserId("twitterUserId");
Tune.SetLocation(47.61, -122.33, 55);
 
TuneEvent tuneEvent = new TuneEvent("purchase");
tuneEvent.eventItems = eventItems;
tuneEvent.revenue = 0.99;
tuneEvent.currencyCode = "USD";
tuneEvent.advertiserRefId = "12999748531";
 
Tune.MeasureEvent(tuneEvent);

MATBinding.SetUserId("userId");
MATBinding.SetFacebookUserId("facebookUserId");
MATBinding.SetGoogleUserId("googleUserId");
MATBinding.SetTwitterUserId("twitterUserId");
MATBinding.SetLocation(47.61, -122.33, 55);
 
MATEvent matEvent = new MATEvent("purchase");
matEvent.eventItems = eventItems;
matEvent.revenue = 0.99;
matEvent.currencyCode = "USD";
matEvent.advertiserRefId = "12999748531";
 
MATBinding.MeasureEvent(matEvent);

mobileAppTracker.SetUserId("userId");
mobileAppTracker.SetFacebookUserId("facebookUserId");
mobileAppTracker.SetGoogleUserId("googleUserId");
mobileAppTracker.SetTwitterUserId("twitterUserId");
mobileAppTracker.SetLatitude(47.61);
mobileAppTracker.SetLongitude(-122.33);
mobileAppTracker.SetAltitude(55);
mobileAppTracker.MeasureAction("purchase", 0.99, "USD", "12999748531", eventItems);

using TuneSDK;

Tune.SetUserId ("userId");
Tune.SetFacebookUserId ("facebookId");
Tune.SetGoogleUserId ("googleId");
Tune.SetTwitterUserId ("twitterId");
Tune.SetAge (age);
Tune.SetGender (gender); // 0 for male, 1 for female, 2 for other
TuneLocation sampleLocation = new TuneLocation ();
sampleLocation.SetLatitude (latitude);
sampleLocation.SetLongitude (longitude);
sampleLocation.SetAltitude (altitude);
Tune.SetLocation (sampleLocation);

TuneEvent evt = TuneEvent.EventWithName ("purchase");
evt.RefId = "ref10";
evt.CurrencyCode = "USD";
evt.Revenue = 132.6f;
evt.CurrencyCode = "USD";
evt.TransactionState = 0; // from StoreKit transaction state
evt.Receipt = iTunesIAPReceipt;
TuneEventItem item1 = TuneEventItem.EventItemWithName("item1", 0.99f, 1, 0.99f, "red", "inflatable", "rubber", "", "");
TuneEventItem item2 = TuneEventItem.EventItemWithName("item2", 0.50f, 2, 1.0f);
evt.EventItems = new TuneEventItem[] { item1, item2 };
Tune.MeasureEvent(evt);

using TuneSDK;

Tune.Instance.SetUserId("userId");
Tune.Instance.SetFacebookUserId("facebookUserId");
Tune.Instance.SetGoogleUserId("googleUserId");
Tune.Instance.SetTwitterUserId("twitterUserId");
Tune.Instance.SetLocation(location);

Tune.Instance.MeasureEvent(new TuneEvent(TuneEvent.Purchase)
                                   .WithEventItems(eventItems)
                                   .WithRevenue(0.99)
                                   .WithCurrencyCode("USD")
                                   .WithAdvertiserRefId("12999748531"));

Select a preferred platform.

Note: In-App Marketing does not support events or event item data for Purchase. Please see our Event Measurement and the Event Tags documentation for more information.