Targeting-Regeln

Lesezeit: 5 Minuten. Für wen: Händler, die eingrenzen, wer den Angebots-Button sieht und wer ein Angebot senden darf.

QuotWay trennt das Targeting auf Produktseite („welche Produkte zeigen den Angebots-Button?“) von dem auf Kundenseite („welche Käufer dürfen senden?“). Beide laufen als Kette von Regeln – jede Regel erlaubt oder verweigert; die erste passende Regel gewinnt.

Die beiden Geltungsbereiche

Bereich	Fragt	Standard ohne Regel
PRODUKTE	„Soll der Angebots-Button bei diesem Produkt erscheinen?“	Verweigern – Button verborgen.
KUNDEN	„Soll dieser Käufer senden dürfen?“	Verweigern – Senden abgelehnt.

Der Standard „alles verweigern“ ist Absicht. Haben Sie keine Regeln, sieht kein Käufer den Button. Das Onboarding legt für Sie eine Basisregel ALLE_PRODUKTE + ALLE_KUNDEN an, damit der Button von Anfang an für alle sichtbar ist.

Regeltypen

Produktseite

ALLE_PRODUKTE – jedes Produkt zeigt den Button.
KATEGORIE – nur bei Produkten einer bestimmten Kategorie zeigen.
PRODUKT_TAG – nur bei Produkten mit einem bestimmten Tag zeigen (z. B. wholesale). Unterstützt ANY (irgendein Tag passt) oder ALL (alle Tags passen).
PRODUKTTYP – nach Shopify-Produkttyp abgleichen.
ANBIETER – nach Shopify-Produktanbieter abgleichen.

Kundenseite

ALLE_KUNDEN – jeder Käufer darf senden.
KUNDEN_TAG – nach Shopify-Kunden-Tag abgleichen (z. B. vip). ANY oder ALL.
KUNDENSEGMENT – nach Shopify-Kundensegment abgleichen. Die Zugehörigkeit wird serverseitig gegen Shopify aufgelöst, ein Segment bleibt also maßgeblich, statt dem zu vertrauen, was der Shop sendet.
B2B_UNTERNEHMEN – in B2B-fähigen Shops (Enterprise-Tarif). Nach Unternehmens-GID abgleichen.
UNTERNEHMENSSTANDORT – in B2B-fähigen Shops (Enterprise-Tarif). Nach Unternehmensstandort abgleichen.
GAST – Gästen (nicht angemeldeten Käufern) ausdrücklich erlauben.

Regelreihenfolge und Priorität

Jede Regel hat eine priority (niedriger = höhere Priorität). Wenn QuotWay auswertet, ob der Button erscheint:

Regeln aufsteigend nach priority sortieren.
Die Liste durchgehen. Die erste Regel, deren Bedingungen zu Produkt und Käufer passen, gewinnt.
Passt keine Regel → verweigern.

Regeln können aktiviert (aktiv) oder deaktiviert (für später aufbewahrt, aber ignoriert) sein. Der Targeting-Editor unter /app/quote-button/targeting hat Schalter für beide Zustände.

Regeln bearbeiten

Der eigene Editor unter /app/quote-button/targeting zeigt alle Regeln beider Bereiche. Jede Zeile hat:

Name + Bereichs-Abzeichen (PRODUKTE / KUNDEN).
Regeltyp.
Bedingungen (z. B. tags: ["wholesale"], operator: ANY).
Aktiviert-Schalter.
Priorität.

Klicken Sie eine Regel an, um den Bedingungseditor zu öffnen.

Beispiel – Produkte mit Großhandels-Tag, Kunden mit B2B-Tag

Sagen wir, Sie verkaufen an Großhändler über besonders getaggte Produkte und haben bei Ihren vertrauenswürdigen Käuferkonten den Tag wholesale-customer. Der Angebots-Button soll NUR erscheinen, wenn beides passt.

Regeln:

#	Bereich	Typ	Bedingungen	Priorität	Aktiviert
1	PRODUKTE	PRODUKT_TAG	`tags: ["wholesale"], operator: ANY`	100	✓
2	KUNDEN	KUNDEN_TAG	`tags: ["wholesale-customer"], operator: ANY`	100	✓

Das war's. Zwei Regeln. Der Button erscheint, wenn das Produkt den Tag wholesale UND der Käufer den Tag wholesale-customer hat.

Beispiel – Gäste + getaggte Produkte

Wenn auch nicht angemeldete Käufer Angebote senden können sollen (bei ersten B2B-Anfragen üblich):

