📘

Before you begin

Make sure you have a working Storyly Placement SDK integration as described in the Initial Setup.

What is Storyly Analytics Module

Storyly Analytics Module is a lightweight module in Storyly Placement SDK for tracking product-related events (views, cart additions, wishlist additions, purchases) to enhance personalization in terms of product recommendation in Storyly content.

Setup SDK

Storyly Placement SDK integration covers the Storyly Analytics Module setup.

Import Module

You need to import related modules to use Storyly Analytics Module.

import StorylyAnalytics

Initialize Components

You need to call STRAnalytics.initialize(config:) once in your application initialization, AppDelegate.application(_:didFinishLaunchingWithOptions:).

func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
    let analyticsConfig = STRAnalyticsConfig.Builder()
        .setUserId(<end-user's id in your application>) // optional
        .build(token: <your_application_token_here>)

    STRAnalytics.initialize(config: config)
    return true
}

🚧

Warning

Please provide a valid token during initialization, otherwise the events are silently dropped.

Track Events

You can track product interactions anywhere in your application.

let product = STRAnalyticProduct(
	productId: ...,
  productGroupId: ...,
  title: ...,
  desc: ...
  price: ...,
	salesPrice: ...
)
STRAnalytics.track(productEvent: .Purchased, product: product)
// STRAnalytics.track(productEvent: STRAnalyticProductEvent, products: [STRAnalyticProduct])

📘

Tip

Please check STRAnalytics class reference.

📘

Tip

Please check STRAnalyticProduct class reference.

Product Analytic Events

This section shows the list of product analytic events and their description.

📘

Tip

Please check STRAnalyticProductEvent class reference.

📘

Best Practices

• You must initialize STRAnalytics with correct configuration.