Salesforce Commerce Connector for Adobe Commerce Optimizer
Built on Adobe App Builder technology, the Commerce Optimizer Salesforce Commerce Connector enables seamless transfer and management of catalog data from Salesforce Commerce Cloud B2C to Adobe Commerce Optimizer. It bridges both platforms, keeping product information, pricing, and updates in sync–without re-platforming.
Out of the box, the connector offers reliable data sync capabilities and the flexibility to customize workflows for your business needs.
Key Capabilities
-
Catalog Data Sync: Push product data—including variants, price books, and structures—from Salesforce Commerce B2C into Adobe Commerce Optimizer to keep storefronts and experience-driven applications up to date.
-
Price Sync: Import and manage price data directly from Salesforce Commerce B2C.
-
Supports multiple data types: Sync products, pricing, and catalog structures to reflect complex merchandising configurations.
-
Flexible Sync Workflows
- Scheduled Syncs: Automate updates using cron job scheduling, no manual effort required.
- On-Demand Updates: Instantly trigger SKU-level updates for urgent changes, corrections, or product launches.
-
Built for Extensibility
- Uses custom Salesforce Commerce B2C API (SCAPI) endpoints for compatibility and easy adaptation to unique or advanced use cases.
- Scales with your business–start with catalog and price sync, then extend the workflows to support additional integrations or business logic.
- Configure and evolve workflows without rebuilding core integrations.
Who Benefits from the Salesforce Connector?
The Salesforce Commerce Connector is ideal for:
- Existing Salesforce Commerce Cloud B2C customers enhancing storefront capabilities
- Multi-brand organizations requiring advanced merchandising and personalization features across multiple storefronts
- Businesses seeking performance improvements through Adobe’s Edge Delivery Services for faster storefront experiences
- Companies with complex pricing structures syncing sophisticated price books and locale-specific pricing
- AEM customers managing product catalogs from Salesforce Commerce B2C while using Adobe Commerce storefront with Edge Delivery Services
- Retailers with multi-locale requirements syncing localized product information across markets and languages
Use Cases
The connector supports several key use cases:
Catalog data ingestion and storefront display
This primary use case demonstrates the complete data flow from Salesforce Commerce B2C to the Adobe Commerce storefront:
- Initial catalog ingestion: Bulk load your entire Salesforce commerce catalog, including simple products with variants, price books, and pricing information.
- Automated delta updates: Automatically synchronize product updates from the Salesforce Commerce catalog management UI to Commerce Optimizer.
- Storefront integration: Display synchronized catalog data on your Adobe Commerce Edge Delivery Service storefront using Commerce Optimizer storefront APIs.
- Real-time updates: View updated product information (names, prices, descriptions) immediately on your storefront after making changes in Salesforce.
Multi-Locale Product Management
Leverage Salesforce Commerce B2C localization capabilities:
- Sync localized versions of product text fields (names, descriptions) from Salesforce Commerce B2C for different locales.
- Map Salesforce locale concepts 1:1 with Commerce Optimizer locales.
- Support multiple product ingestion cycles for different localizations.
- Maintain consistency across global product catalogs.
Architecture and components
The SFCC Connector provides a robust integration layer between a Salesforce Commerce B2C instance and Commerce Optimizer. The connector operates through a series of sync actions that transfer your catalog data, price books, and product information.
- Data Extraction—Authenticate with your Salesforce Commerce B2C instance and extract catalog data using custom SCAPI APIs.
- Data Transformation—Transform product data to match the Commerce Optimizer data model and schema requirements.
- Data Ingestion—Securely transmit transformed data to Commerce Optimizer using the ACO TypeScript SDK.
- Storefront Integration—Synchronized data becomes available through Commerce Optimizer APIs for storefront experiences.
The following diagram illustrates the high-level data flow for the integration:
Key Components
The Commerce Optimizer SFCC Connector consists of several key components:
- ACO SFCC Starter Kit App Builder application-Provides serverless functions that handle data sync between SFCC and Adobe Commerce Optimizer.
- Custom SFCC Cartridge - Required cartridge that extends your Salesforce Commerce Cloud instance with APIs needed for data extraction.
- Management UI - Web interface for monitoring sync status and managing connector operations.
Sync Process
The connector supports multiple sync modes.
Performs a comprehensive sync of all products, price books, and prices for your configured Salesforce Commerce Cloud site and locales. This includes
- product metadata and attributes
- catalog structure and categories
- price books
- pricing information
- multi-locale product data
Delta sync runs automatically on a scheduled basis (default: hourly) to maintain data freshness.
Provides granular sync capabilities:
- Price Book Sync syncs price book information only
- Metadata Sync updates product metadata and attribute definitions
- Specific Product Sync syncs individual products by SKU
Important considerations
When planning your implementation, consider these key factors:
Data Mapping and Attributes
- Searchable attributes: Salesforce Commerce B2C sets searchable attributes through the UI, which the API does not expose. Use the Catalog Data Ingestion metadata APIs to manually configure these searchable attributes in Adobe Commerce Optimizer.
- Attribute mapping: Plan the mapping of Salesforce Commerce B2C product attributes to Commerce Optimizer metadata based on your business requirements.
- Default searchable fields: The connector automatically makes core attributes (
name,description,ID) searchable by default.
Sync Scope
- Site selection: Salesforce Commerce B2C has a concept of sites that catalogs attach to. During full sync, select which Salesforce site to sync.
- Locale management: Each Salesforce Commerce locale results in a separate product ingestion cycle in Commerce Optimizer.
- Data volume: Consider catalog size and sync frequency when planning implementation.
Monitoring and management
Once installed and configured, the Commerce Optimizer SFCC Connector provides comprehensive monitoring and management capabilities from the SFCC to ACO Sync Panel:
The URL for this interface is provided after you deploy the Commerce Optimizer SFCC Connector Starter Kit to the App Builder project.
Key features include:
- Sync Status Tracking: Monitor the status and timestamps of all sync operations.
- Connectivity Validation: Test connections to both Salesforce Commerce Cloud and Adobe Commerce Optimizer.
- Product Data Validation: Verify that synchronized product data appears correctly in the storefront.
- Error Logging and Troubleshooting: Error logs for troubleshooting can be access through the App Builder CLI.
- State Management: Track sync progress and prevent conflicts with built-in state management.
Source code and development resources
The Commerce Optimizer SFCC Connector is open source and available for customization. Key repositories include:
- ACO SFCC Starter Kit - Main connector application and documentation.
- ACO SFCC Cartridges - Required SFCC cartridge for API integration.
- ACO TypeScript SDK - SDK for Adobe Commerce Optimizer integration.
These repositories provide complete source code, detailed documentation, and examples for implementing and customizing the connector.
Next Steps
Ready to integrate your Salesforce Commerce Cloud data with Adobe Commerce Optimizer? Start by reviewing the detailed implementation guide in the ACO SFCC Starter Kit repository and ensure you have the necessary prerequisites in place.