URLs & Deeplinks - Alke Analytics Documentation

Cross-Platform URL Strategy

Alke Analytics allows you to reconcile audiences across all platforms (web, iOS, Android) by using the same URLs for the same content. This enables unified reporting where a single article or video shows combined metrics from all sources.

The Goal

Platform	Content	URL
Web	Article #123	`https://example.com/article/123`
iOS App	Article #123	`https://example.com/article/123`
Android App	Article #123	`https://example.com/article/123`

When all platforms use the same URL, your reports show total audience regardless of how users access your content.

Implementation

Option 1: Use Web URLs (Recommended)

If your app supports Universal Links (iOS) or App Links (Android), use the actual web URL:

// Use the same URL as your website
AlkeAnalytics.trackPageview(
    url: "https://example.com/article/123",
    title: "Article Title"
)

// From a Universal Link
func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
    guard let url = userActivity.webpageURL else { return }

    AlkeAnalytics.trackPageview(
        url: url.absoluteString,
        title: pageTitle
    )
}

// Use the same URL as your website
AlkeAnalytics.trackPageview(
    url = "https://example.com/article/123",
    title = "Article Title"
)

// From an App Link
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    intent?.data?.let { uri ->
        AlkeAnalytics.trackPageview(
            url = uri.toString(),
            title = pageTitle
        )
    }
}

Option 2: Build Matching URLs

If you don’t have the web URL available, construct it to match your website structure:

// Build a URL that matches your web structure
let baseURL = "https://example.com"

// Article
AlkeAnalytics.trackPageview(
    url: "\(baseURL)/article/\(article.id)",
    title: article.title
)

// Category
AlkeAnalytics.trackPageview(
    url: "\(baseURL)/category/\(category.slug)",
    title: category.name
)

// Video
AlkeAnalytics.trackPageview(
    url: "\(baseURL)/video/\(video.id)",
    title: video.title
)

// Build a URL that matches your web structure
val baseURL = "https://example.com"

// Article
AlkeAnalytics.trackPageview(
    url = "$baseURL/article/${article.id}",
    title = article.title
)

// Category
AlkeAnalytics.trackPageview(
    url = "$baseURL/category/${category.slug}",
    title = category.name
)

// Video
AlkeAnalytics.trackPageview(
    url = "$baseURL/video/${video.id}",
    title = video.title
)

Option 3: App-Only Screens

For screens that don’t exist on web (settings, onboarding, etc.), use a consistent scheme:

// App-only screens
AlkeAnalytics.trackPageview(
    url: "app://settings",
    title: "Settings"
)

AlkeAnalytics.trackPageview(
    url: "app://onboarding/step-2",
    title: "Onboarding - Step 2"
)

// App-only screens
AlkeAnalytics.trackPageview(
    url = "app://settings",
    title = "Settings"
)

AlkeAnalytics.trackPageview(
    url = "app://onboarding/step-2",
    title = "Onboarding - Step 2"
)

Lifecycle Integration

Track pageviews when screens appear:

struct ArticleView: View {
    let article: Article

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

class ArticleFragment : Fragment() {

    override fun onResume() {
        super.onResume()

        AlkeAnalytics.trackPageview(
            url = "https://example.com/article/${article.id}",
            title = article.title
        )
    }

    override fun onPause() {
        super.onPause()
        AlkeAnalytics.flush()
    }
}

URL Consistency

Document your URL mapping between web and mobile to ensure all teams use the same patterns. This is key to accurate cross-platform reporting.