Anleitung
Einrichtung und Support
Aktualisiert September 2026. Wie Qinci deinen Katalog liest, wie die Einrichtung funktioniert, und Antworten auf die häufigsten Fragen. Die vollständige Anleitung mit jedem Settings-Bildschirm findest du nach der Installation unter Guide in der App.
Was Qinci liest
Qinci empfiehlt anhand der INCI-Inhaltsstoffliste jedes Produkts, in dieser Reihenfolge: dem Metafeld custom.inci_list, einer "Inhaltsstoffe:"-Liste in der Produktbeschreibung, oder einer eingebauten Referenztabelle mit rund 250 gängigen Fremdmarken-Produkten (The Ordinary, CeraVe, La Roche-Posay, COSRX, Paula's Choice, Beauty of Joseon, Anua und mehr). Ein Produkt ohne eines davon wird einfach nicht bewertet - es stört nie eine Empfehlung, es fehlt nur.
Einrichtung in fünf Schritten
- Installieren und Berechtigungen bestätigen. Qinci liest Produkte, Bestellungen und Metafelder und schreibt einen kleinen automatischen Rabatt - sonst nichts.
- Katalog synchronisieren lassen. Läuft automatisch bei der Installation. Das Dashboard zeigt danach, wie viel Prozent deines Katalogs eine lesbare Inhaltsstoffliste hat.
- Lücken schließen. Siehe den nächsten Abschnitt, wenn die Abdeckung niedrig ist.
- Storefront-Widget einschalten. Online-Shop → Themes → Anpassen → App-Einbettungen → "Qinci widget loader" → an → Speichern.
- Zum Testen ein Produkt in den Warenkorb legen. Die Empfehlungskarte erscheint auf der Produktseite und im Warenkorb und prüft nach jeder Warenkorbänderung neu.
Die Inhaltsstoffliste zuordnen
Das lohnt sich zuerst, denn alles andere hängt davon ab. Zwei Wege, eine Lücke in der Abdeckung zu schließen:
- Metafeld - die Inhaltsstoffliste in
custom.inci_listbei jedem Produkt hinterlegen (Sammelbearbeitung, eine Metafeld-App oder Qincis eigener CSV-Import), danach in Settings neu synchronisieren. - CSV - Settings → INCI aus CSV importieren, eine Datei mit den Spalten
title,inci. Qinci gleicht über den Produktnamen ab. Ein Metafeld gewinnt bei der nächsten Synchronisierung immer, ein CSV-Import ist also als Übergangslösung sicher.
Nicht jedes Produkt muss abgedeckt sein, damit es nützlich ist - Qinci bewertet, was lesbar ist, und die eingebaute Referenztabelle deckt schon vor jeder eigenen Zuordnung Hunderte gängiger Fremdmarken-Produkte ab.
Fehlerbehebung
- Das Widget erscheint nicht. Prüfe, ob die App-Einbettung im Theme-Editor an ist, das Widget in Settings aktiviert ist, und die Seite nicht auf deiner Ausschlussliste steht. Es zeigt sich erst, sobald etwas im Warenkorb liegt, auf einer Produkt- oder Warenkorbseite.
- Die Abdeckung bleibt niedrig. Die meisten Produkte haben noch keine hinterlegte Inhaltsstoffliste - siehe "Die Inhaltsstoffliste zuordnen" oben.
- Eine Empfehlung wirkt falsch. Nutze "Fehler melden" oben im Dashboard oder in Settings - wähle "falscher Inhaltsstoff" oder "falsches Verhalten" und beschreibe es. Es kommt bei uns mit deinen Shop-Daten an.
- Ich möchte meinen Tarif ändern oder kündigen. Öffne Billing in der Admin-Navigation. Abrechnung über Shopify; Änderungen und Kündigung passieren dort, wirken sofort, und es wird nichts außerhalb der Shopify-Abrechnung berechnet.
Tarife
Kostenlos, Starter (19 €/Monat) und Pro (49 €/Monat) - der vollständige Vergleich und die aktuellen Limits stehen im
Etwas nicht dabei? Schreib an qinci@qavlar.tech - das erreicht die Person, die Qinci baut, keine Warteschlange.
