Interactions
Track and leverage user interactions to improve search relevance
Interaction tracking allows you to record how users engage with search results, enabling personalized ranking, relevance improvement, and usage analytics.
Overview
In Mixpeek, interactions represent how users engage with search results. By tracking these interactions, you can gather valuable data to improve search relevance, personalize results, and gain insights into user behavior and content performance.
User Engagement Data
Record how users interact with search results, including clicks, views, and conversions
Relevance Signals
Use interaction data as signals to improve search relevance and personalization
Types of Interactions
Mixpeek supports several types of user interactions that you can track:
Recording Interactions
You can record interactions using the Mixpeek API:
Interaction Parameters
Parameter | Type | Description |
---|---|---|
namespace_id | string | ID of the namespace containing the document |
type | string | Interaction type: “click”, “view”, “conversion”, or custom |
document_id | string | ID of the document the user interacted with |
Parameter | Type | Description |
---|---|---|
namespace_id | string | ID of the namespace containing the document |
type | string | Interaction type: “click”, “view”, “conversion”, or custom |
document_id | string | ID of the document the user interacted with |
Parameter | Type | Description |
---|---|---|
user_id | string | Identifier for the user performing the interaction |
session_id | string | Identifier for the user’s session |
search_id | string | Identifier for the search query that produced the result |
position | integer | Position of the document in the search results (1-based) |
Parameter | Type | Description |
---|---|---|
timestamp | string | ISO 8601 timestamp for when the interaction occurred |
value | number | Numeric value associated with the interaction (e.g., purchase amount) |
duration | number | Duration of the interaction in seconds |
metadata | object | Additional contextual data about the interaction |
Using Interactions in Search
Interactions can be used to personalize and improve search results:
Personalized Retriever
User-Based Filtering
Tracking Interactions Client-Side
For web applications, you can use the Mixpeek JavaScript SDK to track interactions:
Analytics and Reporting
User Interaction Tracking
Monitor how users interact with your retrieval system:
Key Metrics
- Query volume (total, by time period, by user segment)
- Session metrics (duration, queries per session)
- Most frequent queries and search patterns
- Abandonment rates and search refinements
Implementation
User Interaction Tracking
Monitor how users interact with your retrieval system:
Key Metrics
- Query volume (total, by time period, by user segment)
- Session metrics (duration, queries per session)
- Most frequent queries and search patterns
- Abandonment rates and search refinements
Implementation
Retrieval Effectiveness Measurement
Evaluate the quality and speed of your retrieval results:
Key Metrics
- Latency (average, p95, p99 response times)
- Precision and recall (when ground truth available)
- Mean Reciprocal Rank (MRR) and Normalized Discounted Cumulative Gain (NDCG)
- Cache hit rates and optimization opportunities
Implementation
Feedback Collection and Analysis
Track and analyze explicit and implicit user feedback:
Key Metrics
- Explicit ratings (thumbs up/down, star ratings)
- Click-through rates and result selection patterns
- Time spent on results and engagement metrics
- Feedback comments and sentiment analysis
Implementation
Retrieved Content Patterns
Analyze patterns in retrieved documents and content:
Key Metrics
- Most frequently retrieved documents
- Content distribution by type, category, or attribute
- Content freshness and recency metrics
- Coverage and gaps in retrieved content
Implementation
Best Practices
Track Consistently
Implement interaction tracking consistently across your application to collect comprehensive data.
Include Context
Capture relevant contextual information in the metadata field to make interactions more valuable for analysis.
Balance Privacy
Respect user privacy by anonymizing user identifiers where appropriate and complying with relevant regulations.
Optimize Volume
For high-traffic applications, consider batching interaction records or sampling to manage data volume.
Interaction data can grow rapidly in high-traffic applications. Consider implementing data retention policies and monitoring storage usage.
Implementation Strategies
Basic Implementation
- Track clicks on search results
- Use document position data
- Include user and session IDs
- Store basic query information
Intermediate Implementation
- Track clicks, views, and conversions
- Measure view duration and engagement depth
- Include device and page context
- Implement client-side tracking with JS SDK
Advanced Implementation
- Track custom interaction types
- Implement personalized ranking based on history
- Use interaction data for A/B testing
- Analyze interaction patterns for recommendations
Enterprise Implementation
- Integrate with data warehouses
- Implement comprehensive reporting
- Use interaction data for model training
- Create personalized content recommendations
API Reference
For complete details on working with interactions, see our Interactions API Reference.
Was this page helpful?