add
Adds a Pinglet to the analytics tracking queue.
This method serializes the provided Pinglet to JSON and attempts to add it to the native C++ tracking queue. The operation is thread-safe and can be called from multiple threads concurrently.
The method performs validation checks including:
JSON format validation
Size limit validation
License permission validation
If the Pinglet cannot be added due to validation failures, appropriate warnings are logged but no exceptions are thrown to maintain system stability.
Parameters
pinglet
The Pinglet to add to the tracking queue
sessionNumber
The session identifier for associating the Pinglet with a specific session
P
The specific Pinglet type extending the base Pinglet interface