Skip to main content

Amplitude Integration

Rise AI offers a powerful integration with Amplitude that enables you to track user engagement events, sync user traits, and leverage cohorts for personalized AI experiences.

Overview​

The Rise AI + Amplitude integration allows you to:

  • Track Events: Automatically send Rise AI interaction events to Amplitude
  • Sync User Traits: Update Amplitude user profiles with AI engagement data
  • Cohort Targeting: Use Amplitude cohorts to personalize AI experiences
  • Bidirectional Data Flow: Keep both platforms in sync for comprehensive analytics

Setup​

Prerequisites​

  • Active Rise account with SDK installed
  • Amplitude account with project access
  • Admin permissions in both platforms

Step 1: Get Your Amplitude API Key​

  1. Log into your Amplitude account
  2. Navigate to Settings > Projects
  3. Select your project
  4. Find your API Key under the project settings
  5. Copy the API key (you'll need it in the next step)

Step 2: Configure Integration in Rise AI​

  1. Log into your Rise AI dashboard
  2. Navigate to Settings > Integrations
  3. Find Amplitude in the integrations list
  4. Click Connect
  5. Paste your Amplitude API key
  6. Configure your integration settings (see Configuration Options below)
  7. Click Save to activate the integration

Configuration Options​

Event Tracking​

Enable this option to automatically send Rise AI events to Amplitude. When enabled, the following events are tracked:

chats​

Tracks AI chat interactions between users and the Rise AI assistant.

Event Properties:

  • batch_id - Unique identifier for the event batch
  • chat_id - Unique chat session identifier
  • chat_type - Type of chat interaction (e.g., "ask-me-anything")
  • entity_type - Type of entity tracked (e.g., "chat")
  • environment - Environment where event occurred (e.g., "prod", "staging")
  • event_timestamp - ISO 8601 timestamp of when the chat was created
  • event_type - Type of event (e.g., "create")
  • tenant_id - Unique identifier for the customer organization

Analytics Use Case: Calculate the average number of chat sessions per user and measure AI engagement over time.

walkthrough-progress​

Tracks user progress through interactive walkthroughs and onboarding flows.

Event Properties:

  • batch_id - Unique identifier for the event batch
  • chat_id - Unique chat session identifier
  • entity_type - Type of entity tracked (e.g., "walkthrough_progress")
  • environment - Environment where event occurred
  • event_timestamp - ISO 8601 timestamp of when the event occurred
  • event_type - Type of event (e.g., "progress_tracked")
  • fulfillment_action - User action that fulfilled the step (e.g., "click")
  • fulfillment_selector - DOM selector of element that was interacted with
  • selector - CSS selector of the target element
  • step_index - Current step number in the walkthrough (0-indexed)
  • step_prompt_message - AI-generated guidance message for the step
  • step_title - Human-readable title of the current step
  • tenant_id - Unique identifier for the customer organization
  • walkthrough_id - Unique identifier for the walkthrough
  • walkthrough_job_to_be_done - The user's goal or job that the walkthrough helps accomplish

Analytics Use Case: Measure walkthrough completion rates and identify where users drop off in the onboarding flow.

Cohort Synchronization​

Importing Amplitude Cohorts​

Use Amplitude cohorts to target specific user segments with personalized AI experiences:

  1. In your Rise AI dashboard, navigate to Audiences > Cohorts
  2. Click Import from Amplitude
  3. Select the cohort you want to import
  4. Choose sync frequency:
    • One-time: Import current cohort members once
    • Daily: Sync cohort members daily
    • Real-time: Keep cohort in sync via webhook (requires Amplitude plan with webhook support)
  5. Click Import

Once imported, you can use the cohort to:

  • Target specific AI experiences or flows
  • Customize AI responses based on user segment
  • A/B test different AI strategies

Analytics Use Cases​

Walkthrough Completion Analysis​

Track how effectively users complete AI-guided onboarding flows:

In Amplitude, create a funnel:

  1. Event: walkthrough-progress where step_index = 0
  2. Event: walkthrough-progress where step_index = 1
  3. Event: walkthrough-progress where step_index = 2

Group by: walkthrough_job_to_be_done

This shows you which jobs have the highest completion rates and where users drop off.

Chat Engagement Metrics​

Measure AI chat adoption and engagement:

Create a chart in Amplitude:

  • Event: chats
  • Metric: Event Totals
  • Segment by: chat_type
  • Group by: tenant_id

This reveals which types of chat interactions are most popular across your user base.

Step-Level Friction Detection​

Identify which walkthrough steps cause users to struggle:

Amplitude Query:

  • Event: walkthrough-progress
  • Group by: step_title
  • Metric: Average time between events

Steps with longer durations may indicate confusion or friction points that need improvement.

Troubleshooting​

Events Not Appearing in Amplitude​

  1. Verify Integration is Active: Check that the integration status shows "Connected" in Rise AI dashboard
  2. Check API Key: Ensure you copied the correct API key from Amplitude
  3. Verify User Identity: Make sure Rise.identify() is called before tracking events

Cohort Import Issues​

  1. Verify Cohort Exists: Check that the cohort is active in Amplitude
  2. Check Cohort Size: Very large cohorts (>100k users) may take longer to sync
  3. API Permissions: Ensure your Amplitude API key has cohort read permissions

Data Privacy and Compliance​

Rise AI's Amplitude integration is designed with privacy in mind:

  • Opt-out Support: Users who opt out of tracking in Rise AI will not have events sent to Amplitude
  • GDPR Compliance: Support for data deletion requests across both platforms
  • Data Minimization: Only essential event properties are sent by default
  • Custom PII Handling: Configure which user traits to sync to avoid sending sensitive data