Featured job search

A featured job search allows you to influence your users' search results by ranking jobs according to promotional value rather than purely by relevance. A featured job search only returns relevant jobs with an assigned promotional value.

Featured job searches are useful in cases where you want the ability to sponsor individual jobs in your index. For example, a career site promoting business critical jobs can use a featured jobs search to return only sponsored jobs to job seekers.

There are two steps to implement a featured job search:

  1. Create Job resources with promotionValue fields set to a value greater than 0.

  2. Set the searchMode to FEATURED_JOB_SEARCH. FEATURED_JOB_SEARCH only returns jobs that both match the job seeker's search critera and have a promotion value > 0.

Results are ordered in decreasing order of their promotionValue. A search with mode set to FEATURED_JOB_SEARCH never returns jobs with a promotion value of 0. In the case of a tie, the API uses relevance to any other provided search criteria to determine the order of results. A featured job search respects all additional filters applied to the search request (for example, location).

Because a featured job search only returns promoted jobs to a job seeker, enabling it (setting searchMode to FEATURED_JOB_SEARCH for specified Job entities) can lead to a trade-off between your business value and the search relevance value the job seeker is looking for. A regular search returns all matching jobs in your index, including any jobs with a promotion value, but does not take the promotion values into account when determining result order.

Featured job searches give you the ability to influence search results and highlight jobs based on a single variable (promotionValue). For applications that require balancing relevance with multiple promotional tiers, such as a multi-tiered Cost-per-Click (CPC) subscriber system, Job Search supports a separate multi-variable custom ranking feature. See the custom ranking best practices documentation for more details.

A featured job search can be used in combination with the disableKeywordMatch and enableBroadening parameters. These additional fields affect the order of the returned results. See the Job Search best practices documentation for more information on enableBroadening and disableKeywordMatch.

Featured job search diasableKeywordMatch enableBroadening Outcome
+ + + Returns a higher number of jobs, including any featured jobs in both relevant and query expanded results.
+ - - Avoid using featured job search when disableKeywordMatch is set to false.
+ - + Avoid using featured job search when disableKeywordMatch is set to false.
+ + - Returns a higher number of jobs, including any featured jobs in both relevant and keyword matched results.
Var denne siden nyttig? Si fra hva du synes:

Send tilbakemelding om ...

Job Search documentation