​
Overview

This outlines the authentication and content delivery flow between the user, your mobile application, the Genuin SDK, and associated backend services. The process ensures secure user authentication, seamless content delivery, and comprehensive analytics tracking.

​
System Components

  • User: End-user of the mobile application

  • YOUR Mobile App: The client-side mobile application

  • Genuin SDK: Software Development Kit integrated into your mobile app

  • Genuin Backend: Core backend services handling authentication and content

  • Device Middleware: Interface between Genuin and your authentication system

  • YOUR Auth API: Your authentication service

  • YOUR Data Warehouse: Analytics and data storage system

​
Process Flow

​
Initial Login and SDK Initialization

  • The user initiates the login process through your mobile application

  • The mobile app initializes the Genuin SDK with your user token

  • SDK establishes initial context with user information

​
Authentication Process

  • Genuin SDK sends an authentication request to Genuin Backend

  • Device Middleware verifies your user token

  • The token is forwarded to your Auth API for verification

  • Auth API returns user details including:

    • Member ID

    • Email

    • Name

  • User metadata is forwarded to Genuin Backend

​
User Profile Management

The system handles both new and existing users:

For new users:

  • Creates new user profile in Genuin system

  • Registers user with your provided metadata

  • Generates new Genuin token

For existing users:

  • Refreshes existing user session

  • Generates updated Genuin token

​
Content Delivery

  • Genuin Backend returns authentication token to SDK

  • The authenticated session is established

  • Content data is streamed to SDK

  • SDK renders content in mobile app

  • Interactive content is displayed to a user

​
User Interaction Handling

  • User interactions are captured by the mobile app

  • Interactions are processed through Genuin SDK

  • Event data is sent to Genuin Backend including:

    a. User actions

    b. Timestamps

    c. Content IDs

​
Analytics Integration

Analytics data is pushed to your Data Warehouse (Mixpanel) including:

  • User interaction metrics

  • Session data

  • Content engagement metrics

​
Error Handling

The system includes robust error handling:

  • API errors are captured by Genuin Backend

  • Error status is communicated to SDK

  • User-friendly error messages are displayed in the mobile app

​
Security Considerations

  • All authentication tokens are securely transmitted

  • User data is encrypted during the transfer

  • Session management follows security best practices