Architecture overview: why Karsa.ai uses a supplemental XML source
Karsa.ai never modifies your online store backend and never overwrites your primary product feed. Instead, Karsa.ai hosts an authenticated HTTPS XML file containing only two fields per product:
<item>
<g:id>SKU-10482</g:id>
<g:custom_label_4>karsa_c3</g:custom_label_4>
</item>
Google Merchant Center joins those values onto your primary product data source by <g:id> automatically every night.
Step-by-step setup in Google Merchant Center (10 minutes)
| Step | Action | Where to Click |
|---|---|---|
| Step 1 | Copy your unique Supplemental Feed HTTPS URL and choose your target custom_label slot (0–4) |
Karsa.ai Portal → Settings → Output Feed |
| Step 2 | Activate the free Advanced data source management add-on (if not already enabled on your account) | Google Merchant Center → Settings → Add-ons → Discover |
| Step 3 | Open Supplemental sources → click Add supplemental product data → Add products from a file → paste your Karsa.ai HTTPS URL | Google Merchant Center → Products → Data sources → Supplemental sources |
| Step 4 | Set fetch frequency to Daily at 8:00 AM local store time and link the supplemental source to your primary product data source | Schedule & Primary Data Source Link |
| Step 5 | Trigger Update once and verify in product details that custom_label_X is populated |
Google Merchant Center → Products → All products |
| Step 6 | Filter each Standard Shopping Product Group or Performance Max Listing Group by custom_label_X (karsa_c0, karsa_c1, karsa_c2, …) |
Google Ads → Campaign Inventory / Listing Groups |
Pre-flight checklist to avoid overlapping product bidding
Before enabling live budgets on your new cluster campaigns in Google Ads, verify two rules:
- Mutually exclusive Listing Groups: Every cluster value (
karsa_c0,karsa_c1,karsa_c2, …) belongs to its intended campaign, plus one default subdivision (Everything else in All products) in your mid/default campaign so newly added SKUs arriving intra-day before tonight’s run remain covered. - Independent daily budgets: Do not place
C1(or the optionalC0) inside a shared Google Ads budget with your top clusters (C3,C4).
Frequently asked questions
Where are Supplemental sources located in the current Google Merchant Center interface?
In Google Merchant Center, Supplemental sources appear after you activate the free Advanced data source management add-on under Settings → Add-ons → Discover. Once enabled, open Products → Data sources → Supplemental sources and paste your Karsa.ai HTTPS XML URL.
What time should Google Merchant Center fetch the Karsa.ai supplemental feed?
Schedule the daily Merchant Center fetch for 8:00 AM local store time, after your Karsa.ai nightly calculation completes, so updated custom_label values propagate before peak daytime shopping traffic.