Documentatie · Gebruikershandleiding
Dagelijkse werkstromen
Dit document beschrijft de operationele werkstromen die beheerders en dealerpersoneel regelmatig uitvoeren bij het beheren van de voertuigvoorraad via de ADP Car Market Hub-plugin. Het behandelt het controleren van imports, het beoordelen van leads, het valideren van de frontend en het monitoren van de systeemstatus.
Wanneer u dit document moet gebruiken
Lees dit document als u:
- Verantwoordelijk bent voor de dagelijkse of wekelijkse werking van een website met voertuigadvertenties die door deze plugin wordt aangedreven.
- Een praktische checklist nodig hebt om te controleren of imports succesvol zijn verlopen, leads worden ontvangen en de frontend de voorraad correct weergeeft.
- Wilt begrijpen waar u op moet letten en waar u moet zoeken als er iets mis lijkt te zijn.
Zie de Beheerdershandleiding voor volledige configuratie- en installatierichtlijnen.
Overzicht
Onder normale omstandigheden werkt de ADP Car Market Hub-plugin grotendeels automatisch. De geplande importeur haalt met geconfigureerde intervallen bijgewerkte voertuiggegevens op uit de AutoScout24 API, downloadt afbeeldingen in een achtergrondwachtrij en houdt de WordPress-voorraad gesynchroniseerd met de live advertentie.
Operationeel personeel moet echter regelmatig controleren of:
- Importruns succesvol worden voltooid.
- Nieuwe en bijgewerkte voertuigen zichtbaar zijn op de frontend.
- Klantleads worden ontvangen en verwerkt.
- Het plugin-logboek geen onopgeloste fouten bevat.
- De afbeeldingenwachtrij geen grote achterstand oploopt.
Werkstroom 1: Importstatus controleren
Voer deze controle dagelijks uit of na elke geplande importrun.
Stappen
- Log in op het WordPress-beheerdersdashboard.
- Navigeer naar ADP Car Market Hub → Dashboard.
- Bekijk de KPI-rij: - Controleer Totaal aantal voertuigen om te bevestigen of het aantal in de voorraad naar verwachting is. - Controleer Nieuw (laatste 7 dagen) om te zien hoeveel voertuigen onlangs zijn toegevoegd.
- Bekijk de grafiek Voorraadtrend om te bevestigen dat importruns de afgelopen week resultaten hebben opgeleverd.
- Bekijk de sectie Aandacht vereist voor eventuele actiepunten, zoals voertuigen die afbeeldingen of korte beschrijvingen missen.
- Navigeer naar ADP Car Market Hub → Import & limieten.
- Controleer de laatste importtijd en laatste importstatus die op het tabblad worden weergegeven. Bevestig dat de meest recente run zonder fouten is voltooid.
- Als de laatste runtime onverwacht oud lijkt (bijvoorbeeld meer dan 24 uur geleden bij een uurschema), controleer dan of de cron actief is. Zie de werkstroom De cron-status controleren hieronder.
Waar u op moet letten
- De tijdstempel van de laatste import moet overeenkomen met uw geconfigureerde schema (bijvoorbeeld ongeveer elk uur bij een uurschema).
- Het aantal geïmporteerde voertuigen moet overeenkomen met uw AutoScout24-voorraad.
- Geen aanhoudende foutmeldingen op het tabblad Import & limieten.
Werkstroom 2: Het plugin-logboek controleren
Voer deze controle dagelijks uit, of onmiddellijk wanneer u vermoedt dat een import is mislukt.
Stappen
- Navigeer naar ADP Car Market Hub → Logboeken.
- Bekijk het paneel Recente fouten bovenaan de pagina. Dit toont de nieuwste logboekregels met foutniveau uit de laatste 2.000 regels van het logbestand.
- Bekijk het paneel Recente waarschuwingen voor niet-kritieke problemen die mogelijk toch aandacht vereisen.
- Als er fouten of waarschuwingen aanwezig zijn, noteer dan de tijdstempels en de inhoud ervan.
- Scrol omlaag naar de Logboekviewer om het onbewerkte logbestand te bekijken en te zoeken naar context rond specifieke vermeldingen.
- Pas het veld Regels aan als u meer geschiedenis wilt zien en klik vervolgens op Opnieuw laden.
Veelvoorkomende logboekpatronen om op te letten
| Logboekpatroon | Betekenis |
|---|---|
[ERROR] met "connection" of "token" | API-verbindings- of authenticatiefout |
[ERROR] met "image" | Een download van een afbeelding is mislukt |
[WARNING] met "lock" | Een import is overgeslagen omdat er al een andere run actief was |
[INFO] met "skipped" | Voertuigen zijn overgeslagen omdat hun gegevens niet zijn gewijzigd (normaal gedrag) |
[INFO] met "deleted" | Voertuigen zijn verwijderd door Volledige synchronisatie (beoordelen indien onverwacht) |
Als u fouten ontdekt die niet kunnen worden opgelost door de instellingen te controleren, exporteer dan het diagnostische bestand via het tabblad Gereedschappen en neem contact op met de ondersteuning.
Werkstroom 3: Leads beoordelen en verwerken
Voer deze controle dagelijks uit of met een frequentie die past bij uw aantal aanvragen.
Stappen
- Navigeer naar ADP Car Market Hub → Leads.
- Bekijk de lijst met leads. Nieuwe leads hebben de status Nieuw.
- Voor elke nieuwe lead: - Controleer de naam van de klant, het e-mailadres, het telefoonnummer en het bericht. - Noteer over welk voertuig de aanvraag gaat. De advertentiereferentie linkt naar de AutoScout24-detailpagina wanneer deze beschikbaar is. - Neem contact op met de klant via uw normale verkoopproces. - Wijzig na contact met de klant de status van de lead naar Gecontacteerd. - Wijzig na afronding van de verkoopinteractie de status naar Gesloten of Spam, afhankelijk van de situatie.
- Als u leads wilt delen met een ander systeem (bijvoorbeeld een CRM), klikt u op Exporteer CSV om alle momenteel zichtbare leads als een CSV-bestand te downloaden. Pas eventueel eerst zoekfilters toe als u slechts een selectie wilt exporteren.
- Verwijder leads die bevestigde spam zijn of niet langer nodig zijn om de lijst overzichtelijk te houden.
Opmerkingen
- Wijzigingen in de leadstatus worden onmiddellijk opgeslagen wanneer u een nieuwe status selecteert.
- De CSV-export bevat alle leads die voldoen aan de huidige zoek-/filterstatus, of alle leads als er geen filter actief is.
- Leads worden opgeslagen als WordPress-berichten. Ze worden niet automatisch doorgestuurd naar externe systemen, tenzij u apart een webhook of integratie hebt geconfigureerd.
- Proefritaanvragen die via de proefritfunctie zijn ingediend, worden ook als leads geregistreerd als de proefritfunctie is ingeschakeld.
Werkstroom 4: Systeemstatus en cron-status controleren
Voer deze controle wekelijks uit, of onmiddellijk na een vermoedelijke fout in de planning.
Stappen
- Navigeer naar ADP Car Market Hub → Systeem & hulp.
- Bekijk de indicatoren van de omgevingscontrole: - PHP-versie – moet 8.1 of hoger zijn. - Geheugenlimiet – 256 MB of meer wordt aanbevolen. - Maximale uitvoeringstijd – 60 seconden of meer wordt aanbevolen. - Uploads-map – moet beschrijfbaar zijn voor de import van afbeeldingen. - cURL en OpenSSL – moeten aanwezig zijn voor API-aanroepen. - GD of Imagick – vereist als WebP-conversie is ingeschakeld.
- Bekijk de indicator Status cron-planning: - Bij gebruik van WP-Cron toont dit of er een gepland evenement is geregistreerd en wanneer de volgende run wordt verwacht. - Bij gebruik van een server-cron bevestigt u dat uw externe cron-job apart is geconfigureerd en actief is.
- Bekijk de Status afbeeldingenwachtrij: - Een kleine wachtrijgrootte (0–50) is normaal. - Een wachtrijgrootte van meer dan 1.000 activeert een waarschuwingsbadge. Dit kan erop wijzen dat de verwerker van de afbeeldingenwachtrij niet actief is of achterloopt. - Als de wachtrij groot is, gebruikt u de knop Afbeeldingenwachtrij nu uitvoeren om deze direct te verwerken.
- Bekijk het resultaat van de API-verbindingstest. Klik op de testknop indien beschikbaar om te bevestigen dat de API bereikbaar is met de huidige inloggegevens.
- Als een indicator een waarschuwing (geel) of fout (rood) aangeeft, raadpleeg dan de desbetreffende sectie in de Beheerdershandleiding of de Probleemoplossing hieronder.
Werkstroom 5: De frontend-voorraad valideren
Voer deze controle uit na elke belangrijke importrun, of wekelijks tijdens normaal gebruik.
Stappen
- Open de voertuigarchiefpagina van uw site in een browser (niet ingelogd als WordPress-beheerder, of via een privé-/incognitovenster om de openbare weergave te zien).
- Controleer of voertuigen in het archiefraster worden weergegeven met afbeeldingen, titels, prijzen en belangrijke specificaties.
- Pas een of meer filteropties toe (bijvoorbeeld filteren op merk of brandstoftype) en controleer of de resultaten correct worden bijgewerkt.
- Klik op een afzonderlijk voertuig om de detailpagina te openen.
- Controleer of de detailpagina het volgende toont: - Ten minste één afbeelding (of de afbeeldingengalerij als er meerdere afbeeldingen zijn geïmporteerd). - De tabel met voertuigspecificaties (merk, model, jaar, kilometerstand, prijs, motor, enz.). - De uitrustingslijst (indien van toepassing). - De voertuigbeschrijving. - Het contactformulier. - De financieringscalculator (indien ingeschakeld). - Het proefritformulier (indien ingeschakeld).
- Verstuur een testaanvraag via het contactformulier en controleer of: - De bedankbevestiging op de pagina wordt getoond. - Er binnen enkele seconden een lead verschijnt in ADP Car Market Hub → Leads. - De notificatiemail wordt ontvangen op het geconfigureerde ontvangersadres (als de e-mailverzending op uw server werkt).
- Als er voertuigen ontbreken in het archief of als de detailpagina onvolledig is, controleer dan het tabblad Logboeken op fouten en controleer de status van het voertuigbericht onder CMH Cars → All Cars.
Status van voertuigberichten controleren
- Navigeer naar CMH Cars → All Cars in de zijbalk van de WordPress-beheeromgeving.
- Zoek naar de specifieke voertuigtitel of gebruik de statuslinks (Alles / Gepubliceerd / Concept) boven de lijst.
- Bevestig dat het bericht is gepubliceerd (status: Gepubliceerd).
- Als het bericht de status Concept heeft, publiceer het dan handmatig of wijzig de Standaard berichtstatus in de instellingen naar
publishvoor toekomstige imports.
Werkstroom 6: Handmatig een import starten
Gebruik deze werkstroom wanneer u de voorraad onmiddellijk wilt vernieuwen buiten het automatische schema om, bijvoorbeeld nadat u nieuwe voertuigen hebt toegevoegd aan uw AutoScout24-account.
Stappen
- Navigeer naar ADP Car Market Hub → Import & limieten.
- Klik op de knop Nu starten om direct een importrun te starten.
- Gebruik de Batch-Wizard voor een volledige import met voortgangscontrole: - De voortgangsbalk toont de verwerkte voertuigen, de geschatte resterende tijd en de huidige actie. - U kunt de wizard op elk gewenst moment pauzeren, hervatten of afbreken.
- Nadat de import is voltooid, bekijkt u de statussamenvatting voor het aantal toegevoegde, bijgewerkte of overgeslagen voertuigen.
- Controleer de resultaten door het Dashboard en de archiefpagina op de frontend te bekijken.
Opmerkingen
- Handmatige triggers en de automatische cron-planner delen dezelfde importvergrendeling. Als er al een geplande run actief is wanneer u op Nu starten klikt, wordt de handmatige trigger overgeslagen.
- Importruns die via de Batch-Wizard worden gestart, verwerken standaard één voertuig tegelijk. Dit voorkomt time-outfouten op servers met beperkende limieten voor de uitvoeringstijd.
Werkstroom 7: Controleren op voertuigen met kwaliteitsproblemen
Voer deze controle regelmatig uit om de kwaliteit van de voorraad te waarborgen.
Stappen
- Navigeer naar ADP Car Market Hub → Dashboard.
- Bekijk de sectie Gereedheid voertuigen, die het volgende benadrukt: - Voertuigen zonder afbeeldingen. - Voertuigen met ongebruikelijk korte beschrijvingen.
- Klik voor elk getroffen voertuig door naar het individuele voertuigbericht om dit te onderzoeken.
- Als er afbeeldingen ontbreken: - Controleer of de afbeeldingenwachtrij een achterstand heeft (Systeem & hulp → Status afbeeldingenwachtrij). - Voer de afbeeldingenwachtrij indien nodig handmatig uit. - Controleer het tabblad Logboeken op fouten bij het downloaden van afbeeldingen.
- Als beschrijvingen kort zijn of ontbreken: - Bekijk de originele advertentie op AutoScout24. - Als de AI Assistant is ingeschakeld, gebruik deze dan om een beschrijving voor het voertuig te genereren. - Bewerk anders het voertuigbericht handmatig om de beschrijving toe te voegen of te verbeteren.
Operationele opmerkingen
- Dashboard-caching: Dashboardgegevens worden ongeveer 3 minuten gecached. Laad de pagina opnieuw om de meest recente gegevens te zien na een import.
- Wijzigingsdetectie: De importeur gebruikt hashes van inhoud en afbeeldingen om ongewijzigde voertuigen over te slaan. Een hoog aantal "overgeslagen" vermeldingen in het logboek is normaal en betekent dat de import efficiënt werkt.
- Meerdere Seller ID's: Als er meerdere Seller ID's zijn geconfigureerd, wordt de import voor elke verkoper om beurten uitgevoerd. Fouten bij de ene verkoper blokkeren de imports voor andere verkopers niet.
- Gedetailleerdheid van importlogboek: Uitgebreide logregistratie (indien ingeschakeld) schrijft zeer gedetailleerde vermeldingen per voertuig naar het logboek. Dit is handig voor foutopsporing, maar vergroot het logbestand. Schakel dit uit tijdens normaal gebruik.
Probleemoplossing
| Symptoom | Waarschijnlijke oorzaak | Controleer |
|---|---|---|
| Import is uitgevoerd maar het aantal voertuigen is niet gewijzigd | Alle voertuigen waren ongewijzigd (geen gegevensupdates op AutoScout24) | Normaal. Controleer de logs op "overgeslagen" vermeldingen. |
| Import is uitgevoerd maar sommige voertuigen ontbreken | Standaard berichtstatus is draft, of de voertuigen zijn verwijderd uit AutoScout24 | Controleer de berichtstatus in de Instellingen; controleer of Volledige Synchronisatie is ingeschakeld |
| Lead ontvangen maar geen e-mailmelding | WordPress e-mailbezorging is niet geconfigureerd of is defect | Test wp_mail(); neem contact op met de hostingprovider of installeer een SMTP-plugin |
| Afbeeldingenwachtrij groeit maar neemt niet af | De verwerker van de afbeeldingenwachtrij (WP-Cron hook) wordt niet geactiveerd | Controleer de cron-status; gebruik "Afbeeldingenwachtrij nu uitvoeren" als handmatige tijdelijke oplossing |
| Cron-schema wordt weergegeven als "niet gepland" | Het WP-Cron-event is gewist (deactiveren/reactiveren reset dit) | Deactiveer en activeer de plugin opnieuw; of schakel over naar server-cron |
| Frontend toont geen voertuigen na import | Standaard berichtstatus is draft | Publiceer voertuigen handmatig of wijzig de standaardstatus naar publish |
| Inzendingen van het contactformulier maken geen leads aan | Contactformulier bereikt de server niet (AJAX-fout, redirect-probleem) | Controleer de browserconsole op fouten; controleer of de actie-URL van het formulier correct is |