Google Vertex AI Search for Commerce Connector Setup Guide
This article describes how to set up the Google Vertex AI Search for Commerce connector.
API Information
This connector uses the following vendor API:
- API Name: Google API
- API Version: v2
- API Endpoint:
https://retail.googleapis.com - Documentation: Vertex AI Search for commerce
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. The project must have Vertex Search AI 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.
- The service account requires access to
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 Vertex AI Search for Commerce catalog where user events will be recorded. |
| Event Type | Choose the type of user event to send to Vertex AI Search for Commerce. 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: January 13, 2026