Integration Launcher Options
#
OverviewOptions for the instance of IntegrationLauncher. When an instance of the Integration Launcher is created it is required to pass your unique Rokt Account ID. The other parameters are optional and allow you to configure the behavior of the integration.
#
PropertiesaccountId
#
• accountId : string
Your unique Rokt Account ID. See Where can I find my Rokt Account ID? on how to find your Rokt Account ID.
noDeviceId
(optional)#
• noDeviceId? : boolean
default
false
Allows partners to opt out from device recognition (e.g., cookies) for the current session.
pageInitTimestamp
(optional)#
• pageInitTimestamp? : Date
In the event that the Integration Launcher is initialized on a virtual page of a SPA, this value allows you to provide the timestamp of the page being initialized. This allows Rokt to correctly measure the load performance relative to the page that triggered it without external factors such as how long it took user to reach that page. With this information, Rokt can detect any anomaly in the load times that could impact the efficiency of the integration.
default
PerformanceNavigationTiming.responseStart
See Anomaly detection for how Rokt tracks load performance.
See Single page applications on details of SPA integrations
sandbox
(optional)#
• sandbox? : boolean
default
false
A boolean flag marking if the sandbox environment should be used for the session.
note
This should never be set to true in production.
The flag is useful in the following cases:
- A partner wants to do user acceptance testing against the production configuration without generating any referrals, before launching in production.
- Sandbox is used in continuous integration environment on the partner side.
See
sandbox integration for additional information and examples.
sessionId
(optional)#
• sessionId? : string
Rokt session ID to be passed in case you have already generated your session ID.
For example, it is possible to have your session ID generated by connecting with the Rokt backend before visiting a page where your tag is displayed. In this case, you should provide the previously generated Rokt session ID as this parameter so Rokt can pair both interactions together.