Enables or disables the AI Product Recommendation module for the selected store view. When

set to Yes, the extension activates synchronization with Google Vertex AI and allows

recommendation models to be used on the storefront. When set to No, all AI-based

recommendation functionality will be disabled for that scope.

Defines the maximum number of recommended products that will be displayed in each

recommendation block on the storefront. The value must be between 1 and 10. Adjusting this

value allows merchants to control the number of AI-generated product suggestions shown to

customers.

Allows administrators to select additional Magento product attributes that should be exported

and synchronized with Google Vertex AI. These attributes enrich the catalog data used by the

AI models to generate more accurate and context-aware recommendations. By default, SKU

and Manufacturer (mapped as Brand) are always included in the export. Adding more attributes

such as category, color, size, or description improves recommendation accuracy.

Specifies which storefront user interactions should be tracked and sent to Google Vertex AI for

model training and personalization. These events help the AI engine understand customer behavior

patterns and generate more relevant recommendations. Supported events include actions such as

Home Page View, Category Page View, Product Detail Page View, Add to Cart, Remove From Cart,

Shopping Cart Page View, Purchase Complete, and Search. Tracking these events ensures continuous

learning and optimization of recommendation models.

Specifies the main AI service provider used to generate product recommendations for the store.

In this configuration, Google Vertex AI is selected as the primary provider, enabling the

extension to utilize Google's machine learning models for delivering personalized product

suggestions based on customer behavior and catalog data.

Allows administrators to select a provider responsible for generating product embeddings used

by the AI recommendation models. By default, this is set to Google Vertex AI. If left unchanged,

the system will use the same provider configured in the Primary AI Provider setting. This option

is useful when merchants want to override the embedding service with a different AI provider.

This button verifies the connection between Magento and the configured AI providers. When clicked,

the system performs a connection test to ensure the AI service credentials and configuration are valid

and that Magento can successfully communicate with the AI provider. This helps administrators confirm

that the integration with Google Vertex AI is properly configured before enabling recommendation features

on the storefront.

Enter the Google Cloud Project ID associated with your Google Cloud account where Vertex

AI Search for Commerce is configured. This project ID allows the Magento extension to

connect with your Google Cloud environment and access the AI recommendation services.

Specifies the Google Cloud region or location where the Vertex AI services are deployed. The

default value is global, which is recommended for most implementations as it allows Vertex AI

to operate across multiple regions for optimal performance and availability.

Defines the Vertex AI catalog identifier used for storing and managing product data within

Google Cloud. By default, this value is set to default_catalog, which represents the primary catalog

where Magento product data will be synchronized and used for training recommendation models.

Select the catalog branch used for managing product imports and recommendation serving. Branches

help manage different versions of catalog data within Vertex AI. Options such as Branch 0, Branch 1,

and Branch 2 allow administrators to control which catalog branch is used for product synchronization

and recommendation generation.

This action sets the selected Branch ID as the default serving branch used by the Vertex AI Predict and

Search APIs. Once set, all recommendation queries will retrieve results from this branch. A confirmation

prompt may appear before applying the change to prevent accidental switching.

1. Navigate to Service Accounts

• Open the Google Cloud Console.
• In the top search bar, type "Service Accounts" and select the result under "IAM & Admin."

• Alternatively, use the Navigation Menu (☰) in the top-left corner -> IAM & Admin -> Service accounts.

2. Create the Service Account

• Click + CREATE SERVICE ACCOUNT at the top.
• Details: Give it a name (e.g., magento-vertex-sync) and a description. Click Create and Continue.
• Grant Roles: For your Magento integration to work correctly, you need to grant specific permissions. Search for and add:
  
  • Vertex AI Administrator (for full access) OR Vertex AI User (for just search/predict).
  • Discovery Engine Admin (specifically for Vertex AI Search/Retail features).
• Click Continue and then Done.

3. Generate the JSON Key

