Analytics Events
Send instrumented event data into Fullstory
Domain-specific events captured by Fullstory add additional intelligence when you're searching across sessions and creating new user segments. You can define and capture these events with Fullstory custom events.
Parameters
eventName String required
A String containing the name of the event. Event names can be no longer than 250 characters.
eventProperties Dictionary required
A Dictionary containing additional information about the event that will be indexed by Fullstory. The maximum size is 512Kb.
Limits
- Sustained calls are limited to 60 calls per minute, with a burst limit of 40 calls per second.
- Arrays of objects will not be indexed (arrays of strings and numbers will be indexed).
Additional Information
- Objective-C
- Swift
[FS event:eventName properties:eventProperties]
Example Invocation
Adding a product to an e-commerce cart
NSDictionary *eventProperties = @{
@"cart_id_str" : @"130983678493",
@"product_id_str" : @"798ith22928347",
@"sku_str" : @"L-100",
@"category_str" : @"Clothing",
@"name_str" : @"Button Front Cardigan",
@"brand_str" : @"Bright & Bold",
@"variant_str" : @"Blue",
@"price_real" : @58.99,
@"quantity_real" : @1,
@"coupon_str" : @"25OFF",
@"position_int" : @3,
@"url_str" : @"https://www.example.com/product/path",
@"image_url_str" : @"https://www.example.com/product/path.jpg"
};
[FS event:@"Product Added" properties:eventProperties];
SaaS product subscription
NSDictionary *eventProperties = @{
@"uid_str" : @"750948353",
@"plan_name_str" : @"Professional",
@"plan_price_real" : @299,
@"plan_users_int" : @10,
@"days_in_trial_int" : @42,
@"feature_packs" : @[@"MAPS", @"DEV", @"DATA"]
};
[FS event:@"Subscribed" properties:eventProperties];
FS.event(name:eventName, properties:eventProperties)
Example Invocation
Adding a product to an e-commerce cart
let eventProperties: [String:Any] = [
"cart_id_str" : "130983678493",
"product_id_str" : "798ith22928347",
"sku_str" : "L-100",
"category_str" : "Clothing",
"name_str" : "Button Front Cardigan",
"brand_str" : "Bright & Bold",
"variant_str" : "Blue",
"price_real" : 58.99,
"quantity_real" : 1,
"coupon_str" : "25OFF",
"position_int" : 3,
"url_str" : "https://www.example.com/product/path",
"image_url_str" : "https://www.example.com/product/path.jpg"
]
FS.event("Product Added", properties: eventProperties)
SaaS product subscription
let eventProperties: [String:Any] = [
"uid_str": "750948353",
"plan_name_str": "Professional",
"plan_price_real": 299,
"plan_users_int": 10,
"days_in_trial_int": 42,
"feature_packs": ["MAPS", "DEV", "DATA"],
]
FS.event("Subscribed", properties: eventProperties)