Getting Started
Connect Commercetools to PSYKHE AI by sharing API credentials and configuring behavioral tracking.
To power personalization on a Commercetools storefront with PSYKHE AI, you need two things in place:
- A product data connection so PSYKHE AI stays in sync with your catalog, customers, and orders.
- behavioral tracking on the storefront so PSYKHE AI can build a per-visitor taste profile in real time.
PSYKHE AI ingests Commercetools data directly - you share a Commercetools API client with PSYKHE Support, and the team configures the pipeline on our side. You do not need to run any forwarder, middleware, or queue.
Before You Begin
You need:
- A Commercetools project with administrator access.
1. Create a Commercetools API Client
Create a dedicated API client that PSYKHE AI will use to read catalog data and manage its data subscription.
- Sign in to the Merchant Center of your Commercetools project.
- On the sidebar, go to Settings → Developer settings.
- Click Create new API client.
- Name the client something identifiable, for example
psykhe-ai. - Select the following API scopes:
Required scopes
- Subscriptions
- Categories
- Customers
- Orders
- Products
- Types
- View API clients
- Click Create API client.
- Copy the generated credentials, including the
curlcommand Commercetools displays. You will share these with PSYKHE AI in the next step.
Commercetools only displays the client secret once. Copy the full curl command (or
the .env block) immediately and store it somewhere secure until you have shared it
with PSYKHE AI Support.
For more detail, see Get your API client in the Commercetools documentation.
2. Share Credentials
Send the API client details to your PSYKHE AI.
Once received, PSYKHE AI will:
- Create a Commercetools Subscription that forwards catalog, customer, and order events to the PSYKHE ingestion collector.
- Run an initial catalog backfill.
- Confirm when the data feed is live.
3. Configure behavioral Tracking
PSYKHE AI personalizes rankings using live visitor behaviour (PDP views, PLP views, clicks, add-to-cart, transactions, dwell time, and more). Install the Snowplow tracking plugin on the storefront to emit these events.
Follow the setup in the Tracking API Getting Started guide.
Next Steps
- Tracking API Getting Started - storefront tracking setup.
- Recommendation API overview - how to request personalized rankings once data is flowing.