۶Ƶ

[SaaS only]{class="badge positive" title="Applies to ۶Ƶ Commerce as a Cloud Service and ۶Ƶ Commerce Optimizer projects only (۶Ƶ-managed SaaS infrastructure)."}

Get Started

This guide walks you through setting up ۶Ƶ Commerce Optimizer from start to finish. While this guide covers all roles, see the for detailed developer-specific content.

Prerequisites

Before you begin, ensure you have:

  • ۶Ƶ Experience Cloud account with ۶Ƶ Commerce Optimizer entitlements
  • Organization admin access to create instances and manage users
  • GitHub account for loading sample data and storefront development
  • Basic understanding of e-commerce concepts

Quick Start guide

Follow these essential steps to get your ۶Ƶ Commerce Optimizer environment running:

Step 1. Create an instance

  1. Log in to .

  2. Navigate to Commerce > Commerce Cloud Manager.

  3. Click Add Instance > Commerce Optimizer.

    Create Instance {width="60%" modal="regular"}

  4. Configure instance settings:

    • Name: Descriptive name (for example, “My Company Sandbox”)
    • Description: Brief description of purpose
    • Region: Select your preferred region
    • Environment Type: Start with a Sandbox environment for testing
  5. Click Add Instance.

    The Cloud Manager updates to include your new instance. For details on accessing and managing it, see Manage an instance.

NOTE
Sandbox instances are limited to the North America region. You cannot change the region after creation.

Step 2. Set up your environment

After creating your instance:

  1. Manage your instance from Commerce Cloud Manager.
  2. Configure user access using the User Management guide.

Step 3. Add sample data (Optional)

For testing and learning, follow the Load Sample Data instructions.

Role-Based workflows

۶Ƶ Commerce Optimizer setup and management rely on three key roles. Each role has specific tasks and responsibilities:

High-Level Workflow {modal="regular"}

Administrator tasks

Administrators manage instances, users, and organizational settings.

Task
Description
Link
Manage Users
Add users, developers, and admins
User Management
Create Instances
Set up sandbox and production environments
Create Instance
Manage Instances
Check status, update instance name and description, and get key URLs for application and API access
Manage Instances
Configure Access
Set up catalog views and policies
Catalog Views

Developer tasks

Developers handle technical implementation and data integration, including platform architecture tasks.

Task
Description
Link
Access Developer Console
Create projects and generate credentials
Ingest Catalog Data
Import product data from existing systems
Set Up the Storefront
Configure Edge Delivery Services storefront
Storefront Setup

Merchandiser tasks

Merchandisers optimize and personalize the shopping experience through product discovery and recommendations. They also use shopper data and analytics to make strategic decisions about product placement, pricing, and promotions on the storefront.

Task
Description
Link
Product Discovery
Configure search and filtering
Merchandising Overview
Recommendations
Set up AI-powered product recommendations
Product Recommendations
Performance Tracking
Monitor success metrics
Success Metrics

Manage instances

Manage instances from the Commerce Cloud Manager.

NOTE
Not all ۶Ƶ Commerce Optimizer users have access to Cloud Manager. Access depends on the role and permissions assigned to the user account.
  1. Log in to .

  2. Open Commerce Cloud Manager:

    • Under Quick access, click Commerce.
    • View your available instances.

Search and filter instances

After you log in, the dashboard shows all Commerce product instances available in the organization.
The Product column indicates which Commerce application the instance is provisioned for.

Instance search and filter {modal="regular"}

Use the Filter and Search tools to quickly find specific instances by date created, region, creator, product type, environment, or status.

Access the ۶Ƶ Commerce Optimizer application

Once the app is open, easily switch between environments like sandbox and production to view data and settings for each one without returning to the Commerce Cloud Manager.

  1. From the Commerce Cloud Manager, click the instance name to open the ۶Ƶ Commerce Optimizer application.

  2. Switch between ۶Ƶ Commerce Optimizer instances without leaving the application.

    The instance drop-down lists all Optimizer instances available in the organization. Select the instance to view.

    Instance Switcher {modal="regular"}

Get instance details

View the instance details by clicking the information icon next to your instance name.

Instance Details {width="60%" modal="regular"}

Note the following key information:

  • GraphQL endpoint to retrieve Commerce catalog data using the Merchandising API
  • Catalog Service endpoint for data ingestion using the REST API
  • Commerce Optimizer URL to access the ۶Ƶ Commerce Optimizer application
  • Instance ID the unique tenant ID that identifies the instance

If you are a developer, you need these details to set up your development environment and connect to the ۶Ƶ Commerce Optimizer APIs.

NOTE
To access the instance details, you must have the necessary permissions in your ۶Ƶ IMS organization. If you do not see the instance details or cannot access the application, contact your organization administrator.

Edit instance name and description

Update the instance name and description as needed.

  1. Click the Edit icon next to an instance name.
  2. Update the Instance name and Description as needed.
  3. Click Save.

Add sample data

۶Ƶ provides a GitHub repository with sample data and tools to help you learn and test ۶Ƶ Commerce Optimizer features.
The sample data is based on the Carvelo business scenario and includes:

  • Product catalog with automotive parts
  • Multiple price books and pricing scenarios
  • Catalog views and policies for different dealers
  • Complete end-to-end workflow examples

Load the sample data:

  1. Access the GitHub repository.

  2. Follow the setup instructions in the repository’s README file to complete the following tasks:

    • Set up your environment
    • Complete the data ingestion process
    • Create catalog views and policies using the sample data
    • Verify the data ingestion by checking the Catalog Service data on the Data Sync page

Next Steps

After completing the setup:

  1. Set up your storefront:

  2. Explore the Carvelo use case:

  3. Configure merchandising:

  4. Monitor performance:

Troubleshooting

Common issues

Issue
Solution
Cannot create an instance
Verify that you have ۶Ƶ Commerce Optimizer entitlements and admin permissions.
Instance not appearing
Check your ۶Ƶ IMS organization and refresh the page.
Cannot access instance
Ensure that you’re added as a user in the Admin Console.
Sample data not loading
Verify your instance credentials and API endpoints.

Get help

recommendation-more-help
0c009cf6-d957-4a6a-b642-3577df53e8cb