Documentation Hub

Feed Rule Engine

Powerful rule-based feed configuration with field mapping and conditional rules

Feed Rule Engine

The Feed Rule Engine is the core configuration interface for creating and managing product feeds. It provides a tab-based interface for organizing all feed settings.


Architecture Overview

The Feed Rule Engine uses a unified architecture that handles both AI and Non-AI feed generation:

┌─────────────────────────────────────────────────────────────┐
│              Feed Rule Engine Configuration                 │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  1. Basic Information                                        │
│     └─ Feed name, country, language, currency               │
│                                                              │
│  2. Target & Products                                        │
│     └─ Product filtering, collections, vendors, tags        │
│                                                              │
│  3. Product Details                                          │
│     └─ Field mappings, conditional rules, AI settings       │
│                                                              │
│  4. Campaigns & Others                                       │
│     └─ Promotions, shipping, tax settings                   │
│                                                              │
│  5. Advanced Settings                                        │
│     └─ File format, custom fields, metafields               │
│                                                              │
└─────────────────────────────────────────────────────────────┘

Configuration Tabs

1. Basic Information

Configure fundamental feed settings:

SettingDescriptionDefault
Feed NameDisplay name for the feedRequired
Target CountryTarget market country codeUS
LanguageFeed languageen
CurrencyProduct currencyStore default
File FormatOutput format (TSV/CSV/XML)TSV

2. Target & Products

Define which products to include:

Product Filters:

  • Collections: Select specific product collections
  • Vendors: Filter by product vendor
  • Product Types: Filter by product type
  • Tags: Include or exclude by tags
  • Price Range: Min/max price constraints
  • Stock Status: Exclude out-of-stock items
  • Sales Channels: Filter by sales channel
  • Inventory Locations: Filter by location

3. Product Details

Configure field mappings and AI settings:

Field Mappings:

Google FieldSource Options
idProduct ID, SKU, Custom
titleProduct title, AI-generated, Template
descriptionProduct description, AI-generated, Template
linkProduct URL
image_linkFeatured image
priceVariant price
availabilityInventory status
brandVendor, Custom
gtinBarcode
mpnSKU

Conditional Rules:

  • Apply different values based on product conditions
  • Support for collection, vendor, type, and tag conditions
  • Override default mappings for specific products

4. Campaigns & Others

Marketing and additional settings:

  • Promotion IDs: Link to Google promotions
  • Shipping Settings: Shipping cost configuration
  • Tax Settings: Tax rate configuration
  • Custom Labels: Up to 5 custom labels for segmentation

5. Advanced Settings

Advanced configuration options:

  • Custom Fields: Add non-standard Google attributes
  • Metafield Mapping: Use Shopify metafields as data source
  • ID Strategy: Configure product ID format
  • Image Settings: Image size and quality options

Field Mapping Rules

Template Variables

Use template variables to build dynamic field values:

VariableDescription
{{ product_title }}Product title
{{ product_description }}Product description
{{ vendor }}Product vendor
{{ product_type }}Product type
{{ variant_title }}Variant name
{{ price }}Variant price
{{ sku }}Variant SKU
{{ barcode }}Variant barcode

Example Template:

{{ product_title }} - {{ variant_title }} by {{ vendor }}

Conditional Rules

Apply rules based on conditions:

{
  "conditions": [
    { "field": "vendor", "operator": "equals", "value": "Nike" }
  ],
  "actions": [
    { "field": "brand", "value": "Nike" }
  ]
}

Supported Operators:

  • equals / not_equals
  • contains / not_contains
  • starts_with / ends_with
  • greater_than / less_than

Live Preview

Preview feed output before generating:

  1. Select a sample product from your catalog
  2. View all mapped field values
  3. See AI-generated content (if enabled)
  4. Verify conditional rule application

Generation Flow

Retrieve products via Shopify Bulk Operations API

Add metafields and market-specific information

Filter products based on configured rules

Create AI-optimized content (if enabled)

Generate TSV/CSV/XML file with mapped fields

Store feed file and update database


Performance

Shop SizeProductsNon-AIAI-Enabled
Small<1005-15s20-40s
Medium100-50015-30s40-120s
Large500-100030-60s120-300s
Enterprise1000+60-120s300-600s

Best Practices

  1. Start Simple: Begin with basic mappings, add complexity as needed
  2. Use Templates: Create reusable templates for common configurations
  3. Test with Preview: Always preview before generating
  4. Monitor Performance: Check generation times and optimize filters
  5. Leverage AI: Use AI for high-value products that need optimization

On this page