expert Logo

Filialfinder

Zurück zur Suche

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_KEY

Die 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_key

Eindeutiger Schlüssel – wird als URL-Parameter verwendet.

z.B. wm_bonus, samsung_s25

name

Interner Name zur Übersicht (nicht sichtbar für Nutzer).

target

Ziel-URL nach der Filialauswahl. branch_id=[identifier] wird automatisch angehängt.

btnText

Beschriftung des Aktions-Buttons.

z.B. "Jetzt vor Ort kaufen"

pName

Produktname, der oberhalb der Suche angezeigt wird.

pImg

Produktbild-URL (JPG, PNG, WebP, SVG), wird in voller Breite angezeigt.

whitelist

Kommagetrennte Filial-IDs (Identifier). Nur diese Filialen werden angezeigt.

tenant

Mandant/Stream-Filter. Leer = 'default'.

tracking_params

Zusätzliche Tracking-Parameter, die an die Ziel-URL angehängt werden.

utm_source=qr&utm_campaign=wm2026

is_active

Aktion 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.de
target

Zielseite 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

pName

Produktname oberhalb der Filialliste.

https://filialen.expert-lokal.de/?pName=Samsung+Galaxy+S25

pImg

Produktbild in voller Breite (direkte Bild-URL).

https://filialen.expert-lokal.de/?pName=Samsung+Galaxy+S25&pImg=https://www.expert.de/bilder/s25.webp

whitelist

Kommagetrennte Filial-IDs – schränkt die Anzeige auf bestimmte Filialen ein.

https://filialen.expert-lokal.de/?whitelist=12345,67890,11223

tenant

Mandant/Stream-Filter. Ohne Angabe wird 'default' verwendet.

https://filialen.expert-lokal.de/?tenant=TAG24

kd

Kundennummer, wird als Parameter kd= an die Ziel-URL angehängt.

https://filialen.expert-lokal.de/?target=https://...&kd=12345

tracking

Zusä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_bonus

3. 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.