Dokumentation · Admin-Referenz

Suchabos-Referenz

Dieses Dokument ist eine Referenz für den Bildschirm Suchabos des ADP Car Market Hub-Plugins (Car Market Hub → Search Alerts). Es erklärt das Modell der Suchprofile, wie die Tabelle funktioniert und wie Sie Abonnements erstellen, bearbeiten, pausieren und löschen.

Wann Sie dieses Dokument verwenden sollten

Verwenden Sie diese Referenz, wenn Sie automatisierte E-Mail-Benachrichtigungen verwalten möchten, die Abonnenten informieren, sobald neue Fahrzeuge ihren gespeicherten Suchkriterien entsprechen, oder wenn Sie eine Liste von Suchabos importieren/exportieren möchten.

Übersicht

Ein Suchabo (auch als Suchprofil bezeichnet) ist eine gespeicherte Kombination aus:

  • Einer Empfänger-E-Mail-Adresse.
  • Einem Satz von Filterkriterien (Marke, Modell, Karosserieform, Kraftstoffart, Zustand, Farbe, Preisspanne, maximale Kilometerleistung).
  • Einer Benachrichtigungshäufigkeit (Sofort, Täglich, Wöchentlich).
  • Einem Status (Aktiv, Ausstehende Bestätigung, Pausiert, Abgemeldet).

Wenn neue Fahrzeuge den Kriterien eines aktiven Suchabos entsprechen, sendet das Plugin eine E-Mail an den Abonnenten gemäss der gewählten Häufigkeit. Der Bildschirm listet jedes konfigurierte Suchabo mit Massenaktionen, Such-/Statusfiltern, CSV-Export und einem modalen Erstellungs-/Bearbeitungsformular auf.

Anforderungen oder Voraussetzungen

  • Berechtigung zur Verwaltung des Plugins.
  • Funktionierender E-Mail-Versand über WordPress. Das Plugin verwendet den Standard-WordPress-E-Mail-Versand; konfigurieren Sie SMTP separat, falls Ihre Website keine E-Mails senden kann.
  • Importierte Fahrzeuge, mit denen die Suchabos abgeglichen werden können.

Schritt-für-Schritt-Anleitung

Ein Suchprofil erstellen

  1. Öffnen Sie Car Market Hub → Search Alerts.
  2. Klicken Sie im Header auf Create Alert Profile.
  3. Füllen Sie im Modal Folgendes aus: - Alert Name (optional, wird als benutzerfreundlicher Name in der Tabelle verwendet). - Recipient Email (erforderlich). - Notification Frequency (Sofort / Täglich / Wöchentlich). - Status — Sie können den Status des Suchabos hier direkt festlegen (standardmässig auf Active).
  4. Fügen Sie beliebige Werte für die Filter Kriterien hinzu. Lassen Sie ein Feld leer, um alle Werte für dieses Kriterium zuzulassen.
  5. Klicken Sie auf Create Alert Profile. Das neue Suchabo erscheint in der Tabelle mit dem von Ihnen ausgewählten Status (standardmässig Aktiv).

Ein bestehendes Suchabo bearbeiten

  1. Klicken Sie in der Tabelle auf die Aktion Edit in der entsprechenden Zeile.
  2. Das Modal öffnet sich vorausgefüllt mit den aktuellen Werten des Suchabos; ändern Sie die gewünschten Einstellungen — einschliesslich des Status — und klicken Sie auf Save Changes.

Pausieren, aktivieren oder löschen

  1. Um ein einzelnes Suchabo zu pausieren oder wieder zu aktivieren, klicken Sie auf das Symbol Pause / Activate in der Zeile.
  2. Um ein einzelnes Suchabo zu löschen, klicken Sie auf das Symbol Delete (Papierkorb) und bestätigen Sie den Vorgang.
  3. Um mehrere Suchabos gleichzeitig zu bearbeiten, markieren Sie die Zeilen, wählen Sie im Dropdown-Menü für Massenaktionen Activate selected, Pause selected oder Delete selected und klicken Sie auf Apply.

Suchen, filtern und exportieren

  1. Verwenden Sie das Suchfeld, um nach Name des Suchabos, E-Mail-Adresse oder Kriterien zu filtern.
  2. Verwenden Sie den Statusfilter, um die Ansicht auf Active, Pending Confirmation, Paused oder Unsubscribed einzuschränken.
  3. Klicken Sie auf Export CSV, um alle Suchabos herunterzuladen, die der aktuellen Suche und dem Filter entsprechen.
  4. Klicken Sie auf Clear, um die Suche und den Statusfilter zurückzusetzen.
  5. Verwenden Sie die Anzahl pro Seite, um zu ändern, wie viele Suchabos gleichzeitig angezeigt werden. Der gewählte Wert wird als benutzerspezifische Einstellung gespeichert, sodass er für Ihr Konto bei zukünftigen Besuchen erhalten bleibt.

Zeilen ohne expliziten Alert Name zeigen einen abgeleiteten Namen mit dem Tag auto-generated name an, sodass Sie auf einen Blick sehen, welchen Suchabos nie ein benutzerdefinierter Name zugewiesen wurde. Zeilen ohne Filterkriterien zeigen das Label All vehicles an, was bedeutet, dass das Suchabo auf den gesamten Fahrzeugbestand angewendet wird.

Konfigurationsreferenz

Suchprofil

