API-Parameter für Jobsuche: Best Practices (v3)

API konfigurieren

Einflussfaktoren für die Suchergebnisse

Die Einstellungen "Featured Jobs" (Hervorgehobene Jobs), "Enable Broadening" (Erweiterung aktivieren) und "Disable Keyword Match" (Keyword-Übereinstimmung deaktivieren) haben zusammen erheblichen Einfluss auf die Anzahl und die Relevanz der an die Jobsuchenden zurückgegebenen Jobs. Die optimale Konfiguration dieser drei Faktoren hängt von Ihren Geschäftsanforderungen ab. Wir empfehlen eine Testphase, während der Sie verschiedene Szenarien testen, um die optimale Konfiguration zu finden.

  1. Featured Jobs (Hervorgehobene Jobs): Mithilfe von "Hervorgehobene Jobs" können Sie einzelnen Jobs Aktionswerte zuweisen. So können Sie Jobs hervorheben, die für Ihre Geschäftsanforderungen wichtig sind. Best Practices und Einzelheiten zur Implementierung finden Sie in der Dokumentation zu hervorgehobenen Jobs.

  2. disableKeywordMatch: Mit diesem Parameter kann die API zusätzlich zu den vom ML-Algorithmus bestimmten relevanten Ergebnissen Schlüsselwortübereinstimmungen zurückgeben. Die Standardeinstellung ist false. Wenn Sie die Standardeinstellung beibehalten, gibt die CTS Job Search API Jobs zurück, die vom ML-Algorithmus nicht als relevant zurückgegeben wurden, deren Titel oder Jobbeschreibung jedoch eine Keyword-Übereinstimmung mit dem Abfragestring des Jobsuchenden aufweist. Wenn Sie diesen Parameter auf true setzen, wird die Schlüsselwortübereinstimmung deaktiviert, sodass weniger Jobs zurückgegeben werden (nur diejenigen, die von der ML-Funktion als relevant ermittelt wurden).

  3. enableBroadening: Mit diesem Parameter können Sie die Abfrage des Arbeitssuchenden erweitern, indem Sie die angegebenen Einschränkungen für Standort und Jobkategorien lockern. Es ist standardmäßig auf false eingestellt und aktiviert, wenn es auf true eingestellt ist. Er wird verwendet, um die Anzahl der zurückgegebenen Suchergebnisse zu erhöhen.

Ergebnisse verschiedener Suchkonfigurationen

Um nur die relevantesten Jobs zurückzugeben: Setzen Sie disableKeywordMatch auf true und enableBroadening auf false. Hierdurch wird die Relevanz der API-Ergebnisse verbessert, da nur die relevantesten Jobs zurückgegeben werden. Insgesamt werden in den Suchergebnissen jedoch weniger Jobs zurückgegeben.

So geben Sie eine höhere Anzahl von Jobs zurück, einschließlich relevanter und mit Schlüsselwörtern übereinstimmender Ergebnisse: Setzen Sie disableKeywordMatch auf false und enableBroadening auf false. Hierdurch werden die mit Keywords übereinstimmenden Ergebnisse im Anschluss an die relevanten Jobs aufgelistet. Die Ergebnisse der Suchanfragenerweiterung werden nicht zurückgegeben.

So geben Sie eine höhere Anzahl von Jobs zurück, einschließlich relevanter und abfrageerweiterter Jobs: Setzen Sie disableKeywordMatch auf true und enableBroadening auf true. Die Suchanfrage des Jobsuchenden wird um passende Jobkategorien und Orte in der Nähe erweitert, die im Anschluss an die relevanten Ergebnisse aufgelistet werden. Keyword-Übereinstimmungen werden nicht zurückgegeben.

So geben Sie die höchstmögliche Anzahl von Jobs zurück: Setzen Sie disableKeywordMatch auf false und enableBroadening auf true. Hierdurch gibt die Job Search API oben in den Suchergebnissen die relevantesten Jobs zurück, gefolgt von den mit Keywords übereinstimmenden Jobs und den mit der Suchanfragenerweiterung übereinstimmenden Jobs (nach Ort, Jobkategorie usw.). Dadurch wird die größtmögliche Zahl an Jobs zurückgegeben.

disableKeywordMatch enableBroadening Ergebnisse
- - Gibt eine höhere Anzahl von Jobs zurück, einschließlich relevanter und mit Keywords übereinstimmender Ergebnisse. Dabei wird davon ausgegangen, dass hervorgehobene Jobs auf "false" gesetzt sind.
+ + Gibt eine höhere Anzahl von Jobs zurück, einschließlich relevanter und mit der Suchanfragenerweiterung übereinstimmender Jobs. Dabei wird davon ausgegangen, dass hervorgehobene Jobs auf "false" gesetzt sind.
- + Gibt die größte Anzahl von Jobs zurück. Dabei wird davon ausgegangen, dass hervorgehobene Jobs auf "false" gesetzt sind.
+ - Gibt nur die relevantesten Jobs zurück. Dabei wird davon ausgegangen, dass hervorgehobene Jobs auf "false" gesetzt sind.

