This document explains how to build your own user interface to display and select ad products. Available ad products can be programmatically retrieved by your software when posting or updating a job ad.
Building your own panel can be broken down into four tasks: gathering user input, querying ad products, rendering the panel, and handling user selections.
- SEEK recommends using a browser token to query ad products directly from a hirer’s browser. For the browser token to work, you will need to include the
query:ad-productsscope in your request.
- You can also query ad products from your backend using a partner token.
For your convenience, the structure of the
positionProfileinput subsets the input to the
positionOrganizationscurrently accept a single element. When creating a job ad, your software should always omit the optional
profileIdfield. When updating a job ad, your software should provide its
We recommend rendering ad selection after you capture salary information in your posting workflow. This will enable your software to supply the optional
seekAnzWorkTypeCodeinputs to ad selection, which SEEK can use to better predict—and inform the user of—how each ad product is likely to perform.
If a job ad has been saved as a draft in your software but has not been posted, the ad product selected by the user may become stale and its associated price may no longer be honoured. You should refresh product IDs that you have temporarily stored against job ad drafts. When loading a draft job ad into a user interface for submission, you should provide the saved product ID as
advertisementProductsquery allows you to retrieve ad products when posting or updating a job ad.
This query must be executed on page load and whenever the properties of the
positionProfileinput change. For example, if the hirer selects a new location, you must re-render the panel to reflect updated products and pricing.
The result of the
advertisementProductsquery should be presented to the user for selection. Your interface must be capable of displaying 1–3 ad products and we recommend accommodating 4 ad products. If there is a hard limit to the number of ad products that you can display, you must provide a
limitto the query so that SEEK can provide the most relevant set of products within your constraints. Do not manually truncate the returned list as that may exclude highly relevant products.
We’ve included a recommended design for your ad selection interface below. You can hover over the field descriptions to see which part of the interface they correspond to.
Find great candidates with our basic ad
- 30 day listing on SEEK
- Your job ad emailed to relevant candidates
Stand out with branding and key selling points
- Logo and cover image to promote your brand
Attract more candidates on average with a featured listing
- Priority listing in search
Ad prices vary based on many factors including the supply of, and demand for, candidates for the advertised role. Prices shown represent today's prices only. If you schedule your job ad for a future date, you acknowledge and agree you'll be charged the price of that ad at the date it's published on SEEK's website.
- Pre-select the product with a
selectedindicator set to
true. If all indicators are
false, then no ad product should be selected by default.
- Conditionally display subsequent fields to select a brand or enter search bullet points on the job posting form. Each field should only be displayed when a product is selected and the corresponding feature is supported by the selected product.
When a hirer selects an ad product, your software should conditionally display form inputs for the additional job ad features it enables. See features for ad products for a detailed walkthrough.