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 general instructions on how to add a connector, 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 access to
retail.userEvents.import. Google recommends using the Retail Editor role.
Actions
| Action Name | AudienceStream | EventStream |
|---|---|---|
| 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: October 28, 2026