FeldHinweise
Alert NameOptionaler, benutzerfreundlicher Name. Wird in der Tabelle und in E-Mails angezeigt. Wenn das Feld leer gelassen wird, zeigt die Tabelle einen abgeleiteten Namen mit dem Tag auto-generated name an.
Recipient EmailErforderlich. Wird als E-Mail-Adresse validiert.
Notification FrequencyImmediate, Daily oder Weekly. Standardmässig Daily.
StatusActive, Pending Confirmation, Paused, Unsubscribed. Direkt im Erstellungs-/Bearbeitungs-Modal editierbar und wird auch durch Aktionen des Abonnenten oder Admins geändert (z. B. Abmeldung, Pausieren). Standardmässig Active für neue Suchabos.

Filterkriterien-Felder (Modal)

FeldHinweise
MakeFreitext (z. B. BMW). Leer = alle Marken zulassen.
ModelFreitext (z. B. 3 Series). Leer = alle Modelle zulassen.
Body TypeFreitext (z. B. Sedan). Leer = alle Karosserieformen zulassen.
Fuel TypeFreitext (z. B. Diesel). Leer = alle Kraftstoffarten zulassen.
ConditionFreitext (z. B. used). Leer = alle Zustände zulassen.
ColorFreitext (z. B. Black). Leer = alle Farben zulassen.
Price From (€)Optionaler Mindestpreis, in ganzen Einheiten (Schritt 500).
Price To (€)Optionaler Maximalpreis, in ganzen Einheiten (Schritt 500). Leer = kein Maximum.
Max Mileage (km)Optionale maximale Kilometerleistung, in ganzen Einheiten (Schritt 5000). Leer = kein Maximum.

Statuswerte

WertBedeutung
ActiveDas Suchabo ist aktiviert und sendet E-Mails gemäss seiner Häufigkeit.
Pending ConfirmationDer Abonnent wurde um Bestätigung gebeten und hat dies noch nicht getan.
PausedDas Suchabo wurde vorübergehend von einem Admin oder vom Abonnenten deaktiviert.
UnsubscribedDer Abonnent hat sich abgemeldet; es werden keine weiteren E-Mails gesendet.

Tabellen-Toolbar

ElementVerhalten
SearchDurchsucht Name, E-Mail-Adresse und Kriterien.
Status filterLeer = alle Statuswerte.
Bulk actionsActivate selected, Pause selected, Delete selected.
Per pageErlaubte Werte: 5, 10, 25, 50, 100. Standardwert ist 25. Wird als benutzerspezifische Einstellung gespeichert.
Export CSVExportiert Suchabos, die der aktuellen Suche und dem Filter entsprechen.

Betriebliche Hinweise

  • Die Benachrichtigungshäufigkeit beeinflusst nur, wann E-Mails gesendet werden; sie ändert nichts daran, welche Fahrzeuge den Kriterien entsprechen.
  • Suchabos im Status Pending Confirmation oder Unsubscribed senden niemals E-Mails, bis sie auf Active gesetzt werden.
  • Abonnenten können sich in der Regel über einen Link in der Benachrichtigungs-E-Mail abmelden; dadurch wird das Suchabo in den Status Unsubscribed versetzt. Überprüfen Sie dieses Verhalten in der aktuellen Plugin-Version, bevor Sie live gehen.
  • Die Suchabo-Matching-Engine berücksichtigt nur veröffentlichte Fahrzeuge im Bestand. Ausgeblendete, unveröffentlichte oder gelöschte Fahrzeuge werden nicht als Treffer gewertet.
  • Das Löschen ist dauerhaft und kann nicht rückgängig gemacht werden — der Bestätigungsdialog weist explizit darauf hin. Verwenden Sie Pause, wenn Sie ein Suchabo nur vorübergehend aussetzen möchten.
  • Alle Admin-Aktionen auf Suchabos werden über das Standard-Logging-System des Plugins protokolliert; Details finden Sie in der Logs-Referenz.

Fehlerbehebung

  • Abonnenten erhalten keine E-Mails. Vergewissern Sie sich, dass der Status des Suchabos auf Active steht, dass WordPress E-Mails senden kann und dass die Empfängeradresse korrekt ist. Stellen Sie bei Sofort-Benachrichtigungen zudem sicher, dass kürzlich tatsächlich neue Fahrzeuge importiert wurden.
  • Ein Suchabo liefert nie Treffer. Filterkriterien werden mit UND verknüpft. Versuchen Sie, Felder nacheinander zu entfernen, um das Kriterium zu finden, das alle Ergebnisse ausschliesst.
  • Ein Abonnent beschwert sich über zu viele E-Mails. Senken Sie die Häufigkeit von Sofort auf Täglich oder Wöchentlich, oder pausieren Sie das Suchabo, bis die Kriterien präzisiert wurden.
  • Massenaktion bewirkt nichts. Wählen Sie mindestens eine Zeile aus, bevor Sie auf Apply klicken; andernfalls warnt Sie der Bildschirm.
  • Beim CSV-Export fehlen Suchabos. Der Export berücksichtigt die aktuelle Suche und den Statusfilter — setzen Sie diese zurück, um alle Daten zu exportieren.
  • Löschbestätigung wird übersprungen oder schlägt stillschweigend fehl. Stellen Sie sicher, dass JavaScript in Ihrem Browser aktiviert ist. Die destruktive Aktion erfordert die Bestätigung des Modals/Dialogs.

Verwandte Dokumente