Request.page_size

Richten Sie die Ergebnisseite so ein, dass höchstens 20 gleichzeitig angezeigt werden, um eine optimale Leistung zu erzielen und Wartezeiten zu vermeiden.

customAttributes

customAttributes bietet Ihnen die Flexibilität, Ihren Jobs zusätzliche Werte entsprechend Ihren Geschäftsanforderungen zuzuweisen (z. B. GPA-Bewertungen) und diese Werte zum Filtern der Ergebnisse zu verwenden.

Feld "Location" (Standort)

Eine ausführliche Übersicht über das Standortfeld finden Sie auf der Seite Standortfelder. Wenn im Adressfeld anstelle von GPS-Koordinaten die Adresse zum Job angegeben wird, kann die API die Ortserkennung und die Suchrelevanz verbessern.

locationFilter

Verwenden Sie regionCode, wenn ein einzelnes Unternehmen mehrere offene Stellen in verschiedenen geografischen Regionen hat. Durch das Zuweisen einer regionCode zu jeder Auflistung wird sichergestellt, dass eine Suchabfrage Jobs nur am gewünschten Speicherort des Jobsuchenden zurückgibt und nicht die globalen Ergebnisse für dieses Unternehmen. Beispielsweise liefert eine Suche nach dem Standortschlüsselwort "Cambridge" ohne regionCode "Ergebnisse aus Cambridge, Großbritannien und Cambridge, MA, USA. Dies verringert die Suchrelevanz.

Region_code und Language_code

