Google AI Commerce Search Connector Setup Guide
AI Commerce Search, formerly known as Vertex AI Search for Commerce, provides Google-quality search, browse, and recommendations for ecommerce experiences.
API information
This connector uses the following vendor API:
- API Name: Google API
- API Version: v2
- API Endpoint:
https://retail.googleapis.com - Documentation: AI Commerce Search
Configuration
Go to the connector marketplace and add a new connector. For more information, see About connectors.
After adding the connector, configure the following settings:
- Google Cloud Platform Project ID: (Required) Your Google Cloud project ID with AI Commerce Search enabled.
- Private key JSON file: (Required) Paste the JSON key generated for your service account. The service account requires the
retail.userEvents.createandretail.catalogs.listpermissions. Google recommends using the Retail Editor role, which includes both permissions.
After you configure the connector, click Done.
Actions
| Action name | Visitor profile | Event data |
|---|---|---|
| Write User Event | ✗ | ✓ |
Enter a name for the action and select the action type.
The following section describes how to set up parameters and options for each action.
Write User Event
Parameters
| Parameter | Description |
|---|---|
| Catalog | Select the AI Commerce Search catalog where user events will be recorded. |
| Event Type | Choose the type of user event to send to AI Commerce Search. This determines how the event is interpreted and which fields are required in the payload.
|
Event Data
| Parameter | Description |
|---|---|
| Attributes | Map extra user event features to include in the recommendation model |
| Template Variables |
|
| Templates |
|
This page was last updated: November 18, 2026