Qandidate.com integratie met eigen Recruitmentsite Mei 2014 Qandidate.com product information Inhoud Introductie ................................................................................................................................. 3 3 manier om te koppelen met uw eigen (recruitment)website ................................................ 4 Externe integratie switch .......................................................................................................... 5 Beschikbare XML bestanden: .................................................................................................... 5 Het sollicitatieformulier ............................................................................................................ 6 Directe bezoeker op uw eigen Recruitmentsite ........................................................................ 6 Bezoekers via VONQ media kanalen ......................................................................................... 6 Actions ....................................................................................................................................... 8 Parameters ................................................................................................................................ 8 Use cases ................................................................................................................................... 9 Het aanroepen van het sollicitatieformulier: ............................................................................ 9 Product documentation – Qandidate.com 2 Introductie Ieder Qandidate.com account wordt automatisch voorzien van een “werken bij” campagnesite. Bekijk als voorbeeld https://epsilon.has-jobs.com of https://hiltinederland.heeft-vacatures.nl Hier worden alle actieve vacatures getoond in een overzicht, kunnen vacatures gedeeld worden in verschillende social media kanalen, en kunnen kandidaten solliciteren op een sollicitatiepagina. De Qandidate.com campagnesite bestaat uit de volgende onderdelen: ● ● ● Overzichtspagina met alle actieve vacatures Vacature detailpagina voor iedere actieve vacature Sollicitatieformulier voor iedere actieve vacature De Qandidate.com campagnesite is altijd bereikbaar op al de volgende domeinen: ● ● ● ● ● https://<bedrijfsnaam>.heeft-vacatures.nl https://<bedrijfsnaam>.has-jobs.com https://<bedrijfsnaam>.has-jobs.co.uk https://<bedrijfsnaam>.heeft-jobs.be https://<bedrijfsnaam>.hat-stellen.de Product documentation – Qandidate.com 3 3 manier om te koppelen met uw eigen (recruitment)website Veel organisaties kiezen ervoor om hun eigen website te koppelen met Qandidate.com. Er zijn momenteel drie manieren op te koppelen. 1. Verwijzing naar de vacaturepagina van Qandidate.com Deze wijze van koppelen is veruit het gemakkelijkst in opzet. Op uw eigen site verwijst u simpelweg naar het “overzicht van vacatures” op de vacaturepagina van Qandidate.com. Veel organisaties hebben een “Vacatures” knop op de homepage. U kunt die knop door uw websitebeheerder laten verwijzen naar uw https://<bedrijfsnaam>.heeft-vacatures.nl pagina. 2. Verwijzing naar het sollicitatieformulier van Qandidate.com Deze wijze van koppelen kost weinig tot geen werk voor uw websitebeheerder. De enige aanpassing op uw website, mits dit niet reeds mogelijk is, is het kunnen verwijzen van uw “Solliciteer” knop naar het sollicitatieformulier van Qandidate.com. U voert zowel op Qandidate.com als op uw eigen website de vacature toe, maar de sollicitatieknop op uw eigen site laat u verwijzen naar het sollicitatieformulier op Qandidate.com. Het nadeel van deze koppeling is dat u iedere vacature twee keer moet opvoeren. Bovendien, wanneer u de vacature wilt aanpassen of verwijderen, dient u dit ook dubbel uit te voeren. Zowel in Qandidate.com als op uw eigen website. 3. Volledige integratie van uw (recruitment)website met Qandidate.com Deze standaard “Heeft-Vacatures” campagnesite van Qandidate.com is slechts in beperkte mate aanpasbaar naar de huisstijl van uw organisatie. Om die reden kiezen sommige organisaties ervoor om geen gebruik te maken van deze standaard campagnesite van Qandidate.com, maar van een zelfgebouwde recruitment website. Via de volledige integratie koppeling blijft het sollicitatieformulier beschikbaar op de standaard campagnesite van Qandidate.com. De rest van dit document licht stapsgewijs toe hoe een dergelijke koppeling (3) gebouwd kan worden. Product documentation – Qandidate.com 4 Externe integratie switch Om het aanbod aan actieve vacatures op te halen uit Qandidate.com en deze vervolgens te tonen op uw website, dient u een XML bestand in te lezen. Qandidate.com is bovendien voorzien van standaard lijsten met categorieën. Deze zijn tevens beschikbaar in XML formaat. Deze XML bestanden kunen gebruikt worden om uw eigen website te voorzien van jullie vacatures. Het sollicitatieformulier blijft beschikbaar op de Qandidate.com campagnesite. Om de sollicitant optimaal gebruik te laten maken van jullie site is navigatie tussen uw site en de Qandidate.com campagnesite nodig. De sollicitant moet namelijk van ons sollicitatieformulier kunnen terugnavigeren naar de details pagina van de desbetreffende vacature en de sollicitant moet direct kunnen terugnavigeren naar het vacature overzicht. Verder redirecten we de sollicitant terug naar jullie site zodra deze heeft gesolliciteerd. Om deze navigatie mogelijk te maken hebben we een ‘Listener Url’ nodig (bijvoorbeeld http://www.uwwerkenbijsite.com/listener). Meer informatie over de Listener Url kan gevonden worden onder het kopje ‘Actions’. De XML bestanden zijn pas beschikbaar wanneer een “Externe integratie” switch wordt omgezet in het Qandidate.com systeem. Het omzetten van de switch wordt (momenteel nog) door het Qandidate.com development team gedaan, bereikbaar op [email protected]. Gelieve bij het verzoek om de integratie aan te zetten de Listener Url te vermelden. LET OP! Wanneer deze “Externe integratie” switch is omgezet, wordt het gedrag van de Qandidate.com campagnesite gewijzigd op de volgende onderdelen: ● ● ● Overzichtspagina met alle actieve vacatures Vacature detailpagina voor iedere actieve vacature Sollicitatieformulier voor iedere actieve vacature (gedeactiveerd) (gedeactiveerd) (omgezet naar “Integratie modus”) Beschikbare XML bestanden: Omschrijving Refresh URL Voorbeeld : Lijst met alle actieve vacatures in Qandidate.com : Maximaal 1x per 10 minuten : https://<bedrijfsnaam>.heeft-vacatures.nl/externalIntegration/v2/jobs.xml : https://globotechbv.heeft-vacatures.nl/externalIntegration/v2/jobs.xml Omschrijving : Lijst met alle actieve interne vacatures in Qandidate.com. Deze moeten niet publiekelijk toegankelijk zijn! Refresh : Maximaal 1x per 10 minuten URL : https://<bedrijfsnaam>.heeft-vacatures.nl/externalIntegration/v2/internal-jobs.xml Voorbeeld : https://globotechbv.heeft-vacatures.nl/externalIntegration/v2/internal-jobs.xml Omschrijving Refresh URL Voorbeeld : Lijst met alle branches in Qandidate.com : Maximaal 1x per dag : https://<bedrijfsnaam>.heeft-vacatures.nl/externalIntegration/businesssectors.xml : https://globotechbv.heeft-vacatures.nl/externalIntegration/businesssectors.xml Omschrijving Refresh URL Voorbeeld : Lijst met alle functiecategorieën in Qandidate.com : Maximaal 1x per dag : https://<bedrijfsnaam>.heeft-vacatures.nl/externalIntegration/jobcategories.xml : https://globotechbv.heeft-vacatures.nl/externalIntegration/jobcategories.xml Omschrijving Refresh : Lijst met alle contractsoorten in Qandidate.com : Maximaal 1x per dag Product documentation – Qandidate.com 5 URL Voorbeeld : https://<bedrijfsnaam>.heeft-vacatures.nl/externalIntegration/contracts.xml : https://globotechbv.heeft-vacatures.nl/externalIntegration/contracts.xml Omschrijving Refresh URL Voorbeeld : Lijst met alle opleidingsniveaus in Qandidate.com : Maximaal 1x per dag : https://<bedrijfsnaam>.heeft-vacatures.nl/externalIntegration/educationlevels.xml : https://globotechbv.heeft-vacatures.nl/externalIntegration/educationlevels.xml Omschrijving Refresh URL Voorbeeld : Lijst met alle functieniveaus in Qandidate.com : Maximaal 1x per dag : https://<bedrijfsnaam>.heeft-vacatures.nl/externalIntegration/joblevels.xml : https://globotechbv.heeft-vacatures.nl/externalIntegration/joblevels.xml Alle XML bestanden zijn zowel in het Engels als in het Nederlands beschikbaar. Om een andere taal op te halen kunt u achter de URL de volgende parameter meegeven: Engels : ?lang=en Nederlands : ?lang=nl Het sollicitatieformulier In de jobs.xml feed heeft iedere vacature een <URL> tag. Dit is de basis-URL die gebruikt moet worden om te linken naar het sollicitatieformulier. Afhankelijk van hoe een bezoeker op uw Recruitmentsite komt moet deze basis-URL verder uitgebreid worden. Directe bezoeker op uw eigen Recruitmentsite Als een kandidaat direct uw eigen Recruitmentsite bezoekt kan de basis-URL gebruikt worden. De <productId> placeholder in de basis-URL staat standaard ingesteld op “V144”. Qandidate.com registreert dan dat de bezoeker direct via uw eigen Recruitmentsite heeft gesolliciteerd. Voorbeeld van een URL voor : ● Bedrijf : Globo Tech BV ● Vacature : Sales Manager ● jobId : 11851 https://globotechbv.heeft-vacatures.nl/Sales_Manager/11851/V144/solliciteren?external=1 Het is mogelijk om het uiterlijk van het sollicitatieformulier aan te passen. Dit kan door een css bestand naar het development team te sturen. Het development team is bereikbaar op [email protected]. Bezoekers via VONQ media kanalen Qandidate.com is voorzien van een recruitment media webshop, aangeboden door VONQ. Indien er media afgenomen wordt in deze webshop, zal de vacature vervolgens door VONQ op deze media gepost worden. Het is van belang dat al het verkeer goed wordt doorgemeten, zodat er rapportages opgeleverd kunnen worden over de prestaties van de ingezette online kanalen. Wanneer een kandidaat interesse toont in een vacature, gepost op één van de door VONQ ingezette kanalen, zal deze in 90% van de gevallen direct worden doorgestuurd naar de sollicitatiepagina. Hier hoeft u niets voor te doen. VONQ en Qandidate.com zorgen dat dit goed doorgemeten wordt. Product documentation – Qandidate.com 6 Echter in de andere 10% van de gevallen is het niet logisch om de kandidaat op de sollicitatiepagina te laten landen, maar heeft de kandidaat de behoefte om eerst de vacature nog eens door te nemen alvorens te besluiten te solliciteren. In geval van een Google Adwords campagne heeft de kandidaat bijvoorbeeld slechts een kleine tekstadvertentie gezien en heeft dan meer informatie nodig om tot solliciteren over te gaan. Aangezien de vacaturetekst op uw Recruitmentsite staat, zal VONQ de kandidaat naar uw Recruitmentsite doorsturen. Om dit te bewerkstelligen dient u (via [email protected]) allereerst een URL op te geven waar al het verkeer naar gestuurd kan worden. Bijvoorbeeld: http://www.uwrecruitmentsite.nl/listener Product documentation – Qandidate.com 7 Actions Bij het doorsturen van de kandidaat naar uw opgegeven (listener) URL worden kunnen een aantal acties doorgeven worden. Deze acties worden vergezeld met 1 of meerdere parameters . Action =overview =job =applied =talentpool Omschrijving u dient de kandidaat te laten landen op het overzicht met al uw vacatures. Deze actie wordt altijd vergezeld door de parameters <productId> en <referrerJobId> u dient de kandidaat te laten landen op de vacature details pagina. Deze actie wordt altijd vergezeld door de parameters <productId>, <jobId> en <referrerJobId> de kandidaat heeft de sollicitatie afgerond. U kunt de kandidaat een zogenoemde “bedankpagina” tonen op uw eigen Recruitmentsite. Deze actie wordt altijd vergezeld door de parameters <applicantId> en <jobId> een kandidaat kan uitgenodigd worden voor de Talentpool van het bedrijf. De kandidaat moet deze uitnodiging accepteren of weigeren. Deze actie wordt altijd vergezeld door de parameter <type>. Afhankelijk van de waarde van <type> kunt u een passende “bedankpagina” tonen aan de kandidaat. Parameters Parameters <jobId> <productId> <referrerJobId> <applicantId> <type> Omschrijving Refereert aan de unieke code behorend bij een vacature Refereert aan de lijst met mediakanalen welke staan geregistreerd in het portfolio van VONQ. De vacature die heeft geleid tot het allereerste contact met de kandidaat Refereert aan de unieke code behorend bij de sollicitant Heeft betrekking op de action <talentpool>. Kan twee waarden bevatten, namelijk: ● type=accepted ● type=rejected Product documentation – Qandidate.com 8 Use cases Omschrijving: Een kandidaat drukt op het sollicitatieformulier op “terug naar alle vacatures” http://www.uwrecruitmentsite.nl/listener?action=overview&referrerJobId=11851&productId=v35 Omschrijving Een kandidaat toont interesse in een vacature via een Adwords advertentie. : http://www.uwrecruitmentsite.nl/listener?action=job&jobId=11851&referrerJobId=11851&product Id=V35 Omschrijving Een kandidaat drukt op het sollicitatieformulier op “terug naar de vacature” http://www.uwrecruitmentsite.nl/listener?action=job&jobId=11851&referrerJobId=11851&product Id=V35 Omschrijving Een kandidaat heeft zijn sollicitatie met succes afgerond http://www.uwrecruitmentsite.nl/listener?action=applied&applicantId=123456&jobId=11851 Omschrijving Een kandidaat heeft de uitnodiging om deel te nemen aan de Talentpool geaccepteerd http://www.uwrecruitmentsite.nl/listener?action=talentpool&type=accepted Het aanroepen van het sollicitatieformulier: Het is uw verantwoordelijkheid om de twee parameters <referrerJobId> en <productId> op te slaan. Een veel gebruikte manier is middels cookies, maar dit kunt u geheel zelf bepalen. Wanneer u echter het sollicitatieformulier aanroept dient u de twee parameters weer mee te sturen. Voorbeeld van een sollicitatie URL voor: ● Bedrijf : Globo Tech BV ● vacature : Sales Manager ● productId : V35 ● jobId : 11851 ● referrerJobId : 12345 https://globotechbv.heeftvacatures.nl/Sales_Manager/11851/V35/solliciteren?external=1&referrerJobId=12345 Indien de parameters niet volledig of niet juist worden meegegeven, zal het platform automatisch een foutmelding tonen (HTTP status code 500). Product documentation – Qandidate.com 9
© Copyright 2024 ExpyDoc
