Stay organized with collections
Save and categorize content based on your preferences.
Using CTS email alerts allows you to engage with your users by automatically
sending out email notifications for relevant jobs. For details on the searchJobsForAlert search method, see
the email alerts how-to guide.
To make sure that job seekers receive a variety of jobs in their notifications,
it's important to consier the following settings:
Diversification Level: Job queries sometimes return multiple similar results.
The CTS DiversificationLevel
parameter detects clusters of highly similar results and displays only one representative
job from that group high up in the results. The remainder are returned lower down.
This improves the diversification of relevant jobs sent to job seekers and leads to increased engagement.
Enable this feature by changing DiversificationLevel from unspecified to SIMPLE.
The Offset field: The offset
field specifies a starting position in the ranked list of relevant jobs returned
from a query. Entering a value in this field allows you to send multiple intra-day
emails to a job seeker with offset results in each (for example results 1-10 in the first email,
11-20 in the next). While this works only for searches with more search results than the designated
offset value, it reduces the chances of a job seeker repeatedly seeing the same job opening.
Date and time restrictions: You can adjust the date and time parameters
to only show jobs posted within a certain time frame by using the TimestampRange
filter. Depending on how many new jobs are posted daily, you can set this restriction
to the last 1 day, 3 days, and so on. This ensures that only the most recently-posted
jobs are shown in the email alert.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Implementing email alerts (v4beta1)\n\nUsing CTS email alerts allows you to engage with your users by automatically\nsending out email notifications for relevant jobs. For details on the `searchJobsForAlert` search method, see\nthe [email alerts](https://cloud.google.com/talent-solution/job-search/v4beta1/docs/email-alerts) how-to guide.\n\nTo make sure that job seekers receive a variety of jobs in their notifications,\nit's important to consier the following settings:\n\n- **Diversification Level** : Job queries sometimes return multiple similar results.\n The CTS [`DiversificationLevel`](/talent-solution/job-search/v4beta1/docs/reference/rest/v3p1beta1/DiversificationLevel)\n parameter detects clusters of highly similar results and displays only one representative\n job from that group high up in the results. The remainder are returned lower down.\n This improves the diversification of relevant jobs sent to job seekers and leads to increased engagement.\n Enable this feature by changing `DiversificationLevel` from unspecified to `SIMPLE`.\n\n- **The Offset field** : The [`offset`](https://cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v3p1beta1/projects.jobs/search#body.request_body.FIELDS.offset)\n field specifies a starting position in the ranked list of relevant jobs returned\n from a query. Entering a value in this field allows you to send multiple intra-day\n emails to a job seeker with offset results in each (for example results 1-10 in the first email,\n 11-20 in the next). While this works only for searches with more search results than the designated\n `offset` value, it reduces the chances of a job seeker repeatedly seeing the same job opening.\n\n- **Date and time restrictions** : You can adjust the date and time parameters\n to only show jobs posted within a certain time frame by using the [`TimestampRange`](https://cloud.google.com/talent-solution/job-search/v4beta1/docs/reference/rest/v3p1beta1/JobQuery#TimestampRange)\n filter. Depending on how many new jobs are posted daily, you can set this restriction\n to the last 1 day, 3 days, and so on. This ensures that only the most recently-posted\n jobs are shown in the email alert."]]