Sitemap Builder

## 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.

## Salesforce Personalization Site-Based File Requirements

Salesforce Personalization requires two site-based configuration files when defining and delivering personalized content:
- **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.

A Personalization developer manually creates a sitemap to collect user interactivity data using JavaScript. The developer must then create a schema file that aligns with the configuration in the Data 360 sitemap.

## Streamline the Sitemap and Schema Creation Process

The Salesforce Sitemap Builder is a visual wizard that helps to guide users through the sitemap configuration process, significantly reducing the time necessary for sitemap and schema creation. Tool features include Data 360-compatible sample configurations for specific sitemap components, automatic generation of a sitemap-aligned schema, and live sitemap and schema testing capabilities.

## 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)