Skip to content

Latest commit

 

History

History
54 lines (40 loc) · 4.64 KB

partner-ad-manager.md

File metadata and controls

54 lines (40 loc) · 4.64 KB

Introduction

Alongside the Universal Posting Page, idibu provides a simple to use 'Admanager' interface which can also be fully styled using CSS to compliment the job posting funtionality and sit natively within the partner platform.

The Admanager is an iframe-ready tool which allows the end-user to efficiently manage an individual job ad across all boards/destinations that it was orginally posted to.

Here's an example of the core functionality, which allows for reposting, quick repost (refresh), and deletion of the selected advert:

image

Please note, Admanager does not show the status of all of the ads posted by any given customer, just the one selected. In most cases, the Admanager is made accessible to the recruiter alongside the 'Post Jobs' tab in the partner's UI. To ensure correct usage, please ensure Job References remain unique across all adverts (jobs) on each account.

Functionality

Indicators

  • Status
    • Live - Successfully posted. There may be a clickable link to view the ad on the website if the job board supports this.
    • Failed - Something went wrong when posting the ad. If it is a known issue, we'll send some helpful guidelines to the user on how to fix the problem.
    • Expired - When the post reaches its expiry date.
    • Deleted - Successfully removed.
  • Posted to - The name of the website on which the advert has been posted / deleted.
  • Posted at - The exact time of the posting / deletion, in UK timezone.
  • Applicants - Total number of candidates from the particular website. Please note this will only show the number of applications if you are using Aptrack and the website in question supports this feature.
  • Expires on - When the post will expire on the website, in UK timezone.

Actions

  • Quick Repost - Reposts the selected advert with exactly the same details in one click.
  • Quick Repost Expired - Quick reposts all currently expired posts, allowing to refresh the job on all websites with just a single click.
  • Full Repost - Allows to repost the selected advert and amend some details on the way, just like when posting a new job but with all the previous data pre-filled.
  • Delete Advert - Removes a particular post from the website (provided the website supports such functionality).
  • Delete All Adverts - Same as above, but for all applicable posts (ones that are currently active on websites that support deleting).

Generating the Admanager

Endpoint

https://www.idibu.com/clients/pam/index.php

Parameters

  • h - (required) - posting account's hash
  • ref - (required) - reference of the job to manage
  • ins - (required) - the repost link. You can use this in your software to generate your repost page same as when posting a new ad. By default, two parameters will be added to the provided URL:
    • J - job ID
    • M - will take value of R which stands for "REPOST" (see API methods for more info)
  • noRepostParameters - (optional) - if set to true, no J and M=R parameters will be appended to the ins URL on full repost. Please set this to true if you're redirecting to UPP. When reposting via UPP, remember to use the findJob=true parameter within the ins URL instead.
  • sameWindow - (optional) - if set to true, the Full Repost action will open a page in the current window instead of a new tab
  • s - (optional) - your partner ID if you wish to utilize custom styling

Managing and Reposting the ads

You can use the Advert Management Webservice and Job Management Webservice to obtain all the posting's details (such as title, description, etc.) and fill in more data inside your software based on that.

It's even easier with UPP - simply by inserting it as the ins parameter. For example:

https://www.idibu.com/clients/pam/index.php?h=ACCOUNT_HASH&ref=JOB_REFERENCE&noRepostParameters=true&ins=https%3A%2F%2Fwww.idibu.com%2Fclients%2Fupp%2Findex.php%3Fhash%3DACCOUNT_HASH%26jobRef%3DJOB_REFERENCE%26useOriginalSender%3Dtrue%26findJob%3Dtrue

This would generate an Admanager with a repost-ready UPP under the "Full Repost" button, with all the original details of the posting already pre-filled.