Alke Analytics SDK

Quick Start

Get started with Alke Analytics in minutes. Choose your platform below.

1. Include the Collector Script

Add the script to your HTML <head>:

<script src="https://cdn-analytics.alketech.eu/collector.js"></script>

2. Configure the SDK

Initialize with your property ID:

alkeAnalytics.setConfig({
    propertyId: 'your-property-uuid',
    autoPushPageview: true
});

With autoPushPageview: true, a pageview is automatically tracked when the SDK initializes.

3. Track Pageviews (SPA)

For single-page applications, disable auto-tracking and, on each route change, call pushNavigation() then pushPageView(). pushNavigation() is the page boundary: it closes the page being left and opens the next pageviewId. Without it the whole visit collapses into a single pageview, and its entire ad revenue is written on every route.

alkeAnalytics.setConfig({
    propertyId: 'your-property-uuid',
    autoPushPageview: false
});

// On each route change, once the router has rendered
alkeAnalytics.pushNavigation();
alkeAnalytics.pushPageView();

4. Add Custom Dimensions

Enrich your tracking data with custom dimensions:

alkeAnalytics.setCustomData(1, 'category_tech');
alkeAnalytics.setCustomData(2, 'author_john');
alkeAnalytics.setCustomData(3, 42);

alkeAnalytics.pushPageView();

Complete Example

<!DOCTYPE html>
<html>
<head>
    <script src="https://cdn-analytics.alketech.eu/collector.js"></script>
    <script>
        alkeAnalytics.setConfig({
            propertyId: 'your-property-uuid',
            autoPushPageview: false
        });

        // Set article metadata
        alkeAnalytics.setCustomData(1, 'technology');
        alkeAnalytics.setCustomData(2, 'John Doe');

        // Track the pageview
        alkeAnalytics.pushPageView();
    </script>
</head>
<body>
    <!-- Your content -->
</body>
</html>

1. Add the Swift Package

In Xcode, go to File > Add Package Dependencies and add:

https://github.com/alketech/alke-analytics-ios

2. Configure the SDK

In your AppDelegate or App.init:

import AlkeAnalytics

@main
struct MyApp: App {
    init() {
        AlkeAnalytics.setConfig(AlkeConfig(
            propertyId: "your-property-uuid",
            appVersion: "1.0.0"
        ))
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

3. Track Pageviews

Track pageviews when screens appear:

struct ArticleView: View {
    let article: Article

    var body: some View {
        ScrollView {
            // Content
        }
        .onAppear {
            AlkeAnalytics.pushPageView(
                url: "myapp://article/\(article.id)",
                title: article.title
            )
        }
        .onDisappear {
            AlkeAnalytics.flush()
        }
    }
}

4. Add Custom Dimensions

Include custom data with your pageviews:

AlkeAnalytics.pushPageView(
    url: "myapp://article/\(article.id)",
    title: article.title,
    customData: [
        1: article.category,
        2: article.author,
        3: article.wordCount
    ]
)

Or set them separately:

AlkeAnalytics.setCustomData(1, value: "technology")
AlkeAnalytics.setCustomData(2, value: "John Doe")

Complete Example

import SwiftUI
import AlkeAnalytics

@main
struct NewsApp: App {
    init() {
        AlkeAnalytics.setConfig(AlkeConfig(
            propertyId: "your-property-uuid",
            appVersion: Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String ?? "1.0.0"
        ))
    }

    var body: some Scene {
        WindowGroup {
            ArticleListView()
        }
    }
}

struct ArticleDetailView: View {
    let article: Article

    var body: some View {
        ScrollView {
            VStack(alignment: .leading, spacing: 16) {
                Text(article.title).font(.title)
                Text(article.content)
            }
            .padding()
        }
        .onAppear {
            AlkeAnalytics.pushPageView(
                url: "newsapp://article/\(article.id)",
                title: article.title,
                customData: [
                    1: article.category,
                    2: article.author
                ]
            )
        }
        .onDisappear {
            AlkeAnalytics.flush()
        }
    }
}

1. Add the Dependency

In your build.gradle.kts:

dependencies {
    implementation("tech.alke:analytics:1.0.0")
}

2. Configure the SDK

In your Application.onCreate():

import tech.alke.analytics.AlkeAnalytics
import tech.alke.analytics.AlkeConfig

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        AlkeAnalytics.setConfig(
            context = this,
            config = AlkeConfig(
                propertyId = "your-property-uuid",
                appVersion = BuildConfig.VERSION_NAME
            )
        )
    }
}

3. Track Pageviews

Track pageviews in your Activities or Composables:

@Composable
fun ArticleScreen(article: Article) {
    LaunchedEffect(article.id) {
        AlkeAnalytics.pushPageView(
            url = "myapp://article/${article.id}",
            title = article.title
        )
    }

    DisposableEffect(Unit) {
        onDispose {
            AlkeAnalytics.flush()
        }
    }

    // Screen content
}

4. Add Custom Dimensions

Include custom data with your pageviews:

AlkeAnalytics.pushPageView(
    url = "myapp://article/${article.id}",
    title = article.title,
    customData = mapOf(
        1 to article.category,
        2 to article.author,
        3 to article.wordCount
    )
)

Or set them separately:

AlkeAnalytics.setCustomData(1, "technology")
AlkeAnalytics.setCustomData(2, "John Doe")

Complete Example

// Application.kt
class NewsApp : Application() {
    override fun onCreate() {
        super.onCreate()

        AlkeAnalytics.setConfig(
            context = this,
            config = AlkeConfig(
                propertyId = "your-property-uuid",
                appVersion = BuildConfig.VERSION_NAME,
                debugMode = BuildConfig.DEBUG
            )
        )
    }
}

// ArticleDetailScreen.kt
@Composable
fun ArticleDetailScreen(
    articleId: String,
    viewModel: ArticleViewModel = viewModel()
) {
    val article by viewModel.article.collectAsState()

    LaunchedEffect(article) {
        article?.let {
            AlkeAnalytics.pushPageView(
                url = "newsapp://article/${it.id}",
                title = it.title,
                customData = mapOf(
                    1 to it.category,
                    2 to it.author
                )
            )
        }
    }

    DisposableEffect(Unit) {
        onDispose {
            AlkeAnalytics.flush()
        }
    }

    // Screen content
    article?.let { ArticleContent(it) }
}

Features

Feature	Description
Privacy First	Full GDPR and IAB TCF 2.0 compliance with consent-aware tracking
Cross-Platform	Native SDKs for iOS, tvOS, Android, and Android TV
Real-Time Events	Track pageviews, custom events, and engagement in real-time
Custom Dimensions	Up to 10 custom data fields per event

Quick Start

1. Include the Collector Script

2. Configure the SDK

3. Track Pageviews (SPA)

4. Add Custom Dimensions

Complete Example

1. Add the Swift Package

2. Configure the SDK

3. Track Pageviews

4. Add Custom Dimensions

Complete Example

1. Add the Dependency

2. Configure the SDK

3. Track Pageviews

4. Add Custom Dimensions

Complete Example

Features

Next Steps