Pulse Insights Documentation
  • Pulse Insights Overview
    • 👋Welcome to Pulse Insights
  • Implementing Pulse Insights (Dev)
    • Implementing on Web and Mobile Web
      • Deploying your tag (code snippet)
      • Ingesting contextual data for targeting and analysis
      • Client Key
      • Tracking Events (aka High Value Actions)
      • Presenting a specific survey
      • Supporting Inline surveys
      • Callbacks
      • Privacy Features
        • Identifiers, cookies, and local storage
        • Data that Pulse Insights stores
      • QA Process and Preview Mode
        • JavaScript Object
      • Single Page Apps
      • Load Time & Availability
      • Bot blocking
      • Customer-initiated Feedback
    • Implementing in email
      • Dynamic Email
    • Implementing in Native Apps
      • Android
        • Android Release Notes
        • Android Demo App
      • iOS
        • iOS Release Notes
        • iOS Demo App
      • Demo App Help
  • Integrations
    • Integrations overview
      • Hubspot
      • Braze
      • Google Analytics
      • Data Lake
  • Configuring Pulse Insights (Console)
    • Account Setup
      • Authentication & SSO
      • Inviting Collaborators
      • Roles & permissions
    • Dashboard & Program Management
      • Survey Status
    • Editor
      • Question Types
        • Survey Invitation
        • Single Choice
          • Using Images
        • Multiple Choice
        • Free Text
        • Net Promoter Score
        • Slider
        • Custom Content (Next Best Action)
        • Thank You Message
          • Poll (Show Results)
      • General
      • Targeting
        • Devices & Channels
        • Sample Rate
        • URL & Events
        • Dates
        • Previous Responses
        • On Page Behavior
        • CRM Targeting
        • Geo Targeting
        • Goal
        • User Behavior
        • Advanced Settings
      • Formatting
        • Widget Types
          • Docked
          • Bottom Bar
          • Top Bar
          • Overlay
          • Inline
        • Themes
        • Question Display
        • Custom CSS (Survey-level)
        • Supported Markdown
      • Link Builder
      • Preview
      • Survey Groups (Localization)
    • Reporting
      • Results Page & Filtering
      • On Demand
        • Columns/Data Dictionary
      • Scheduled Reports
      • Free Text
        • AI Generated Summary
        • Responses & Tagging
      • Custom Content Reporting
      • Viewable Impressions
    • Account Level Settings
      • Get Code Snippet
      • Global Targeting
      • Data & Integrations (Callbacks)
      • Data Restrictions
      • Themes
      • Automations
        • High Value Actions (Events)
      • Activity Log
      • Configured by Pulse Insights
  • Best Practices
    • Best Practices
      • Copy
      • Design and Execution
      • Targeting
      • Widget Types
      • Sample Rate
      • Submission Rates
      • Special Features
      • Best Practices for Progressive Profiling
  • API
    • API reference
      • Surveys
        • Questions
        • Poll
      • Q
        • A
      • Direct serve
      • Serve
      • Results
      • Present results
      • Track event
      • Custom content link click
      • Submissions
        • All answers
        • Answer
        • Close
        • Viewed at
      • Devices
        • Set data
Powered by GitBook
On this page
  • Use Cases for Client Key
  • Cross-device linkage
  • Cross-device frequency caps
  • As a key for external system integrations
  • Syntax & Example
  • Validating Client Key Data
  • Validating In the browser
  • Validating In reporting
  • Client Key FAQs
  • Can I use Context or Device Data to store our user identifier instead?
  • Will the Client Key apply to previous impressions and submissions that occurred on that device before Client Key was defined?

Was this helpful?

  1. Implementing Pulse Insights (Dev)
  2. Implementing on Web and Mobile Web

Client Key

Client Key is an optional way for Pulse Insights to store a persistent identifier associated with a user, which unlocks a few key features:

Use Cases for Client Key

Cross-device linkage

Client key can link different browsers (e.g., home vs. work), devices, and channels so that Pulse Insights can decision at the person-level. For example, if a personal has already answered a particular survey on a home browser, Pulse Insights wouldn't serve it again in a different browser or device that shares the same client key, because the person has already answered it. Without Client Key, Pulse Insights would see the different browsers as independent.

Cross-device frequency caps

Pulse Insights can deploy its frequency caps features at a person-level, so that a person doesn't get over-surveyed, even if their visits are spread across different channels, devices, and browsers.

As a key for external system integrations

Often times, Client Key is a primary ID used to identify a user across systems in an organization. As such, it's used as a key to determine which record to update, say in a CRM system.

Syntax & Example

pi('identify_client', 'clientkey');

For example:

pi('identify_client','abc123');

Validating Client Key Data

Validating In the browser

You can see Client Key values that were set in the current pageview in the PulseInsightsObject.

Client key values are also stored in local storage.

The client key is stored in PulseInsightsObject until an impression or submission occurs on that pageview. identify_client doesn't generate its own network call.

Once set on a device, it needn't be redefined on subsequent pageviews or visits.

Validating In reporting

Client key data will be in the Client Key column of the XLS and CSV exports from console.

Client Key FAQs

Can I use Context or Device Data to store our user identifier instead?

Yes. You only need to use Client Key if you want to use cross device linkage and frequency cap features. Integrations can be configured to utilize Context or Device data values as well.

Will the Client Key apply to previous impressions and submissions that occurred on that device before Client Key was defined?

Yes, in reporting and analysis, as the client key becomes associated with the Device UDID, including all past and future impressions and submissions. For decisioning (e.g., cross device frequency caps) and standard integrations, it is used going forward.

PreviousIngesting contextual data for targeting and analysisNextTracking Events (aka High Value Actions)

Last updated 2 years ago

Was this helpful?