Login Event

Description

The Login Event should be fired when a user logs in to the client’s platform. This event applies to all verticals and captures essential user authentication and engagement details.

Event Context Structure

The mandatory properties (tenant, timestamp, event, and customer) are required for all events and documented in detail on the Mandatory Properties page. Below is the JSON structure for the context-specific properties of the Login Event:

{
    "context": {
        "login_timestamp": "2024-05-27T10:30:00Z",
        "balance": 100.50,
        "is_first_login": false,
        "session_ref": "session12345",
        "ccy_code": "USD",
        "language": "en",
        "country": "US",
        "platform": "iOS",
        "channel": "mobile",
        "skinId": "skin123",
        "license": "licenseXYZ"
    }
}

 

Parameters

Notes

Mandatory Properties

The following properties are mandatory for all events and should be included in every event payload. See the Mandatory Properties page for detailed explanations:

• tenant (Number): The identifier for the tenant.
• timestamp (String): The time the event was recorded in UTC (format: YYYY-MM-DD HH:MM:SS.ssssss UTC).
• event (String): The event name, e.g., ootb_login.
• customer (String): The identifier for the customer.

Context Properties

These properties provide additional details specific to the Login Event. They are optional but highly recommended for enriched insights:

• login_timestamp (String): ISO 8601 datetime of login (e.g., 2024-05-27T10:30:00Z).
• balance (Number): The user’s balance.
• is_first_login (Boolean): Indicates if this is the first login (true or false).
• session_ref (String): Reference to the game session.
• ccy_code (String): The currency code (e.g., USD).
• language (String): The language preference (e.g., en).
• country (String): The country code (e.g., US).
• platform (String): The platform used (e.g., iOS, Android).
• channel (String): The channel used for login (e.g., mobile, web).
• skinId (String): The skin ID.
• license (String): The license string.