Skip to main content

LoudCrowd Mobile SDK Installation Guide

LoudCrowd provides SDKs that bring LoudCrowd’s full suite of eCommerce and affiliate features to your iOS and Android mobile apps, including: Creator Storefronts, Shoppable Video, ShopWith, affiliate deep links and attribution.

C
Written by Customer Success
Updated over 3 weeks ago

Summary

LoudCrowd's Mobile SDKs lets you:

  • Embed Creator Storefronts, ShopWith Widget and Shoppable Video experiences in your native mobile app (rendered via WebView components styled to your brand). Default components are WebView-based for parity and speed, with a thin native bridge for cart/navigation and analytics.

  • Offer creators a secure OTP login and in‑app tools to manage their Storefronts and generate affiliate deep links.

  • Route users to mobile app or web automatically based on your rules.

  • Capture creator affiliate attribution for commissions payouts, and click analytics of user behavior to track buyer journeys, with consent management.

Included Features

  1. Creator Storefront — a page showing a creator’s media (video/images) and selected products.

  2. Creator List — a grid/list of creators linking to storefronts.

  3. Creator OTP Auth & Creator Mode — one‑time‑password login to access creator tools.

  4. Creator Mode & Widget — Logged‑in creators can inline‑edit their Storefront page and access floating controls on product pages to add to Storefront and create affiliate deep links.

  5. ShopWith Widget — floating chat‑style PDP overlay for creator recommendations and media.

  6. Affiliate Deep Links & Smart Routing — Generate links to app or web view of any ecomm landing page (Storefront, Homepage, Product, Collection pages), passing attribution parameters. Send users to app or web based on device and your rules.

  7. Attribution Web Events — track lc_anon_id across sessions and purchases to tie outcomes to affiliate links.

Pre-requisites

  1. App Requirements

    Your mobile apps must meet these requirements in order to be compatible with LoudCrowd SDKs:

    • iOS: iOS 15+, Xcode 15+, Swift 5.9+, ATS enabled.

    • Android: minSdk 23+, Kotlin, AndroidX, Compose or View-based apps.

    • Network access to your LoudCrowd domain(s) and media CDN (TLS 1.2+).

  2. Integrate your Ecomm Platform in the Loudcrowd application

    Create a new integration in the Loudcrowd app by navigating to the Integrations tab. This will allow us to create a dedicated ID for you to use when initializing Loudcrowd components in your native app.

iOS Quick Start

  1. Xcode → File ▸ Add Package Dependencies… → install the Loudcrowd SDK

  2. Initialize the SDK in your application

SwiftUI (App)

import LoudcrowdKit

@main
struct YourApp: App {
init() {
Loudcrowd.shared.configure(.init(
shopId: "YOUR_SHOP_ID"
))
}
var body: some Scene { WindowGroup { RootView() } }
}

UIKit (App / SceneDelegate)

import LoudcrowdKit

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options: UIScene.ConnectionOptions) {
Loudcrowd.shared.configure(.init(
shopId: "YOUR_SHOP_ID"
))
}
```swift
import LoudcrowdKit

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options: UIScene.ConnectionOptions) {
Loudcrowd.shared.configure(.init(
shopId: "YOUR_SHOP_ID"
))
}

Android Quick Start

  1. Add the dependency (build.gradle.kts)

dependencies {
implementation("com.loudcrowd:loudcrowdkit-android:1.0.0")
}


2. Initialize the SDK in your application (settings.gradle.kts)

// MyApp.kt
@HiltAndroidApp // optional DI
class MyApp : Application() {
override fun onCreate() {
super.onCreate()
Loudcrowd.configure(
LCConfig(
shopId = "YOUR_SHOP_ID"
)
)
}
}

Deep linking, smart routing & affiliate links — routing

The SDK decides where product taps and CTAs open based on a routing mode you set in the Loudcrowd Brand App. You can also defer entirely to your existing deep-link provider.

  • defer to deep link technology — routing is determined by your provider; the SDK does not choose a destination

  • auto (default) — try the app deep link first; if the app isn’t installed, fall back to the web

  • app — prompt the user to open or install the app

  • web — always route to the web, even if the app is installed

Notes:

  • Affiliate links (with attribution params) work with all modes.

  • If you implement the optional Commerce Bridge, native openProduct/addToCart can take precedence over routing.

Accessibility

  • Screen readers: VoiceOver (iOS) and TalkBack (Android) labels on all interactive elements

  • Text sizing: Dynamic Type / system font scaling respected throughout

  • Contrast: palettes meet recommended contrast ratios for legibility

  • Keyboard navigation: focus order and actions supported for interactive controls

Security

  • Transport: all SDK and component API calls use HTTPS

  • Token storage: creator/session tokens stored securely (Keychain on iOS, EncryptedSharedPreferences on Android) when persistence is enabled

  • Data minimization: no third-party tracking libraries; only the minimum identifiers required for functionality and attribution

  • Optional app attestation: integration points available for iOS App Attest and Android Play Integrity (disabled by default; enable if your security policy requires it)

Error handling

  • Offline behavior: graceful fallback with cached content where available; clear offline state shown to users

  • Retries: automatic retry/backoff for transient failures; circuit breaker to prevent thrashing on persistent errors

  • UX: inline error messages with actionable copy and retry buttons

  • Observability: errors surfaced via SDK events/logs so you can monitor and alert in your own analytics tools

Did this answer your question?