// integration_brief // rückl × shopify × mergado

SHOPIFY ⟶ MERGADO

Napřímé propojení přes Shopify Admin API namísto XML feedu z prostředníka.

// 599 produktů · 1 custom app · 5 scopes · N výstupních feedů · 0 měsíčních feedyio fees

01

Architektura propojení

Source

SHOPIFY

sklarna-ruckl.myshopify.com

  • · Products + Variants
  • · Metafields
  • · Markets (CZ/EN)
  • · Inventory / Locations
  • · Tagy / Kolekce
  • · Translations
// OAuth + Admin API
CUSTOM APP
5 scopes · real-time
Transformer

MERGADO

editor.mergado.com

  • · Pravidla (cleanup)
  • · Mapování kategorií
  • · UTM parametry
  • · Custom labels
  • · Proměnné (regex)
  • · Audit feedů
Output Feeds
GMC · CZ
Google Shopping XML
GMC · EN
Mezinárodní markets
HEUREKA
Heureka XML
META
FB / IG catalog
✓ NO XML mezi Shopify a Mergadem — jen API
✓ NO CRON — Mergado tahá data on-demand
✓ NO 3rd PARTY feedyio.com lze zrušit
02

Tři možné cesty

★ Recommended
// VARIANT_A

Mergado ↔ Shopify napřímo

+ Plná kontrola feedu
+ Přístup k metafields a markets
+ N výstupů z jednoho zdroje
+ Real-time data
− Setup 15 min (webař)
MĚSÍČNÍ NÁKLAD: Mergado fee
feedyio → zrušit
// VARIANT_B

feedyio → Mergado

+ Funguje (Mergado vezme XML URL)
+ Žádný zásah do Shopify
− Omezeno na to, co feedyio vyexportuje
− Bez metafields a markets
− Dvojí vrstva = dvojí náklad
MĚSÍČNÍ NÁKLAD: Mergado + feedyio
// VARIANT_C — current state

feedyio → GMC napřímo

+ Žádná údržba
− Žádné úpravy feedu
− Jen 1 výstup (GMC)
− Bez custom labels = bez PPC bidding
− Heureka / Sklik / Meta řešit zvlášť
MĚSÍČNÍ NÁKLAD: feedyio
STATUS: aktuální stav
03

Brief pro webaře

// čas: ~15 min · složitost: low · žádný kód, jen klikání v Shopify Dev Dashboardu

01

Otevřít Shopify Dev Dashboard

dev.shopify.com → Apps → Create app → Start from Dev Dashboard

Název aplikace: Mergado integration

02

Nastavit App URL

# URL pole
App URL: https://app.mergado.com

Vypnout "Embed app in Shopify admin"

03

Zaškrtnout 5 oprávnění (scopes)

read_products # čtení produktů
write_products # zápis zpět (regenerace popisků apod.)
read_markets # mezinárodní markets + translations
write_markets # úpravy market settings
read_metaobjects # custom metafields (kolekce, designér, materiál...)
04

Publish & Install

Release → potvrdíš

Home → Install app → vyber sklarna-ruckl → potvrdíš instalaci

05

Zkontrolovat Markets

Settings → Markets → primární market

Domain / Language musí být v sekci "Customized", ne pouze "Inherited". Jinak Mergado neuvidí jazykové verze.

06

Předat 3 údaje (šifrovaným kanálem)

// shop_url
sklarna-ruckl.myshopify.com
// client_id
Dev Dashboard → Credentials
// client_secret
Dev Dashboard → Credentials

⚠ NE emailem, NE Slackem v plain textu — Bitwarden Send / 1Password / podobný šifrovaný kanál

04

Co děláme my (v Mergadu)

Fáze A once

Setup projektu

  • · Nový projekt v Mergadu
  • · Zdroj: Shopify
  • · 3 údaje od webaře
  • · OAuth login
  • · Kontrola importu
Fáze B once

Vstupní cleanup

  • · Skrýt "Mix & Match" junk
  • · Skrýt cenu 0 / bez obrázku
  • · Fix "PinkOdstíny" bug
  • · HTML strip z popisů
  • · Mapování kategorií
Fáze C once

Výstupy

  • · GMC CZ feed
  • · GMC EN feed (markets)
  • · Heureka feed
  • · Meta catalog
  • · UTM per output
Fáze D once

Custom labels

  • · label_0: cena bucket
  • · label_1: kolekce
  • · label_2: bestseller/novinka
  • · label_3: marže
  • · label_4: market
Fáze E recurring

Průběžná správa

  • · Měsíční audit feedu
  • · GMC errors review
  • · Nové kolekce / sezónní
  • · Sync s PPC týmem
  • · Reakce na Shopify změny

Vstupní cleanup — konkrétní pravidla pro Rückl

// 6 povinných pravidel · pořadí má význam · Mergado je vykonává shora-dolů

# Pravidlo Řeší Priorita
01 Skrytí produktů "Mix & Match example" (Easify junk), cena 0 CZK (5 ks), bez obrázku (1 ks) Critical
02 Najít a nahradit v description Bug "PinkOdstíny → Pink \n Odstíny" (tag slitý s textem) High
03 Odstranit HTML značky Nutné pro Heureku / Sklik / Zboží.cz Critical
04 Hromadné přepisování dle hodnot — availability GMC vs Heureka vs Sklik — různé formáty (in_stock vs 0 vs ano) Critical
05 Nastavit UTM parametry v link utm_source=google/heureka/seznam, utm_medium=cpc — per výstup High
06 Hromadné přejmenování kategorií Shopify kolekce → Google Product Taxonomy / Heureka kategorie Critical
05

Co tím získáme

feedyio → GMC (current) Shopify → Mergado → výstupy (target)
Měsíční náklad feedyio fee Mergado fee (feedyio zrušit)
Možnost úprav feedu ✗ žádná ✓ plná
Počet výstupních feedů 1 (GMC) neomezeně
Heureka, Sklik, Meta katalog ✗ řešit samostatně ✓ jeden zdroj → vše
Custom labels pro PPC bidding ✗ ✓
Metafields ze Shopify ✗ ✓
Markets (CZ/EN/EU/US) ✗ ✓ přes read_markets
Reakce na změny v e-shopu dle cron feedyio real-time API
Audit & GMC error tracking manuálně v GMC přímo v Mergadu
06

K vyřešení před startem

Q1

Mergado tarif

599 produktů + kolik výstupních feedů? Tarif podle počtu výstupů a produktů → mergado.cz/cenik

Q2

Scope feedyio

Co všechno feedyio aktuálně dělá? (GMC ano — co dál? Heureka? Meta?) Migrovat v jedné vlně.

Q3

Markets v Shopify

Má Rückl jen CZ, nebo i EN / EU / US? Ovlivňuje počet feedů, custom labels a měnové převody.

Q4

GTIN / EAN data

Aktuálně 0 produktů má GTIN. Paralelně s integrací řešit doplnění barcode field do Shopify — kritické pro GMC výkon.

Q5

PPC kontext

Kdo dělá Google Ads pro Rückl? Pokud my, designujeme custom labels podle bidding strategie. Pokud externí agentura, sladit co potřebují za segmentaci PŘED Fází D.