fix: send init details in usageStats event

Author: mohitsharma468

CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+
+## [1.65.0] - 2026-09-10
+
+## Added 
+
+- Enhanced `vwo_sdkUsageStats` event payload with `settingsFetchTime`, `sdkInitTime`, and `initConfig` (the SDK initialization options) for better observability into SDK initialization.
+
 ## [1.62.0] - 2026-08-17
 
 ### Added

setup.py

@@ -143,7 +143,7 @@ def run(self):
 
 setup(
     name=_brand["name"],
-    version="1.62.0",
+    version="1.65.0",
     description=_brand["description"],
     long_description=long_description,
     long_description_content_type="text/markdown",

wingify/constants/Constants.py

@@ -17,7 +17,7 @@ class Constants:
     # TODO: read from setup.py
     sdk_meta = {
         "name": "vwo-fme-python-sdk",
-        "version": "1.62.0",
+        "version": "1.65.0",
     }
 
     SDK_VERSION = sdk_meta["version"]

wingify/utils/event_util.py

@@ -12,26 +12,23 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from typing import Optional
+from typing import Any, Dict, Optional
 from .network_util import get_events_base_properties, get_sdk_init_event_payload, get_sdk_usage_stats_event_payload, send_event
 from ..enums.event_enum import EventEnum
 from ..wingify_client import WingifyClient as VWOClient
 from ..packages.logger.core.log_manager import LogManager
 from ..enums.api_enum import ApiEnum
 
-def send_sdk_init_event(settings_fetch_time: Optional[int] = None, sdk_init_time: Optional[int] = None) -> None:
+def send_sdk_init_event() -> None:
     """
     Sends an init called event to VWO.
     This event is triggered when the init function is called.
-    
-    :param settings_fetch_time: Time taken to fetch settings in milliseconds
-    :param sdk_init_time: Time taken to initialize the SDK in milliseconds
     """
     # Create the query parameters
     properties = get_events_base_properties(EventEnum.SDK_INIT_EVENT.value)
 
     # Create the payload with required fields
-    payload = get_sdk_init_event_payload(EventEnum.SDK_INIT_EVENT.value, settings_fetch_time, sdk_init_time)
+    payload = get_sdk_init_event_payload(EventEnum.SDK_INIT_EVENT.value)
 
     # Send the constructed payload via POST request
     try:
@@ -49,18 +46,32 @@ def send_sdk_init_event(settings_fetch_time: Optional[int] = None, sdk_init_time
         pass
 
 
-def send_sdk_usage_stats_event(usage_stats_account_id: int) -> None:
+def send_sdk_usage_stats_event(
+    usage_stats_account_id: int,
+    settings_fetch_time: Optional[int] = None,
+    sdk_init_time: Optional[int] = None,
+    init_config: Optional[Dict[str, Any]] = None,
+) -> None:
     """
     Sends a usage stats event to VWO.
     This event is triggered when the SDK is initialized.
     
     :param usage_stats_account_id: Account ID for usage stats event
+    :param settings_fetch_time: Time taken to fetch settings in milliseconds
+    :param sdk_init_time: Time taken to initialize the SDK in milliseconds
+    :param init_config: SDK initialization options
     """
     # Create the query parameters
     properties = get_events_base_properties(EventEnum.USAGE_STATS.value, "", "", True, usage_stats_account_id)
 
     # Create the payload with required fields
-    payload = get_sdk_usage_stats_event_payload(EventEnum.USAGE_STATS.value, usage_stats_account_id)
+    payload = get_sdk_usage_stats_event_payload(
+        EventEnum.USAGE_STATS.value,
+        usage_stats_account_id,
+        settings_fetch_time,
+        sdk_init_time,
+        init_config,
+    )
 
     vwo_instance = VWOClient.get_instance()
 

wingify/utils/network_util.py

@@ -104,12 +104,10 @@ def get_events_base_properties(
         "sv": Constants.SDK_VERSION
     }
 
-    if not is_usage_stats_event:
-        # set env key for standard sdk events
-        properties["env"] = sdk_key
-    else:
-        # set account id for internal usage stats event
+    properties["env"] = sdk_key
+    if is_usage_stats_event:
         properties["a"] = str(usage_stats_account_id)
+
     return properties
 
 
@@ -510,18 +508,12 @@ def get_messaging_event_payload(
     return properties
 
 
-def get_sdk_init_event_payload(
-    event_name: str,
-    settings_fetch_time: Optional[int] = None,
-    sdk_init_time: Optional[int] = None,
-) -> Dict[str, Any]:
+def get_sdk_init_event_payload(event_name: str) -> Dict[str, Any]:
     """
     Constructs the payload for sdk init called event.
 
     Args:
         event_name: The name of the event.
-        settings_fetch_time: Time taken to fetch settings in milliseconds.
-        sdk_init_time: Time taken to initialize the SDK in milliseconds.
 
     Returns:
         The constructed payload with required fields.
@@ -539,23 +531,28 @@ def get_sdk_init_event_payload(
 
     data = {
         "isSDKInitialized": True,
-        "settingsFetchTime": settings_fetch_time,
-        "sdkInitTime": sdk_init_time,
     }
     properties["d"]["event"]["props"]["data"] = data
 
     return properties
 
 
 def get_sdk_usage_stats_event_payload(
-    event_name: str, usage_stats_account_id: int
+    event_name: str,
+    usage_stats_account_id: int,
+    settings_fetch_time: Optional[int] = None,
+    sdk_init_time: Optional[int] = None,
+    init_config: Optional[Dict[str, Any]] = None,
 ) -> Dict[str, Any]:
     """
     Constructs the payload for sdk usage stats event.
 
     Args:
         event_name: The name of the event.
         usage_stats_account_id: Account ID for usage stats event.
+        settings_fetch_time: Time taken to fetch settings in milliseconds.
+        sdk_init_time: Time taken to initialize the SDK in milliseconds.
+        init_config: SDK initialization options.
 
     Returns:
         The constructed payload with required fields.
@@ -571,6 +568,15 @@ def get_sdk_usage_stats_event_payload(
     properties["d"]["event"]["props"]["product"] = Constants.PRODUCT_NAME
     properties["d"]["event"]["props"]["vwoMeta"] = UsageStatsUtil().get_usage_stats()
 
+    data = {
+        "settingsFetchTime": settings_fetch_time,
+        "sdkInitTime": sdk_init_time,
+        "initConfig": json.loads(
+            json.dumps(init_config or {}, default=lambda o: type(o).__name__)
+        ),
+    }
+    properties["d"]["event"]["props"]["data"] = data
+
     return properties
 
 

wingify/wingify.py

@@ -110,7 +110,7 @@ def init(options: Dict[str, Any]) -> Optional["WingifyClient"]:
                 was_initialized = sdk_meta_info.get("wasInitializedEarlier", False)
 
         if instance.is_settings_valid_on_init and not was_initialized:
-            send_sdk_init_event(instance.settings_fetch_time, sdk_init_time)
+            send_sdk_init_event()
 
         usage_stats_account_id = None
         if getattr(instance, '_settings', None) is not None:
@@ -119,7 +119,13 @@ def init(options: Dict[str, Any]) -> Optional["WingifyClient"]:
         if usage_stats_account_id:
             sampling_service = InternalEventsSamplingService()
             if sampling_service.should_send_usage_stats_event(instance._settings):
-                send_sdk_usage_stats_event(usage_stats_account_id)
+                settings_fetch_time = instance.settings_fetch_time
+                send_sdk_usage_stats_event(
+                    usage_stats_account_id,
+                    settings_fetch_time,
+                    sdk_init_time,
+                    options,
+                )
 
         return instance
     except Exception as e: