Salesforce Personalization Sitemap Builder

This tool helps customers implement and debug Salesforce Personalization by supporting the process of DC Sitemap creation.

## Overview A low/no-code Chrome extension tool that simplifies the creation of Salesforce Personalization sitemaps and Data Cloud schemas, eliminating the need for deep JavaScript programming knowledge and making personalization implementation accessible to non-developers. ## The Problem Salesforce Personalization requires two complex configuration files: - **Sitemap.js**: Defines user identification, page types, event capture, data mapping, and content zones - **Schema.json**: Defines Data Cloud event structures, attribute mappings, and DLO configurations Creating these manually requires extensive JavaScript knowledge, Data Cloud expertise, and significant time for testing—typically taking days or weeks. ## The Solution A visual wizard that guides users through step-by-step configuration, automatically generates both files with perfect alignment, and provides live testing capabilities. Implementation time is reduced from days/weeks to hours. ## Key Features ### Visual Sitemap Builder - **Consent Management**: Configure privacy-compliant consent listeners - **Resolvers**: Built-in resolvers (CSS selectors, JavaScript paths, meta tags, URL parameters) plus custom JavaScript resolvers with real-time testing - **User Profiles**: Define and map user attributes (name, email, loyalty status, etc.) - **Engagement Events**: Configure standard events (catalog, cart, orders) and custom events with attribute mapping and line items - **Page Types**: Define page detection rules (URL patterns, CSS selectors) and page-specific event configuration ### Automatic Schema Generation - Generates Data Cloud schema from sitemap configuration - Ensures all events have corresponding schema definitions - Maps attributes with correct data types - Includes required fields for Data Cloud compatibility ### Import/Export - Import existing sitemap.js files for migration or updates - Export ready-to-deploy `sitemap.js` and `schema.json` files ### Chrome Extension Capabilities - **Live Website Integration**: Connect directly to website tabs, test in real-time, use visual element picker - **Test & Validate Mode**: Inject sitemap into browser tabs for immediate testing without deployment, monitor events in real-time, validate data capture, get instant feedback ### Developer-Friendly Output - Clean, readable JavaScript code with AST-based generation - Comments and documentation included - Follows standard Salesforce Personalization patterns ## Core Concepts **Resolvers**: Functions that extract data from web pages (CSS selectors, JavaScript paths, meta tags, URL parameters, custom logic) **Events**: Capture user interactions and send to Salesforce (standard catalog/cart/order events, plus custom events) **Profiles**: Define user attributes for anonymous and known users, attach to events **Page Types**: Categorize website sections with detection rules and page-specific configurations ## Data Flow 1. **Configuration** → Visual wizard interface 2. **Generation** → Automatic sitemap.js and schema.json creation 3. **Deployment** → Files ready for website and Data Cloud 4. **Runtime** → Salesforce Interactions SDK executes sitemap 5. **Personalization** → Data Cloud processes for real-time decisions and analytics ## Benefits **Business Users**: No coding required, faster implementation (hours vs. weeks), reduced costs, better accuracy **Developers**: Accelerated development, consistent best-practice patterns, easy maintenance, built-in testing tools **Organizations**: Faster time-to-value, scalable standardized process, self-documenting configuration, minimal training needed ## Support - **Tool usage**: In-app help and tooltips - **Salesforce Personalization**: [Official documentation](https://developer.salesforce.com/docs/marketing/personalization/guide/personalization-sitemap.html) - **Data Cloud schemas**: [Schema documentation](https://developer.salesforce.com/docs/data/data-cloud-int/guide/c360-a-mobile-web-sdk-schema-quick-guide.html)