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. A video tutorial on implementing featured jobs is also available.
Implementing featured job search
There are two steps to implement a featured job search:
Create Job resources with
promotionValuefields set to a value greater than 0.
FEATURED_JOB_SEARCHonly 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
Featured job search best practices
Because a featured job search only returns promoted jobs to a job seeker,
enabling it (setting
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
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
documentation for more details.
Using featured job search with
A featured job search can be used in combination with the
enableBroadening parameters. These additional fields affect the order of
the returned results. See the Job Search
documentation for more information on
|Featured job search||
|+||+||+||Returns a higher number of jobs, including any featured jobs in both relevant and query expanded results.|
|+||-||-||Avoid using featured job search when
|+||-||+||Avoid using featured job search when
|+||+||-||Returns a higher number of jobs, including any featured jobs in both relevant and keyword matched results.|