[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-08-18。"],[],[],null,["# Featured job search\n\nA **featured job** search allows you to influence your users' search results by\nranking jobs according to promotional value rather than purely by relevance. A\nfeatured job search only returns relevant jobs with an assigned promotional\nvalue.\n\nFeatured job searches are useful in cases where you want the ability to sponsor\nindividual jobs in your index. For example, a career site promoting business\ncritical jobs can use a featured jobs search to return only sponsored jobs to\njob seekers. A video tutorial on implementing featured jobs is also\n[available](/talent-solution/job-search/docs/video).\n\nImplementing featured job search\n--------------------------------\n\nThere are two steps to implement a featured job search:\n\n1. Create Job resources with `promotionValue` fields set to a value greater\n than 0.\n\n2. Set the `searchMode` to `FEATURED_JOB_SEARCH`. `FEATURED_JOB_SEARCH` only\n returns jobs that both match the job seeker's search critera and have a\n promotion value \\\u003e 0.\n\nResults are ordered in decreasing order of their `promotionValue`. A search\nwith mode set to `FEATURED_JOB_SEARCH` **never** returns jobs with a\npromotion value of 0. In the case of a tie, the API uses relevance to any other\nprovided search criteria to determine the order of results. A featured job\nsearch respects all additional filters applied to the search request (for\nexample, location).\n\nFeatured job search best practices\n----------------------------------\n\nBecause a featured job search only returns promoted jobs to a job seeker,\nenabling it (setting `searchMode` to `FEATURED_JOB_SEARCH` for specified Job\nentities) can lead to a trade-off between your business value and the search\nrelevance value the job seeker is looking for. A regular search returns\nall matching jobs in your index, including any jobs with a promotion value, but\ndoes not take the promotion values into account when determining result\norder.\n\nFeatured job searches give you the ability to influence search results and\nhighlight jobs based on a single variable (`promotionValue`). For applications\nthat require balancing relevance with multiple promotional tiers, such as a\nmulti-tiered Cost-per-Click (CPC) subscriber system, Job Search supports\na separate multi-variable custom ranking feature. See the custom ranking\n[best practices](/talent-solution/job-search/docs/best-practices#custom_ranking)\ndocumentation for more details.\n\n### Using featured job search with `enableBroadening` and `disableKeywordMatch`\n\nA featured job search can be used in combination with the `disableKeywordMatch`\nand `enableBroadening` parameters. These additional fields affect the order of\nthe returned results. See the Job Search\n[best practices](/talent-solution/job-search/docs/best-practices#factors_affecting_search_results)\ndocumentation for more information on `enableBroadening` and\n`disableKeywordMatch`.\n| **Note:** Avoid using featured job search when `disableKeywordMatch` is set to `false` When `disableKeywordMatch` is turned off, a job seeker's query may return results with irrelevant but highly-promoted jobs listed first. This sacrifices search relevance and therefore relevance-related performance metrics. For example: You assign a high promotional value to a \"Software Engineer\" job with \"experience with server administration\" listed in the job description. A user queries for \"Restaurant Server\" and `disableKeywordMatch` is set to `false`. The top result is \"Software Engineer\" because the keyword \"server\" matched the description of a job with a high promotional value even though it's irrelevant to the job seeker."]]