■
Make sure Simpplr has whitelisted your Simpplr service account in Salesforce before getting started.
Connect your environment’s people data to Google
System admins can perform the following steps to select Google as the source for Simpplr's People data:
- Go to Manage App > Integrations > People Data.
- Select the Google checkbox to connect using admin credentials.
- After signing into the source account with admin credentials, your source account will be connected and you'll be redirected back to Simpplr. You'll now see the option to Disconnect account next to the selected source account.
selecting Google for connection
Google connected successfully
Note
If any other Google integration (Google Drive, Google Calendar, etc.) is already enabled, the domain used for syncing Simpplr People with Google should match the domain used elsewhere. If there's a domain name mismatch, you'll see "Connection failed - Domain name must match existing Google integrations." Also, user attributes like Job Title are only provisioned once. To continually sync user attribute data, see the Syncing sections below.
Set up Google user provisioning
If your Simpplr environment is connected to Google, System admins will see an option to provision users from Google. To set up Google provisioning:
- Go to Manage App > People > User Provisioning.
- Select a provisioning source.
- Enter in the query field (note, it says Optional but it is required): SimpIntegration.IsSimpplrUser=true. This is the filter defined in Google as a custom field. You must first create the custom field in your Google Workspace before this query will work. Name the custom field IsSimpplrUser. The custom field path should be category_name.custom field_name. This will enable syncing with Simpplr when a user is created in Google.
- Select Create new users or Don't create new users. If you're provisioning from Google, select Create new users. If you're only syncing with Google, select Don't create new users.
- Select Deactivate users.
- If Create new users is selected, enter the suffix you want for the username in Salesforce (for example, companyname.com.simpplr). The Profile field is mandatory. Required fields cannot be unchecked, or the provisioning process will fail. Simpplr People data requires a batch execution setup to sync.
Email ID is the default parameter for syncing user data from Google with Salesforce. Once the batch job (see below section) is executed:
- If the Create User field is selected:
- New users are created in Salesforce from Google.
- If the Deactivate User field is selected:
- Users without Google account emails are set to inactive.
Note:
Users are only deactivated in Simpplr if they've been deleted from Google. Suspended users are not deactivated.
query filter and new user creation
Note:
Use this link to test your filters: https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/listselecting user deactivation
entering the suffix for new username
Note: You can also use custom fields in Google to provide address info to Simpplr for the following fields:
- Street
- City
- County
- State
- Postal code
When selecting fields, Federation ID and Timezone must be checked. Otherwise users won't be created.
Running a user provisioning log from Google
For detailed instructions on running a provisioning log from google, check out this article from Google's Help Center.
Set up Google user data syncing
Once your environment is connected to Google, System admins will be able to sync user data from Google:
- Go to Manage App > People > User Syncing.
- Select Google as the syncing source.
- Select which fields you want to sync between Google and Simpplr. Note, Email and Timezone are required fields to be synced. If both these options aren't chosen, the sync will not run.
- Go to Manage App > Setup > Schedulers. Run a batch execution to sync the data.
selecting fields to sync between Google and Simpplr
Note: You can also use custom fields in Google to provide address info to Simpplr for the following fields:
- Street
- City
- County
- State
- Postal code
Note
User syncing is one-way from the external system or file to Simpplr. Changes in Simpplr do not flow back to the other system.
Custom attribute fields
When Google is set up as the source for provisioning or syncing, you can choose to sync from custom Google attributes for these five fields:
- street
- city
- country
- state
- postal code
To do so, select Custom field. In the field, enter the Google attribute group name and field name using this format: <group name>.<field name>
Batch sync and provision Simpplr people data with Google
Once your environment is connected to Google, and Google is selected as the People data source, System admins are ready to batch sync and/or provision People data in Simpplr with Google's source data:
- Go to Manage App > Setup > Schedulers.
- To provision users on-demand, run ScheduleHourlySimpplrServices. This job is pre-scheduled to run every three hours, but can be run on-demand.
- To sync user people data on-demand, run ScheduleSimpplrServices. This job is pre-scheduled to run once a day, but can be run on-demand.
- Simpplr People data will be automatically synced or provisioned accordingly.
options for a batch job under Schedulers
Comments
Is there a way for me to adjust time zones for audiences once uploaded? Our whole company is auto-set for CST, but about 75% of our employees are located in other timezones. I'm struggling with getting people to adjust their own settings, so wondering if this can be modified somehow on the admin end? Thanks!
Hi Regan. If you're pulling syncing data from a 3rd party source, Simpplr is only going to display that same data. So if your syncing source has CST set automatically for all users, then that's what Simpplr's going to do. If you can't change this in your syncing source, then I would recommend syncing user data or adding audiences via CSV file. That way you can control which data fields contribute to the audience and set users' accurate timezones yourself.
Please sign in to leave a comment.