Configure on Chrome for any OS using Google Admin console

Last updated:

This article covers the process to configure the Pendo Launcher extension on the Chrome web browser on any computer using the Google Admin console, which involves:

  1. Determining the values to configure.
  2. Adding the extension policy in the Google Admin console.
  3. Validating that the configuration was successful.

You can use the process described in this article to configure the following types of data:

  • API key
  • Data environment

Note: The Pendo Launcher also requires a Visitor ID, which you can't configure using the Google Admin console. For the available options, see IT guide to deploying the Pendo Launcher.

Prerequisites

Before configuring the extension on end-user devices, you must first install it on end-user browsers using the Google Admin console. For instructions, see Install on Chrome for any OS using Google Admin console. We also recommend reading the Plan your browser extension implementation article before running any deployment steps.

Step 1. Determine values to configure

The Google Admin console applies the same values to every user that you target, so you can use it to configure your API key and, if your subscription is stored outside the default data environment, your data environment.

API key

Find the API key needed for Step 2 of the configuration process by going to Settings > Subscription settings > Extension in Pendo. Your unique extension API key is displayed under Install instructions and looks something like the following:

{
    "APIKey": {
        "Value": "c022bb1e-676d-4c58-731c-caf13fe12a89"
    }
}

Data environment (optional)

Only add the dataEnvironment property if your subscription is stored in a data environment other than the default, io. To identify your data environment, check the URL that you use to sign in to Pendo.

Pendo URL Data environment value
app.pendo.io io (default)
us1.app.pendo.io us1
app.eu.pendo.io eu
app.jpn.pendo.io jpn
app.au.pendo.io au

When combined with the API key, the JSON looks like the following:

{
    "APIKey": {
        "Value": "c022bb1e-676d-4c58-731c-caf13fe12a89"
    },
    "dataEnvironment": {
        "Value": "eu"
    }
}

Step 2. Add the extension policy in the Google Admin console

Add the JSON from Step 1 to the Pendo Launcher extension that you added to the Google Admin console when you installed it.

  1. Open your Google Admin console at https://admin.google.com/.
  2. Go to Devices > Chrome > Apps & extensions > Users & browsers.
  3. Choose the target users that you installed the extension for. If you installed the extension for more than one organizational unit or group, repeat these steps for each one.
  4. From the extension list, select the Pendo Launcher extension.
  5. Under Policy for extensions, paste the JSON that you created in Step 1.
  6. Select Save.

Step 3. Validate your configuration

First, validate the configuration on a single device that you can physically access. Validation involves confirming that the policy is present and that the browser reads it correctly.

Confirm the presence of the policy

  1. Open Chrome and make sure that you're signed in as a targeted user.
  2. Go to chrome://policy by copying and pasting the exact text into your URL bar.
  3. Scroll down to the Pendo Launcher section in the list of policies.
  4. Confirm that the values match the JSON that you created in Step 1. If the values aren't listed, select Reload policies.

Validate the browser behavior

Confirm that the Pendo Launcher is correctly reading the policy.

  1. In Chrome, visit any non-Chrome webpage, such as Pendo.
  2. Right-click the Pendo Launcher extension icon in your browser toolbar.
  3. Select Show Configuration Info.
  4. Open IT-managed config and check that your configuration values are there.

Next steps

To finish deploying the Pendo Launcher, configure the Visitor ID using one of the options in IT guide to deploying the Pendo Launcher.

Was this article helpful?
0 out of 0 found this helpful