Shopify & Omnichannel Ads Guide View Privacy Policy →

Documentation & Setup Guide

Margin Tagger: Custom Labels automatically analyzes your active Shopify catalog to calculate core financial metrics. By mapping these dynamic metrics into Google Merchant Center (GMC), Meta Ads, and TikTok Ads, you can bid aggressively on winning products and protect your ad spend on low-performing inventory.

Supported Strategies

The Profit Optimizer (Margin %): [(Price - Cost) / Price] × 100
Retail Price Tiers ($): Raw Variant Price
The Cash Flow Unlock ($): Unit Cost × Inventory Quantity

1. How Your Data is Saved

To avoid conflicts with proprietary apps (like Shopify's official Google & YouTube app), Margin Tagger saves your data using Universal Metafields and Backup Tags. This allows you to sync your labels to multiple ad platforms simultaneously.

Calculated Tier Metafield Value Written Example Backup Tag Recommended Ad Strategy
Tier High High label_0_margin_high Bid aggressively with lower target ROAS to maximize volume.
Tier Mid Mid label_0_margin_mid Balanced target ROAS with moderate scaling.
Tier Low Low label_0_margin_low High target ROAS or excluded from Performance Max bidding.
Excluded / OOS Excluded label_0_margin_excluded Actively exclude from campaigns (e.g., zero inventory).
Missing Cost Unknown label_0_margin_unknown Excluded from ad spend until cost data is entered in Shopify.

2. Step-by-Step Mapping Guide

Step 1: Synchronize Catalog in Shopify

  1. Open Margin Tagger from your Shopify Admin.
  2. Select your Base Strategy and Target Slot (e.g., Custom Label 0).
  3. Click Run Global Z-Score Analysis to simulate your thresholds.
  4. Check the confirmation box and click Commit Data Sync. Wait for the progress bar to complete.

Step 2: Map to Google & Meta Ads (Recommended Method)

The most reliable way to push custom labels to advertising channels is by mapping our Metafield inside a dedicated feed app.

Using Simprosys Google Shopping Feed
  • Open Simprosys and go to Settings > Attribute Mapping.
  • Find the row for your Target Slot (e.g., Google Custom Label 0).
  • Click the dropdown, select Metafield, and choose Margin Tagger: Custom Label 0.
Using Meta Commerce Manager (Native)
  • Go to your Meta Commerce Manager Catalog > Data Sources.
  • Select your Feed, go to Settings > Feed Rules.
  • Create a rule to map the Metafield pro_tagger_label.custom_label_0 to the Facebook custom_label_0 column.

Step 3: Segment Campaigns in Google Ads

  1. Open Google Ads and navigate to your Performance Max or Standard Shopping campaign.
  2. Open Listing Groups (or Asset Groups > Listing Groups).
  3. Click Subdivide and select Custom Label 0.
  4. Assign custom target ROAS values or exclude low-margin products entirely.
Pro-Tip for Performance Max Excluding products labeled Unknown or Excluded prevents Google AI from wasting budget on items with unverified unit margins or zero stock.

3. Frequently Asked Questions (FAQ)

How are multi-variant products handled?

Use the Multi-Variant Logic selector before running your analysis:
• Use Lowest Tier (Recommended): Tags the product based on the least profitable variant to avoid overspending on mixed items.
• Average Values: Computes the arithmetic mean across all variants.
• Use Highest Tier: Tags the product based on its top-performing variant.

Why is there a 1,000 product limit on V1?

V1 is optimized for stores with up to 1,000 active products to ensure fast, precise API data syncing without crashing your browser or timing out. A V2 Enterprise Bulk Sync architecture is currently in development for massive catalogs.

How quickly do tag updates reflect in Google Ads?

Once the sync progress bar completes, changes are live in Shopify instantly. Your feed app (like Simprosys) will fetch these updated Metafields and pass them to Google during its next scheduled sync (typically within 1 to 24 hours).

4. Support & API Compliance

Technical Assistance & Inquiries:

Email: support@vektorapps.com

Response Time: Within 24–48 business hours (Monday to Friday)

Built with Shopify App Bridge v4 & API version 2026-07. Fully compliant with GDPR data minimization protocols.