Skip to main content

DiscoveryOS Shopify App

The DiscoveryOS Shopify App enables seamless integration between your Shopify store and Particular Audience's Discovery OS platform. This app synchronizes your product catalog with our Adaptive Transformer Search (ATS) technology, merchandising, mRoutes and recommendations, providing your customers with intelligent search capabilities and personalized product discovery experiences.

Key Features​

Product Catalog Synchronization​

The app automatically synchronizes your entire Shopify product catalog, including:

  • Standard product fields (title, description, price, images, variants)
  • Custom product metafields
  • Product collections and categorization
  • Inventory levels and availability status
  • Product variants and options

Intelligent Field Configuration​

Configure which product fields and metafields are indexed for search:

  • Map standard Shopify fields to searchable attributes
  • Configure custom metafields from both products and variants
  • Handle complex JSON metafield structures
  • Extract specific data from nested JSON objects
  • Define field-level search behavior

Advanced Search Capabilities​

Power your store with Particular Audience's ATS technology:

  • Natural language search understanding
  • Typo tolerance and fuzzy matching
  • Semantic search for better relevance
  • Customizable faceted filtering
  • Flexible sorting options
  • Product availability filtering
  • Product Listing Page merchandising
  • Custom Listing Page generation with mRoutes (for SEO and GEO purposes)

Seamless Integration​

The app integrates deeply with Shopify:

  • OAuth-based secure authentication
  • Webhook subscriptions for real-time updates
  • Automatic handling of product create, update, and delete events
  • Collection synchronization
  • Privacy compliance (GDPR-ready)

How It Works​

1. Installation and Authentication​

Install the PA DiscoveryOS app from the Shopify App Store. The app uses OAuth to securely connect to your store, requesting only the necessary permissions to read products and manage configurations.

2. Credential Setup​

After installation, you'll receive client credentials from Particular Audience:

  • Client ID: Your unique organization identifier
  • Client Secret: Secure authentication token
  • Client Code: Your organization's code for API access

These credentials authenticate your store with Particular Audience's services.

3. Configuration​

Configure how your product data is indexed and searched:

  • Field Configuration: Define which product and metafield data to sync
  • Facet Configuration: Set up filters for your search results
  • Sorting Configuration: Create custom sorting options
  • Status Configuration: Define product availability criteria

4. Initial Synchronization​

Perform an initial sync to upload your product catalog to Particular Audience. The sync duration depends on your catalog size.

5. Ongoing Synchronization​

After the initial sync, the app maintains data freshness through:

  • Webhooks: Real-time updates when products are created, updated, or deleted
  • Manual Sync: Re-sync after configuration changes
  • Collection Updates: Automatic sync when collections change

Getting Started​

Ready to enhance your Shopify store with intelligent search? Follow our step-by-step guide:

  1. Installation and Setup
  2. Field Configuration Guide
  3. Facet and Sorting Setup
  4. Product Synchronization
  5. Wiidget Synchronization
  6. Theme Customization

Technical Requirements​

Required Shopify Permissions​

The app requests the following scopes:

  • read_products: Read product data
  • write_products: Update product metadata (if needed)
  • read_product_listings: Access product listings
  • read_orders: Read order data for analytics
  • read_customers: Access customer data for personalization
  • read_pixels: Read web pixel configuration
  • write_pixels: Configure web pixel for event tracking
  • read_customer_events: Access customer event data

Next Steps: Install the PA DiscoveryOS App