Stellen Sie request.filters.location_filters.region_code so ein, dass es dem geografischen Standort entspricht, den der Benutzer sucht (z. B. Großbritannien). Stellen Sie request.filters.language_code auf den entsprechenden Sprachcode für diese Region ein (in diesem Fall en_GB), damit die API eine lokalisierte Suchlogik verwenden kann (z. B. "LKW-Fahrer" in en_GB im Gegensatz zu "LKW-Fahrer" " in den Vereinigten Staaten).

radiusinMiles

Mit diesem Parameter wird um den vom Jobsuchenden angegebenen Ort ein Radius (in Meilen) festgelegt. Die API gibt dann Ergebnisse innerhalb dieses geografischen Bereichs zurück. Wie diese Entfernung angewendet wird, hängt von der Art der eingegebenen Ortsinformationen ab. Wenn der Arbeitssuchende eine Adresse eingibt, wird die Entfernung radiusInMiles von einem einzelnen Punkt aus festgelegt. Wenn der Jobsuchende eine Stadt eingibt, zieht die API einen Begrenzungsrahmen um die Stadtgrenzen und berechnet die Entfernung jeweils ab diesem Rahmen. Wenn der Benutzer nur einen Staat oder ein Land eingibt, wird radiusInMiles ignoriert.

Es sollte ein möglichst kleiner Radius eingegeben werden. Wird ein zu großer Radius festgelegt, liegen die Ergebnisse unter Umständen außerhalb des gewünschten Orts des Jobsuchenden, sodass die Relevanz geringer ist. Wenn Sie beispielsweise in New York nach Jobs suchen, bei denen radiusInMiles auf 100 Meilen festgelegt ist, werden sowohl im Bundesstaat New York als auch in New Jersey Ergebnisse erzielt. Wenn Sie einen möglichst kleinen Radius eingeben, steigt die Relevanz der Ergebnisse.

postingExpireTime

Dieser Parameter legt fest, wie lange das Jobangebot aktiv bleibt, bevor es aus den Suchergebnissen entfernt wird. Der Standardwert beträgt 30 Tage ab der Erstellungszeit des Jobs in der UTC-Zeitzone.

Job_employment_type

Dies ist kein Pflichtfeld. Die Verwendung von "Job_employment_type" erhöht die Relevanz der Jobsuchergebnisse.

API konfigurieren: Benutzerdefiniertes Ranking

Mit Ausgewählte Jobs können Sie die Suchergebnisse beeinflussen und Jobs anhand einer einzelnen Variablen hervorheben (promotionValue). Weitere Informationen finden Sie in der Dokumentation zu Empfohlene Jobs. Mit dem benutzerdefinierten Ranking können Sie die Ergebnisse basierend auf mehreren Variablen beeinflussen und haben dadurch unabhängig von der Relevanz mehr Kontrolle über die Rankings. Diese Funktion ist für Anwendungen nützlich, bei denen die Relevanz mit wirtschaftlichen Interessen abgewogen werden muss, wie z. B. bei einem mehrstufigen Cost-per-Click-Abonnentensystem (CPC). Der Einfluss darauf, wie Jobs über dem vorhandenen Relevanzfaktor eingestuft werden, basiert auf zwei Variablen: rankingExpression und importanceLevel.

  • rankingExpression: Diese Variable steuert, wie Jobs basierend auf ihren vorhandenen Relevanzwerten (wie vom API-Algorithmus bestimmt) eingestuft werden. 'rankingExpression' muss auf 'filterbar' gesetzt sein, damit die API den Parameter indiziert.

  • importanceLevel: Dieser Parameter legt die Wichtigkeitsstufe der Rangfolge eines Jobs fest, wenn diese bei Suchvorgängen zurückgegeben wird. Es gibt sechs verschiedene Ebenen: Nicht spezifiziert, NONE, LOW, MID, HIGH und EXTREME. Wenn Sie den Wert auf EXTREME setzen, werden alle anderen von der API generierten Relevanzfaktoren ignoriert. Verwenden Sie diesen Wert daher sparsam. Jobs, die auf EXTREME gesetzt sind, werden anstelle der relevantesten Jobs oben in der Suchanfrage des Jobsuchenden zurückgegeben.

  • Hervorgehobene Jobs im Vergleich zu benutzerdefiniertem Ranking: Hervorgehobene Jobs sind am nützlichsten, um eine einzelne Jobkategorie (z. B. Jobs in einem bestimmten Unternehmen) oberhalb des Relevanzrankings einsortieren zu lassen. Wenn Sie Jobs zusätzlich zum Relevanzranking nach mehrstufigen CPC-Variablen (Cost-per-Click) sortieren möchten, ist das benutzerdefinierte Ranking die bessere Wahl.

Mit der Suche in Abhängigkeit von der Anfahrtszeit können Jobsuchende basierend auf der Anfahrtszeit nach Jobs suchen. Fügen Sie zum Aktivieren ein zusätzliches CommuteFilter -Objekt in das Feld JobQuery.commuteFilter ein. Mit diesem Objekt kann der Arbeitssuchende commuteMethod, travelDuration und startCoordinates auswählen. Der Arbeitssuchende kann bei der Berechnung der Pendelzeit auch Optionen wie roadTraffic (TRAFFIC_FREE oder BUSY_HOUR) und departureTime auswählen. Weitere Informationen finden Sie auf den Seiten zur Implementierung der Suche in Abhängigkeit von der Anfahrtszeit und in den Anleitungen.

Datenverwaltung und Fehlerbehandlung

Datenintegrität

  1. Hochladen von Jobs: Datenprobleme können verhindern, dass Jobs in die API hochgeladen werden. Weitere Informationen finden Sie auf der Seite HTTP-Antwortcodes. Hier einige Beispiele:

    • Die Standorte der Jobs stimmen nicht, sodass die Anfrage nicht beantwortet werden kann.
    • Es sind keine Felder für Unternehmen oder Jobs vorhanden, sodass eine fehlerhafte Anfrage gemeldet wird.

    Es gibt drei Hauptoptionen für die Behebung von Fehlern beim Hochladen von Jobs:

    • Logs aus Ihrem Back-End überprüfen.
    • Logs aus dem CTS-Verwaltungstool überprüfen.
    • Stackdriver Monitoring in der Cloud Console für die Erfassung von Metadaten, Messwerten und Ereignissen einrichten.
  2. Jobs indexieren: Die Job Search API braucht eine bestimmte Zeit, um alle hochgeladenen Jobs zu indexieren. Außerdem kann auf Ihrer Seite eine Kontingentbeschränkung vorliegen. Überprüfen Sie vor dem Senden von Jobs an CTS, ob in Ihrem System Beschränkungen für Indexierungsanfragen vorliegen.

Mechanismen zur Fehlerbehandlung

Die Fehlerbehandlung ist entscheidend, um einen selbstverschuldeten DDoS-Angriff zu vermeiden, der zu einer Sperrung von Jobsuchenden führt. Über das Internet bereitgestellte API-Dienste können auch zeitweise Verbindungsfehler, einen längeren Ausfall, plötzliche Dienstwartung und andere Ereignisse aufweisen, bei denen eine Clientanwendung die API-Anforderung erneut versuchen muss. Dieser Wiederholungsversuch muss mit netzwerkfreundlichem Verhalten gestaltet sein, z. B. exponentielles Backoff.

Deduplizierung

Doppelte Jobs trüben das Sucherlebnis von Jobsuchenden. Die Job Search API bietet zwei Funktionen zur Vermeidung von Duplikaten:

  1. Jobs erstellen: Wenn Sie versuchen, zwei oder mehr Jobs mit den folgenden Kriterien zu erstellen, wird der Eintrag abgelehnt und ein 4xx-Fehler angezeigt:

    • gleiche companyName, UND
    • gleiche job_req_id, UND
    • Derselbe Ort/languageCode
  2. Jobs suchen: Die CTS Job Search API zeigt Jobs an, die für die Suchanfrage des Jobsuchenden relevant sind. Durch eine integrierte Funktion des Relevanzalgorithmus wird erreicht, dass alle zurückgegebenen Jobs diversifiziert werden. So wird verhindert, dass in den Suchergebnissen nahezu identische Jobs nebeneinander angezeigt werden.