• In the list of service accounts, find the one you just created and click on its Email address.
• Click the Keys tab in the top navigation bar.
• Click Add Key -> Create new key.
• Ensure JSON is selected and click Create.

Paste the Google Cloud Service Account JSON key generated from your Google Cloud Console. This

credential allows Magento to securely authenticate with Google Cloud APIs and perform operations such

as product catalog synchronization, event tracking, and retrieving AI-powered product recommendations.

This option allows administrators to manually clear the cached recommendation data generated

by the Vertex AI integration for the current store. Clicking the Clear Vertex AI Cache button

removes stored recommendation responses so that the system fetches fresh results from

Google Vertex AI. This is useful when catalog data, configuration settings, or recommendation

models have been updated and you want the storefront to reflect the latest AI-generated

recommendations immediately.

Defines the duration (in hours) for which AI-generated product recommendations are cached

before being refreshed. Acceptable values range from 1 to 168 hours. Lower values ensure

more real-time recommendations, while higher values improve performance by reducing API

calls to Vertex AI.

Exports customer demographic data from Magento to Google Vertex AI. This data helps

the AI models understand customer segments and improve personalization for product

recommendations.

Synchronizes the Magento product catalog with Vertex AI. Product information such as SKU,

title, categories, and selected attributes is exported so the AI engine can analyze catalog data

and generate accurate recommendations.

Exports Add to Cart activity and quote data to Vertex AI. These behavioral signals help the AI

model understand customer purchase intent and improve recommendations like Frequently

Bought Together.

Sends historical order and purchase data to Vertex AI. This information is used to identify buying

patterns and train recommendation models such as Buy It Again and Frequently Bought Together.

Generates and exports Product Detail Page view events to Vertex AI. These events are required for

training recommendation models such as Recommended for You or Others You May Like. A minimum

number of events (typically 10,000 or more) is recommended for accurate AI training.

Generates Home Page view events and sends them to Vertex AI. These events help train AI models

used for homepage personalization and product discovery recommendations. A minimum dataset

(typically 10,000 events) is recommended for optimal results.

Enables or disables the Recently Viewed Model Type recommendation block for the selected store

view. When set to Yes, the system displays recently viewed products to customers on the storefront.

When set to No, the recently viewed recommendation section will not appear.

Defines the storefront pages where the Recently Viewed Products block will be displayed. Merchants

can choose one or more locations such as Home Page, Product Page, or Cart Page to control where

the recommendations appear.

Specifies the main title displayed above the recently viewed products section on the storefront. This

helps identify the recommendation block for customers. Example: Recently Viewed Products.

Allows administrators to define a subtitle or descriptive text displayed below the main title. This text

provides additional context for customers about the recommendation block. Example: Products you

recently viewed.

Determines the display priority of the recently viewed products section relative to other recommendation

blocks on the page. Lower values display the section earlier, while higher values place it further down the page.

Enables or disables the Recommended for You recommendation model for the selected store view.

When set to Yes, AI-driven personalized product recommendations will be displayed on the storefront.

When set to No, this recommendation block will not appear.

Defines the pages where the Recommended for You product recommendations will appear. Administrators

can choose one or more locations such as Home Page, Product Page, or Cart Page to strategically display

personalized recommendations to customers.

Specifies the main title displayed for the Recommended for You recommendation block on the storefront.

This title helps customers understand the purpose of the recommendations. Example: Recommended for You.

Defines the subtitle shown below the main title in the recommendation section. This text provides additional

context to encourage customers to explore the suggested products. Example: Products we think you'll love.

Determines the display priority of the Recommended for You section relative to other recommendation blocks

on the page. Lower values display the section earlier, while higher values place it further down in the page layout.

Enables or disables the Others You May Like recommendation model for the selected store view.

When enabled, the system displays AI-generated product suggestions that are relevant to the

product currently viewed by the customer. When disabled, this recommendation block will not be

shown on the storefront.

Defines the pages where the Others You May Like recommendations will appear. Administrators

can select one or more locations such as Home Page, Product Page, or Cart Page to display the

