Qandidate.com integratie met eigen Recruitmentsite. Mei 2014 Qandidate.com product information

Transcriptie

1 Qandidate.com integratie met eigen Recruitmentsite Mei 2014 Qandidate.com product information

2 Inhoud Introductie 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

3 Introductie Ieder Qandidate.com account wordt automatisch voorzien van een werken bij campagnesite. Bekijk als voorbeeld of 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: Product documentation Qandidate.com 3

4 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 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

5 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 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 support@qandidate.com. 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 (gedeactiveerd) Vacature detailpagina voor iedere actieve vacature (gedeactiveerd) Sollicitatieformulier voor iedere actieve vacature (omgezet naar Integratie modus ) Beschikbare XML bestanden: : Lijst met alle actieve vacatures in Qandidate.com : Maximaal 1x per 10 minuten : : : Lijst met alle actieve interne vacatures in Qandidate.com. Deze moeten niet publiekelijk toegankelijk zijn! : Maximaal 1x per 10 minuten : : : Lijst met alle branches in Qandidate.com : : : Lijst met alle functiecategorieën in Qandidate.com : : : Lijst met alle contractsoorten in Qandidate.com Product documentation Qandidate.com 5

6 : : : Lijst met alle opleidingsniveaus in Qandidate.com : : : Lijst met alle functieniveaus in Qandidate.com : : Alle XML bestanden zijn zowel in het Engels als in het Nederlands beschikbaar. Om een andere taal op te halen kunt u achter de de volgende parameter meegeven: Engels :?lang=en Nederlands :?lang=nl Het sollicitatieformulier In de jobs.xml feed heeft iedere vacature een <> tag. Dit is de basis- die gebruikt moet worden om te linken naar het sollicitatieformulier. Afhankelijk van hoe een bezoeker op uw Recruitmentsite komt moet deze basis- verder uitgebreid worden. Directe bezoeker op uw eigen Recruitmentsite Als een kandidaat direct uw eigen Recruitmentsite bezoekt kan de basis- gebruikt worden. De <productid> placeholder in de basis- staat standaard ingesteld op V144. Qandidate.com registreert dan dat de bezoeker direct via uw eigen Recruitmentsite heeft gesolliciteerd. van een voor : Bedrijf : Globo Tech BV Vacature : Sales Manager jobid : 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 support@qandidate.com. 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

7 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 support@qandidate.com) allereerst een op te geven waar al het verkeer naar gestuurd kan worden. Bijvoorbeeld: Product documentation Qandidate.com 7

8 Actions Bij het doorsturen van de kandidaat naar uw opgegeven (listener) worden kunnen een aantal acties doorgeven worden. Deze acties worden vergezeld met 1 of meerdere parameters. Action =overview =job =applied =talentpool 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> 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

9 Use cases : Een kandidaat drukt op het sollicitatieformulier op terug naar alle vacatures Een kandidaat toont interesse in een vacature via een Adwords advertentie. : Id=V35 Een kandidaat drukt op het sollicitatieformulier op terug naar de vacature Id=V35 Een kandidaat heeft zijn sollicitatie met succes afgerond Een kandidaat heeft de uitnodiging om deel te nemen aan de Talentpool geaccepteerd 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. van een sollicitatie voor: Bedrijf : Globo Tech BV vacature : Sales Manager productid : V35 jobid : referrerjobid : 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