SDK Initialization

SDK initialization is the setup call that prepares the library with the project key and options, before any event is sent.

Initialization is the moment the whole instrumentation depends on; if the SDK does not start correctly, every later call either fails or quietly sends data to the wrong place. This step locks a few things: the project's public key that sets the data's destination, and options such as send timing and debug mode. Two common errors happen here: starting with the wrong key, which pours data into another project with no visible error, and firing an event before initialization completes, which loses those early events unless the library queues them. Order matters: initialization should happen once and as early as possible, and that is also where the session's stable super properties are registered so they accompany data from the first event.