פרמטרים של Job Search API: שיטות מומלצות (גרסה 3)

הגדרת ה-API

גורמים שמשפיעים על תוצאות החיפוש

ההגדרות 'משרות מומלצות', 'הרחבת החיפוש' ו'השבתת ההתאמה למילות מפתח' משפיעות באופן משמעותי על מספר המשרות שמוצגות למועמדים ועל הרלוונטיות שלהן. ההגדרה המתאימה ביותר של שלושת הגורמים האלה תלויה בצרכים של העסק. הדרך הכי טובה לקבוע את ההגדרה האופטימלית היא להחיל תרחישי בדיקה שונים ולנתח את התוצאות במהלך שלב הבדיקה.

  1. משרות מומלצות: אתם יכולים להשתמש במשרות מומלצות כדי להקצות ערכים שיווקיים למשרות ספציפיות, וכך להבליט משרות שחשובות לצרכים העסקיים שלכם. במאמר בנושא משרות מומלצות מפורטות שיטות מומלצות ופרטים על ההטמעה.

  2. ‫disableKeywordMatch: הפרמטר הזה מאפשר ל-API להחזיר התאמות למילות מפתח בנוסף לתוצאות הרלוונטיות שנקבעו על ידי אלגוריתם ה-ML. ערך ברירת המחדל הוא false. אם משאירים את הגדרת ברירת המחדל, ה-API של CTS Job search מחזיר משרות שלא הוחזרו כרלוונטיות על ידי אלגוריתם ה-ML, אבל יש התאמה למילת מפתח בשם או בתיאור המשרה למחרוזת השאילתה של מחפש העבודה. הגדרת הפרמטר הזה לערך true משביתה את ההתאמה למילת מפתח, ולכן מוחזרות פחות משרות (רק אלה שהתכונה מבוססת ה-ML קבעה שהן רלוונטיות).

  3. ‫enableBroadening: הפרמטר הזה מאפשר להרחיב את השאילתה של מחפש העבודה על ידי הקלה על ההגבלות שהוצהרו על מיקום וקטגוריות של משרות. ההגדרה היא false כברירת מחדל, והיא מופעלת כשמגדירים אותה כ-true. הוא משמש להגדלת מספר תוצאות החיפוש שמוחזרות.

תוצאות של הגדרות חיפוש

כדי לקבל רק את המשרות הרלוונטיות ביותר: מגדירים את disableKeywordMatch לערך true ואת enableBroadening לערך false. כך משתפרים מדדי הביצועים של ה-API שקשורים לרלוונטיות של החיפוש, כי רק המשרות הרלוונטיות מוחזרות. עם זאת, בתוצאות החיפוש מוצגות פחות משרות באופן כללי.

כדי להחזיר מספר גדול יותר של משרות, כולל תוצאות רלוונטיות ותוצאות שתואמות למילות המפתח: מגדירים את disableKeywordMatch ל-false ואת enableBroadening ל-false. התוצאות שתואמות למילת המפתח מופיעות אחרי המשרות הרלוונטיות בתוצאות, אבל תוצאות של הרחבת השאילתה לא מוחזרות.

כדי להחזיר מספר גדול יותר של משרות, כולל משרות רלוונטיות ומשרות שמתאימות להרחבת השאילתה: מגדירים את disableKeywordMatch ל-true ואת enableBroadening ל-true. השאילתה של מחפש העבודה מורחבת כך שתכלול קטגוריות משרות קשורות ומיקומים בקרבת מקום, שמופיעים אחרי התוצאות הרלוונטיות. לא מוחזרות התאמות שמבוססות על מילות מפתח.

