MEA catalog.
The MEA catalog is powered by an Eventgift file feed and is currently a staff-only bulk catalog surface. It is more tightly filtered than most catalogs because stock and availability need extra care.
Snapshot
| Customer-facing tab | MEA, visible to staff only unless flags change. |
| Catalog ID | MEA |
| Main input | Eventgift JSON file feed in Google Cloud Storage. |
| Default visibility | Only published, visible, in-stock products are eligible. Low stock and unknown stock can hide products. |
| Currency handling | Prices are converted from AED to USD during the sync. |
Input Sources
Eventgift sends a JSON file that looks like a WooCommerce-style export. Rows include parent products and variants. PerkUp groups variants under their parent product, filters to visible published products, and builds one normalized MEA product.
The feed includes product descriptions, categories, images, image metadata, brands, color-like attributes, prices, stock status, and visibility/status fields.
Available vs Stored Data
| Source data available | What PerkUp stores |
|---|---|
| Parent and variant rows with ID, SKU, title, content, short description, categories, image URLs/titles/alt/captions, brands, colors, prices in AED, stock values, stock status, and visibility. | Cleaned product name, category/categories, description, SKU, brand, images, colors/color options, USD price tiers, full decoration level, provider, and MEA catalog assignment. |
| Stock status and numeric stock can be present in the feed. | Stock information is mainly used to decide visibility. Products with low stock, out-of-stock status, or unknown availability may be hidden rather than shown with detailed variant inventory. |
| Color data may come from attributes, URLs, slugs, or image clues. | PerkUp stores normalized colors and color options, using supplier data first and AI/image analysis where needed. |
AI Enrichment
- AI standardizes product category, package size, and imprint locations.
- AI analyzes images for color mapping, view/location hints, and image quality.
- AI enrichment is focused on products that can actually be published, because the feed can contain items that are not safe to show.
Audit Notes
- The MEA tab is staff-only and published-only in the catalog flags.
- Products can be hidden when stock is below the threshold, out of stock, or not clearly in stock.
- Best Sellers are hidden from MEA because fulfillment assumptions differ from the US/EU/Canada catalog surfaces.
- Eventgift is not listed as a regular scheduled catalog job in the current scheduler docs, so confirm freshness during the audit.
Source: functions/src/catalogs/bulk-swag/eventgift · functions/src/catalogs/ai · proto/perkup/v1/cart.proto · apps/frontend/src/pages/bulk-swag