#	Bereich	Typ	Bedingungen	Priorität	Aktiviert
1	PRODUKTE	PRODUKT_TAG	`tags: ["wholesale"], operator: ANY`	100	✓
2	KUNDEN	GAST	(keine)	100	✓
3	KUNDEN	ALLE_KUNDEN	(keine)	200	✓

Regel 2 erlaubt Gäste ausdrücklich; Regel 3 fängt angemeldete Kundinnen und Kunden ab.

Die Durchsetzung ist serverseitig, nicht nur Anzeige

Die Sichtbarkeit des Buttons ist die Anzeigeebene. Sie ist nicht das, was verhindert, dass ein nicht berechtigtes Produkt angeboten wird.

Wird ein Angebot gesendet, führt QuotWay dieselbe Regelauswertung serverseitig gegen Ihre gespeicherten Regeln erneut aus und lehnt die Sendung ab, wenn eine Position nicht berechtigt ist. Zwei Details machen diese Prüfung vertrauenswürdig:

Vom Client gelieferte Produktattribute werden ersetzt, nicht geglaubt. Die Anfrage aus dem Shop trägt Produkttyp, Anbieter, Tags und Kategorien je Position – Werte, die eine manipulierte Anfrage erfinden könnte. Vor der Auswertung verwirft der Server sie und setzt die maßgeblichen Werte aus Ihrer Admin-API ein. Dasselbe gilt für Kunden-Tags, die ebenfalls neu geholt statt aus der Anfrage übernommen werden.
Jeder Fehlschlag bedeutet standardmäßig Verweigern. Lässt sich ein Produkt nicht auflösen – oder scheitert der Admin-Abruf ganz –, gilt die Position als nicht berechtigt, statt durchgewunken zu werden.

Warenkorb-Sendungen werden gefiltert, noch bevor sich das Panel öffnet: Nur angebotsfähige Positionen wandern in das Angebot, nicht berechtigte Artikel werden also verworfen statt stillschweigend angeboten.

Zwei Dinge zum Geltungsbereich, die man wissen sollte. Die Berechtigung wird beim Senden des Käufers ausgewertet, ein später ausgeschlossenes Produkt schließt also nicht rückwirkend bereits bestehende Angebote. Und ein Angebot, das Sie im Admin anlegen, wird nicht auf Berechtigung geprüft – Sie wählen die Produkte ausdrücklich, die Regeln, die Ihren Shop absichern, sichern also nicht Sie ab.

Das zählt, wenn Ihre Ausschlüsse einen betrieblichen Grund haben – etwa Reparaturen oder Umtausch, die einem anderen Prozess folgen –, denn es bedeutet, dass ein ausgeschlossenes Produkt Sie nicht über den Shop erreichen kann, wie die Anfrage auch gestellt wurde.

Leistung und Zwischenspeicherung

Targeting-Regeln werden bei jedem Seitenaufruf im Shop gelesen. Um die Latenz niedrig zu halten, speichert QuotWay die Regelliste je Shop 5 Minuten zwischen.

Wenn Sie eine Regel anlegen, ändern oder löschen, wird der Zwischenspeicher für diesen Shop sofort ungültig.
Der Zwischenspeicher liegt im Arbeitsspeicher je Vercel-Funktionsinstanz, der Traffic skaliert also linear ohne Datenbankzugriffe je Shop.

Im Normalbetrieb sollten Sie KEINE veralteten Regeln sehen. Falls doch, steht das Vorgehen zur Fehlersuche unter Häufige Probleme beheben.

Häufige Stolpersteine

Der Button erscheint nicht, obwohl mein Produkt den Tag hat. Der Tag-Abgleich beachtet Groß- und Kleinschreibung („wholesale“ ≠ „Wholesale“). Der Shopify-Katalog hat bei älteren Tags manchmal uneinheitliche Schreibweisen – einigen Sie sich auf eine und bleiben Sie dabei.
Eine PRODUKT_TAG-Regel mit operator: ALL und 2 Tags greift bei manchen Produkten, bei anderen nicht. Prüfen Sie, dass jedes Produkt tatsächlich BEIDE Tags hat. Der Operator muss exakt alle treffen.
Die B2B-Unternehmensregel greift nicht. Nutzen Sie die Unternehmens-GID (gid://shopify/Company/12345), nicht den Unternehmensnamen. Die Autovervollständigung im Editor verhindert das, aber wenn Sie einen Namen von anderswo einfügen, greift die Regel stillschweigend nicht.
Regeln aus einer gelöschten Tarifstufe erscheinen weiterhin. Das Deaktivieren einer Regel bewahrt sie auf. Nutzen Sie die Aktion Löschen, um sie zu entfernen.