כדי להחזיר את המספר הגבוה ביותר האפשרי של משרות: מגדירים את disableKeywordMatch ל-false ואת enableBroadening ל-true. ה-API של חיפוש משרות מחזיר את המשרות הרלוונטיות ביותר בראש תוצאות החיפוש, ואחריהן משרות שתואמות למילות המפתח ומשרות שהורחבו לפי שאילתה (לפי מיקום, קטגוריית משרה וכו'). כך מגדילים את המספר הכולל של המשרות שמוחזרות.

diasableKeywordMatch enableBroadening תוצאת הסריקה
- - מחזירה מספר גבוה יותר של משרות, כולל תוצאות רלוונטיות ותוצאות שתואמות למילות המפתח (אבל נניח שההגדרה של משרות מומלצות היא `false`).
+ + מחזירה מספר גבוה יותר של משרות, כולל משרות רלוונטיות ומשרות שנוספו בעקבות הרחבת השאילתה (אבל נניח שההגדרה של משרות מומלצות היא `false`).
- + הפונקציה מחזירה את המספר הגבוה ביותר של משרות (אבל נניח שהמאפיין 'משרות מומלצות' מוגדר כ-`false`).
+ - הפונקציה מחזירה רק את המשרות הרלוונטיות ביותר (אבל מניחה שההגדרה 'משרות מומלצות' היא `false`).

Request.page_size

כדי לשפר את הביצועים ולמנוע השהיה, מומלץ להגדיר את דף התוצאות כך שיוצגו בו 20 משרות או פחות בכל פעם.

customAttributes

customAttributes מאפשרת לכם להקצות ערכים נוספים למשימות בהתאם לצרכים העסקיים שלכם (למשל, ציוני GPA) ולהשתמש בערכים האלה כדי לסנן את התוצאות.

שדה מיקום

סקירה מפורטת של שדה המיקום זמינה בדף שדות מיקום. הזנת כתובת הרחוב של המשרה במקום קואורדינטות GPS בשדה הכתובת עוזרת ל-API לשפר את זיהוי המיקום ואת הרלוונטיות של החיפוש.

locationFilter

משתמשים ב-regionCode אם לחברה אחת יש כמה משרות פתוחות שממוקמות באזורים גיאוגרפיים שונים. הקצאת regionCode לכל משרה מבטיחה ששאילתת חיפוש תחזיר משרות רק במיקום הרצוי של מחפש העבודה, ולא את התוצאות הגלובליות של החברה. לדוגמה, חיפוש של מילת המיקום 'קיימברידג' בלי regionCode מחזיר תוצאות גם מקיימברידג' בבריטניה וגם מקיימברידג' במסצ'וסטס בארה"ב. כך הרלוונטיות של החיפוש יורדת.

Region_code וגם Language_code

מגדירים את הערך request.filters.location_filters.region_code כך שיתאים למיקום הגיאוגרפי שהמשתמש מחפש (למשל בריטניה). מגדירים את request.filters.language_code לקוד השפה המתאים לאזור (en_GB במקרה הזה), כדי שה-API יוכל להשתמש בלוגיקה של חיפוש מקומי (לדוגמה, lorry driver ב-en_GB לעומת truck driver בארצות הברית).

radiusinMiles

הפרמטר הזה מגדיר רדיוס (במיילים) סביב המיקום שצוין על ידי מחפש העבודה. ה-API מחזיר תוצאות בטווח הגיאוגרפי הזה. אופן השימוש במרחק הזה בתוצאות החיפוש תלוי בסוג פרטי המיקום שהוזנו. אם מחפש העבודה מזין כתובת רחוב, המרחק radiusInMiles מוגדר מנקודה אחת. אם מחפש העבודה מזין עיר, ה-API מחיל תיבת תוחמת סביב גבולות העיר ומחשב את המרחק מקצוות התיבה. אם המשתמש מזין רק מדינה או אזור, המערכת מתעלמת מ-radiusInMiles.

חשוב לוודא שרדיוס המרחק קטן ככל האפשר. הגדרת טווח גדול יותר של מרחק תניב תוצאות שעשויות להיות מחוץ למיקום הרצוי של מחפש העבודה, וכך הרלוונטיות תפחת. לדוגמה, אם מחפשים משרות בניו יורק ומגדירים את radiusInMiles ל-160 ק"מ, התוצאות יכללו משרות גם בצפון מדינת ניו יורק וגם בניו ג'רזי. ככל שהרדיוס קטן יותר, כך התוצאות רלוונטיות יותר.

postingExpireTime

הפרמטר הזה מגדיר את משך הזמן שבו פרסום המשרה פעיל לפני שהוא מוסר מתוצאות החיפוש. ברירת המחדל היא 30 ימים אחרי שעת יצירת העבודה באזור הזמן UTC.

Job_employment_type

זה לא שדה חובה, אבל שימוש במאפיין Job_employment_type משפר את הרלוונטיות של תוצאות חיפוש המשרות.

הגדרת ה-API: דירוג מותאם אישית

הצגת משרות מומלצות מאפשרת לכם להשפיע על תוצאות החיפוש ולהבליט משרות על סמך משתנה יחיד (promotionValue). פרטים נוספים זמינים בתיעוד בנושא הצגת משרות מומלצות. דירוג בהתאמה אישית מאפשר לכם להשפיע על התוצאות על סמך כמה משתנים, ומציע לכם יותר שליטה על הדירוגים בלי קשר לרלוונטיות. התכונה הזו שימושית לאפליקציות שנדרש בהן איזון בין רלוונטיות לבין אינטרסים כלכליים, כמו מערכת מנויים רב-שכבתית עם תמחור לפי עלות לקליק (CPC). ההשפעה על דירוג המשרות בנוסף לציון הרלוונטיות הקיים מבוססת על שני משתנים: rankingExpression ו-importanceLevel.

  • ‫rankingExpression: המשתנה הזה קובע את הדירוג של המשרות על סמך ציוני הרלוונטיות הקיימים שלהן (כפי שנקבע על ידי אלגוריתם ה-API). כדי שממשק ה-API יוכל ליצור אינדקס לפרמטר, צריך להגדיר את הערך של 'rankingExpression' כ-'filterable'.

  • ‫importanceLevel: הפרמטר הזה מגדיר את רמת החשיבות של מיקום המשרה בדירוג כשהיא מוחזרת בחיפושים. יש שש רמות שונות: לא צוין, NONE, LOW, MID, HIGH ו-EXTREME. הגדרת הערך ל-EXTREME גורמת להתעלמות מכל שאר גורמי הרלוונטיות שנוצרו על ידי ה-API, ולכן מומלץ להשתמש בערך הזה במשורה. משרות שמוגדרות כEXTREME מוחזרות בראש השאילתה של מחפש העבודה במקום המשרות הרלוונטיות ביותר.

  • משרות מומלצות לעומת דירוג מותאם אישית: התכונה משרות מומלצות הכי שימושית לקידום קטגוריה אחת של משרות (לדוגמה, משרות בחברה מסוימת) מעל דירוג הרלוונטיות. אם אתם צריכים לדרג משרות לפי משתנים של עלות לקליק (CPC) בכמה רמות, בנוסף לדירוג הרלוונטיות, דירוג מותאם אישית היא הבחירה הטובה יותר.

חיפוש לפי נסיעה לעבודה עוזר למחפשי עבודה לחפש משרות על סמך זמן הנסיעה לעבודה. כדי להפעיל אותו, צריך לכלול אובייקט CommuteFilter נוסף בשדה JobQuery.commuteFilter. האובייקט הזה מאפשר למחפשי העבודה לבחור commuteMethod, travelDuration ו-startCoordinates. בחישוב זמן הנסיעה לעבודה, מחפשי העבודה יכולים גם לבחור אפשרויות כמו roadTraffic (TRAFFIC_FREE או BUSY_HOUR) ו-departureTime. פרטים נוספים מופיעים בדפים בנושא הטמעה והוראות של חיפוש נסיעות.

ניהול נתונים וטיפול בשגיאות

שלמות הנתונים

  1. העלאת משימות: בעיות בנתונים יכולות למנוע העלאה של משימות ל-API. מידע נוסף זמין בדף בנושא קודי תגובה של HTTP. דוגמאות נפוצות:

    • מיקומי המשרות שגויים, ולכן אי אפשר לטפל בבקשה.
    • שדות החברה או המשרה לא קיימים, ולכן מוחזרת בקשה שגויה.

    יש שלוש אפשרויות עיקריות לפתרון בעיות בהעלאת משרות:

    • בודקים את הרישום מהקצה העורפי.
    • בודקים את כלי הניהול של CTS כדי לראות אם יש רישום של נתונים.
    • מגדירים את כלי Stackdriver Monitoring במסוף Cloud כדי לאסוף מטא-נתונים, מדדים ואירועים.

  2. הוספת משרות לאינדקס: Job search API נועד להוסיף לאינדקס את כל המשרות שהעליתם בפרק זמן מוגדר. עם זאת, יכול להיות שיש מגבלות על המכסה בצד שלכם. לפני ששולחים משימות ל-CTS, חשוב לבדוק אם יש הגבלות במערכת על בקשות לאינדוקס.

מנגנונים לטיפול בשגיאות

טיפול בשגיאות הוא חיוני כדי למנוע מתקפת DDoS עצמית שגורמת למועמדים לאבד את הגישה. שירותי API שמועברים דרך האינטרנט יכולים גם לסבול מכשלים לסירוגין בחיבור, מהפסקות ארוכות, מתחזוקת שירות פתאומית ומאירועים אחרים שמחייבים את אפליקציית הלקוח לנסות שוב את בקשת ה-API. הניסיון החוזר צריך להיות מתוכנן באופן שלא יגרום עומס על הרשת, למשל השהיה מעריכית לפני ניסיון חוזר (exponential backoff).

ביטול כפילויות

משרות כפולות פוגעות בחוויית החיפוש של מחפשי העבודה. ממשק ה-API לחיפוש עבודה כולל שתי תכונות לצמצום כפילויות:

  1. יצירת משימות: אם תנסו ליצור 2 משימות או יותר עם הקריטריונים הבאים, הרשומה תידחה ותופיע שגיאת 4xx:

    • זהה ל-companyName, וגם
    • זהה ל-job_req_id, וגם
    • באותו מיקום/languageCode

  2. חיפוש עבודות: ה-API של CTS Job search מציג עבודות שרלוונטיות לשאילתת החיפוש של מחפש העבודה. תכונה מובנית באלגוריתם הרלוונטיות מוודאת שכל המשרות שמוצגות מגוונות, ומונעת ממשרות כמעט זהות להופיע זו לצד זו בתוצאות החיפוש.