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
promotionValue
fields set to a value greater than 0.Set the
searchMode
toFEATURED_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).
Featured job search best practices
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.
Using featured job search with enableBroadening
and disableKeywordMatch
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. |