Guidewire Integration

Pyze JavaScript SDK installation guide for Guidewire

Before starting your application instrumentation, ensure that you have created an app and have an appKey

Prerequisites

Before installation, confirm the following:

  • You have a valid Pyze Application Key
  • You know whether your environment is Guidewire Cloud or Self-managed / On-premise
  • You know whether you are integrating into:
    • Jutro Digital Platform (React-based), or
    • Classic PCF UI (PolicyCenter, ClaimCenter, BillingCenter, etc.), or both
  • You have permission to add client-side JavaScript and deploy changes in your Guidewire environment

Installation Options

Choose the method that matches your environment.

Option Use When
A. Jutro Digital Platform You are using Guidewire Jutro (portals or digital experiences)
B. Classic PCF UI You need tracking on core InsuranceSuite screens

Recommended order: Start with Option A when possible.

Option A – Jutro Digital Platform

Method 1: Script Tag

  1. Open your Jutro project.
  2. Open the file public/index.html.
  3. Add the following inside the <head> section:
// Start Pyze Script
<script type="text/javascript">
    var pyzeAppKey="YOUR_PYZE_APP_KEY";
    !function(e,t){var s=e.Pyze||{_q:[]},i=e.PyzeEvents||{_q:[]},n=e.PyzeCuratedEvents||{_q:[]},r=e.PyzeIdentity||{_q:[]};function p(t,e){function s(e){t[e]=function(){t._q.push([e].concat(Array.prototype.slice.call(arguments,0)))}}for(var i=0;i<e.length;i++)s(e[i])}p(s,["initialize","getTimerReference","getAppInstanceId","postWebAppVersion","postPageView","setUserOptOut","deleteUser"]),p(i,["postCustomEvent","startTimerForEvent","postCustomEventWithAttributes","postTimedEvent","postTimedEventWithAttributes","postExplicitActivation"]),p(n,["post"]),p(r,["setUserProfile","resetUserProfile","updateUserProfile"]);var o=t.createElement("script"),a=t.getElementsByTagName("script")[0];o.type="text/javascript",o.async=!0,o.src="https://cdn.pyze.com/pyze.js",a.parentNode.insertBefore(o,a),e.Pyze=s,e.PyzeEvents=i,e.PyzeCuratedEvents=n,e.PyzeIdentity=r}(window,document),Pyze.initialize(pyzeAppKey);
</script>
// End Pyze Script
  1. Replace YOUR_PYZE_APP_KEY with the Pyze App Key obtained from your growth.pyze.com account.
  2. Rebuild and deploy the Jutro application.

Method 2: Module Import

  1. Add the Pyze SDK file to your project.
  2. In your main entry file (src/index.js or src/App.js), initialize the SDK:
// Initialize Pyze on application load
Pyze.initialize("YOUR_PYZE_APP_KEY");
  1. Rebuild and deploy the application.

Option B – Classic PCF UI (Core Screens)

  1. Self-host the SDK (recommended)

    Place the pyze.js file in your Guidewire web resources directory and rebuild web resources using Guidewire Studio or the appropriate build command.

  2. Add the script using Guidewire’s supported client-side JavaScript mechanism

    Follow the official Guidewire documentation: “Add JavaScript to the client application”

  3. Reference the self-hosted file and initialize the SDK with your Application Key:

Pyze.initialize("YOUR_PYZE_APP_KEY");
  1. Deploy the configuration changes according to your standard process.

Verification

After deployment:

  1. Open the Guidewire application in a browser.
  2. Open Developer Tools (Network and Console tabs).
  3. Confirm that the Pyze script loads without errors.
Last modified 0001-01-01