Issue
When setting up Braze Web Push Notifications through Segment, customers may need to enable the manageServiceWorkerExternally initialization option. However, since the Braze SDK is managed by Segment, customers do not have direct access to modify the SDK initialization code. This prevents them from enabling the option directly in their source code.
Product
Twilio Segment
Environment
Segment Console
Cause
The Braze Web SDK is initialized and managed by Segment, so initialization options like manageServiceWorkerExternally must be configured through the Segment Dashboard, not directly in the website source code.
Resolution
To enable the manageServiceWorkerExternally option for Braze Web SDK via Segment:
- In your Segment App, go to Connections > Destinations.
- Select the Braze destination connected to your Web Source.
- Click on the Settings tab at the top of the page.
- Use the search bar in the settings pane to search for "Manage Service Worker Externally".
- Set the option to True (Enabled) and save your changes.
Additional Information
No code changes are required; all configuration is handled via the Segment Dashboard. If the option is not visible, ensure you are editing the correct Braze destination instance.