recommendation block.

Specifies the main heading displayed above the recommendation section on the storefront. This title

helps customers identify the purpose of the recommendations. Example: Others You May Like.

Allows administrators to define a descriptive subtitle shown below the main title. This text provides

additional context and encourages customers to explore similar product suggestions. Example: Similar

products you might enjoy.

Determines the display priority of the Others You May Like recommendation block relative to other

recommendation sections on the page. Lower values appear earlier in the page layout, while higher

values place the block further down the page.

Enables or disables the Frequently Bought Together recommendation model for the selected store

view. When enabled, the system displays AI-generated product suggestions that are commonly

purchased together with the currently viewed or selected product. When disabled, this

recommendation section will not appear on the storefront.

Defines the pages where the Frequently Bought Together recommendations will be displayed.

Administrators can choose one or more locations such as Home Page, Product Page, or Cart Page

to show these recommendations.

Specifies the main title displayed above the Frequently Bought Together recommendation block

on the storefront. This title helps customers identify related product suggestions. Example: Frequently

Bought Together.

Allows administrators to define a descriptive subtitle displayed below the main title. This message

encourages customers to explore additional products that other customers have purchased with

the same item. Example: Customers who bought this also bought.

Determines the display priority of the Frequently Bought Together section compared to other

recommendation blocks on the page. Lower values display the section earlier, while higher values

position it further down the page layout.

Enables or disables the Similar Items recommendation model for the selected store view. When

enabled, the system displays AI-generated product suggestions that share similar attributes with the

currently viewed product, such as category, brand, color, or other product characteristics. When

disabled, the similar items recommendation block will not appear on the storefront.

Defines the pages where the Similar Items recommendations will be displayed. Administrators can

select one or more locations such as Home Page, Product Page, or Cart Page to control where

the recommendation block appears.

Specifies the main title displayed above the Similar Items recommendation section on the storefront.

This heading helps customers identify alternative or related product suggestions. Example: Similar Items.

Allows administrators to define a descriptive subtitle displayed below the main title. This text provides

additional context and encourages customers to explore similar products. Example: Products similar to this one.

Determines the display priority of the Similar Items recommendation block relative to other recommendation

sections on the page. Lower values display the section earlier, while higher values place it further down the page layout.

Enables or disables the Buy It Again recommendation model for the selected store view. When

enabled, the system displays AI-generated product suggestions based on items the customer has

previously purchased. When disabled, the Buy It Again recommendation section will not appear on

the storefront.

Defines the pages where the Buy It Again recommendations will be displayed. Administrators can

select one or more locations such as Home Page, Product Page, or Cart Page to show previously

purchased product suggestions.

Specifies the main title displayed above the Buy It Again recommendation block on the storefront.

This heading helps customers easily identify products they have purchased before. Example: Buy It Again.

Allows administrators to define a descriptive subtitle displayed below the main title. This text encourages

customers to quickly reorder products they have previously purchased. Example: Products you've purchased before.

Determines the display priority of the Buy It Again section relative to other recommendation blocks on the

page. Lower values display the section earlier, while higher values position it further down the page layout.

Enables or disables the On Sale recommendation model for the selected store view. When enabled,

the system displays AI-generated product recommendations for items that are currently discounted

or part of an active promotion. When disabled, the On Sale recommendation block will not appear

on the storefront.

Defines the pages where the On Sale product recommendations will be displayed. Administrators

can choose one or more locations such as Home Page, Product Page, or Cart Page to highlight

promotional products to customers.

Specifies the main title displayed above the On Sale recommendation block on the storefront. This

heading helps customers easily identify discounted or promotional products. Example: On Sale.

Allows administrators to define a subtitle displayed below the main title. This message highlights the

value of the promotion and encourages customers to explore discounted products. Example: Great

deals you don’t want to miss.

Determines the display priority of the On Sale section relative to other recommendation blocks on the

page. Lower values display the section earlier, while higher values position it further down in the page layout.