Index content using the Coveo app for Shopify
Index content using the Coveo app for Shopify
The Coveo AI Search & Discovery app aims to automate as much of the onboarding process as possible, requiring minimal intervention on your part. This article lists a few scenarios that require you to manually sync your Shopify product catalog with Coveo and provides an overview of the resources created during the synchronization process.
When to manually sync your catalog
You must manually launch a sync of your Shopify product catalog with Coveo in the following situations:
-
You first link your store to your Coveo organization
-
You add or delete a new market
-
You add or delete a country within a market
-
You add or delete a language within a market
-
You change a market’s base currency
-
You change your multi-market domain setup
-
You change add or delete product or variant metafields
, or change which ones to use as Coveo custom fields or facets -
You change a store domain
Resources
This section provides an overview of the resources created in your Coveo organization when you sync your Shopify product catalog using the Coveo AI Search & Discovery app.
Sources and catalog entities
A source is a type of index container that holds a set of items. A catalog entity is a commerce-specific resource that establishes a catalog data structure and enables Coveo Machine Learning (Coveo ML) and usage analytics reporting.
When you sync your Shopify product catalog with the Coveo Platform, the Coveo AI Search & Discovery app uses the Shopify GraphQL Admin API to retrieve your market languages, regions, and base currencies.
In your Coveo organization, the app then creates one GraphQL API source per market and language combination to index your products.
It also creates one matching catalog entity per source.
These catalog entities have the same name as their matching sources.
|
Note
At the moment, the Coveo AI Search & Discovery app only supports base currencies, not local currencies |
Every source is automatically configured for Commerce and uses the default source-update-schedule. The app also creates the storefront associations to associate your catalog entities to your storefronts in the target locales.
Each of these sources scans your Shopify store for products and their variants, indexing the active ones. You can therefore have multiple Coveo items for a single Shopify product or variant, each corresponding to a specific market and language combination.
You have three markets: the US, Canada, and a simplified "Europe" that consists of France and Germany. These markets have the following language pairings:
-
US: English
-
Canada: English, French
-
Europe: French, German
There will be five sources with names that are automatically generated using unique identifiers:
There will also be five matching catalog entities:
Fields
A field is an index-wide container that holds information about each item.
When syncing your Shopify product catalog with Coveo, the Coveo AI Search & Discovery app automatically indexes standard commerce fields. These fields are preselected by default and can’t be unselected.
|
|
Note
If any of the fields in your Coveo organization have the same names as the standard fields, but their types don’t match, you’ll see an error message. However, you can’t edit field types once they have been created in the Coveo Administration Console. You’ll have to delete and recreate them. |
Besides the standard fields, you can index up to 50 additional Shopify product metafields as Coveo custom fields to enhance the search experience.
The app also lets you select which fields you would like to use as facets in your search interface. You can only use fields that are explicitly facet-enabled when creating facets in your search interface.
Delete and recreate fields
You can’t edit field types in the Coveo Administration Console.
If there’s a type mismatch between the standard fields used by the app and fields in your Coveo organization with the same names, you’ll have to delete your existing fields and recreate them with the expected types.
For example, if you have an existing string-type field named ec_price, you’ll see an error when you try to sync because the app expects that field to be a decimal.
To delete and recreate fields:
-
In the Administration Console, delete any mappings that are related to the fields you want to replace.
Because mappings exist in all sources, you’ll have to delete the target mappings in all sources.
-
On the Fields
(platform-ca | platform-eu | platform-au) page, select the field that you want to delete and click Delete in the menu bar, then click Delete again to confirm.
You can’t select multiple fields at once in the Administration Console, so you’ll have to repeat this step for every field that you want to delete. -
Add one or more new fields. Make sure that every new field uses the correct type.
-
Recreate any mappings related to the new fields.
You’ll have to recreate the target mappings in all sources.
Tracking IDs and properties
A tracking ID is a unique identifier, such as market_21547057248, which is used to link events so that they can be analyzed and attributed to the right product discovery solution.
A property is equivalent to one tracking ID, except that it has a user-readable display name, such as Europe.
The Coveo AI Search & Discovery app creates one tracking ID and matching property per market.
Storefront associations
A storefront association connects a catalog entity with a specific tracking ID and locale.
The Coveo AI Search & Discovery app creates one storefront association per market and locale combination.
You have three markets: the US, Canada, and a simplified "Europe" that consists of France and Germany. Based on the languages available in each market, there are five sources and therefore five catalog entities.
Both of the European countries in this example have two locales, one for each language that’s configured for the market.
For example, Germany has the locales de-DE-CAD and fr-DE-CAD.
In total, there will be seven storefront associations:
Query pipelines
A query pipeline is a set of rules that modify queries.
The Coveo AI Search & Discovery app creates one query pipeline for each market and product discovery solution combination.
You have three markets: the US, Canada, and Europe. Coveo for Commerce has three product discovery solutions: search, product listings, and recommendations.
There will be ten query pipelines, including the default:
Source update schedule
By default, if you enable automatic catalog synchronization, the Coveo sources are updated according to the following schedule:
Very useful
Not really