Technische Dokumentation
Interne Übersicht der Funktionen und der technischen Logik des expert Filialfinders. Stand: Juli 2026.
1. Kernfunktionen
Dynamische Filialsuche mit automatischer Standorterkennung
Beim Aufruf der App wird automatisch versucht, den Standort des Nutzers zu ermitteln. Erteilt der Nutzer im Browser die Freigabe, erfolgt die Standortbestimmung per GPS. Andernfalls wird auf eine grobe Schätzung anhand der IP-Adresse zurückgegriffen. Anhand des ermittelten Standorts werden alle Filialen nach Entfernung sortiert und die nächstgelegenen Standorte werden zuerst angezeigt.
Alternativ kann der Nutzer manuell eine Stadt oder Postleitzahl eingeben. Nach Bestätigung der Suche wird der Kartenausschnitt automatisch auf die umliegenden Filialen angepasst und die Liste neu sortiert.
Interaktive Karte mit synchronisierter Filialliste
Die Karte und die darunter befindliche Filialliste sind vollständig synchronisiert. Scrollt der Nutzer im Kartenausschnitt oder zoomt herein, passt sich die Filialliste automatisch an und zeigt nur die Standorte an, die im aktuell sichtbaren Kartenbereich liegen. Ein Klick auf einen Marker in der Karte hebt die entsprechende Karte in der Liste hervor und öffnet bei erneutem Klick die Detailansicht. Umgekehrt zentriert ein Klick in der Liste den entsprechenden Marker in der Karte.
Sobald der Nutzer die Karte manuell verschiebt (Panning), wird der Kartenmittelpunkt als neuer Referenzpunkt für die Distanzsortierung verwendet. Die Filialliste sortiert sich dadurch dynamisch nach der Entfernung zum aktuellen Kartenmittelpunkt – unabhängig vom GPS-Standort des Nutzers. Eine manuelle PLZ/Stadt-Suche hat dabei immer Vorrang.
Schrittweise Anzeige weiterer Filialen
Um die Übersicht zu wahren, werden initial nur 10 Filialen in der Liste angezeigt. Über den Button "Weitere Filialen zeigen" können alle weiteren Standorte eingeblendet werden. Die Anzahl der noch nicht angezeigten Filialen wird dabei direkt im Button kommuniziert.
2. Kampagnen-Konfiguration
Der Filialfinder unterstützt zwei Wege, um Kampagnen zu steuern: die Actions-Datenbank (empfohlen) und direkte URL-Parameter als Fallback. Beide Methoden können kombiniert werden – die Datenbank-Konfiguration hat dabei immer Vorrang.
Methode 1: Actions-Datenbank (empfohlen)
Kampagnen werden zentral in der Actions-Tabelle der Datenbank angelegt. Jede Aktion erhält einen eindeutigen action_key. Der Filialfinder wird dann mit einem einzigen Parameter aufgerufen:
https://filialen.expert-lokal.de/?action=DEIN_ACTION_KEYDie App lädt daraufhin automatisch alle Kampagnen-Einstellungen aus der Datenbank: Ziel-URL, Button-Text, Produktbild, Whitelist, Tracking-Parameter und mehr. Änderungen an der Kampagne sind jederzeit in der Datenbank möglich – ohne den Link anpassen zu müssen.
Felder der Actions-Tabelle:
action_keyEindeutiger Schlüssel – wird als URL-Parameter verwendet.
z.B. wm_bonus, samsung_s25
nameInterner Name zur Übersicht (nicht sichtbar für Nutzer).
targetZiel-URL nach der Filialauswahl. branch_id=[identifier] wird automatisch angehängt.
btnTextBeschriftung des Aktions-Buttons.
z.B. "Jetzt vor Ort kaufen"
pNameProduktname, der oberhalb der Suche angezeigt wird.
pImgProduktbild-URL (JPG, PNG, WebP, SVG), wird in voller Breite angezeigt.
whitelistKommagetrennte Filial-IDs (Identifier). Nur diese Filialen werden angezeigt.
tenantMandant/Stream-Filter. Leer = 'default'.
tracking_paramsZusätzliche Tracking-Parameter, die an die Ziel-URL angehängt werden.
utm_source=qr&utm_campaign=wm2026
is_activeAktion aktiv oder inaktiv. Inaktive Aktionen werden ignoriert und es gelten die URL-Parameter als Fallback.
Methode 2: Direkte URL-Parameter (Fallback)
Ohne ?action= können alle Einstellungen direkt per URL-Parameter übergeben werden. Dies ist der bisherige Weg und bleibt vollständig kompatibel.
Basis-URL:
https://filialen.expert-lokal.detargetZielseite nach der Filialauswahl. branch_id=[identifier] wird automatisch angehängt.
https://filialen.expert-lokal.de/?target=https://www.expert.de/shop/produkt-xyz
btnTextÜberschreibt den Standardtext des Aktions-Buttons.
https://filialen.expert-lokal.de/?target=https://...&btnText=Jetzt+vor+Ort+kaufen
pNameProduktname oberhalb der Filialliste.
https://filialen.expert-lokal.de/?pName=Samsung+Galaxy+S25
pImgProduktbild in voller Breite (direkte Bild-URL).
https://filialen.expert-lokal.de/?pName=Samsung+Galaxy+S25&pImg=https://www.expert.de/bilder/s25.webp
whitelistKommagetrennte Filial-IDs – schränkt die Anzeige auf bestimmte Filialen ein.
https://filialen.expert-lokal.de/?whitelist=12345,67890,11223
tenantMandant/Stream-Filter. Ohne Angabe wird 'default' verwendet.
https://filialen.expert-lokal.de/?tenant=TAG24
kdKundennummer, wird als Parameter kd= an die Ziel-URL angehängt.
https://filialen.expert-lokal.de/?target=https://...&kd=12345
trackingZusätzliche Tracking-Parameter, die an die Ziel-URL angehängt werden.
https://filialen.expert-lokal.de/?target=https://...&tracking=utm_source%3Dqr%26utm_campaign%3Dwm2026
Vollständiges Beispiel für eine Kampagne via Actions
Aktion in der Datenbank anlegen mit action_key = "wm_bonus", dann verlinken mit:
https://filialen.expert-lokal.de/?action=wm_bonus3. Daten-Infrastruktur
Automatisierte Filialdaten über Uberall
Die Filialdaten (Name, Adresse, Koordinaten, Öffnungszeiten, Telefonnummer, Website) werden über eine Webhook-Schnittstelle automatisch mit dem Datenmanagementsystem Uberall.com synchronisiert. Sobald eine Filiale in Uberall aktualisiert wird, werden die Änderungen automatisch in den Filialfinder übertragen. Eine manuelle Pflege der Daten ist nicht erforderlich.
Die Synchronisation erfolgt ausschliesslich für bereits bestehende Filialen. Neue Standorte werden nicht automatisch angelegt und müssen bei Bedarf manuell ergänzt werden.
Erreichbarkeit
Die App ist unter der eigenen Domain filialen.expert-lokal.de erreichbar und kann als Progressive Web App (PWA) auf mobilen Endgeräten zum Homescreen hinzugefügt werden.
4. Rechtliches
Die App verfügt über separate Unterseiten für die rechtlich vorgeschriebenen Inhalte. Diese sind im Footer der Anwendung verlinkt und jederzeit erreichbar:
- Impressum — Pflichtangaben gem. §5 TMG, Angaben zur verantwortlichen Stelle und den vertretungsberechtigten Personen.
- Datenschutzerklärung — Informationen zur Verarbeitung personenbezogener Daten, insbesondere zur Nutzung von Standortdaten und Server-Logfiles.
