Incrustar el portal de empleo en su página de empleo¶

1. Resumen¶

PreScreen le proporciona un sitio de empleo alojado por Polyguard en su propio subdominio, por ejemplo https://careers.example.com. La incrustación coloca ese mismo portal dentro de su página de empleo actual, de modo que los candidatos nunca salen de su sitio y la página conserva su cabecera, su pie y sus estilos.

Esto se hace sustituyendo una etiqueta <script>. Todo lo demás de la página se mantiene igual, incluido el contenedor donde se muestra el portal.

Lo que ve el candidato¶

La lista de vacantes, las páginas de detalle de cada puesto y el formulario de solicitud aparecen en el lugar que ocupaba su portal anterior. Cuando el candidato envía una solicitud, la Trust Check de Polyguard se abre sobre toda la página, el candidato la completa en su teléfono y la solicitud llega a su ATS con la verificación adjunta.

Lo que no cambia¶

2. Requisitos previos¶

3. Añada la incrustación a su página¶

3a. Si hoy incrusta Greenhouse¶

Una página de empleo con Greenhouse incrustado tiene un div contenedor y el script de carga de Greenhouse:

<div id="grnhse_app"></div>
<script src="https://boards.greenhouse.io/embed/job_board/js?for=YOUR_TOKEN"></script>

Cambie el src y nada más:

<div id="grnhse_app"></div>
<script src="https://careers.example.com/embed/greenhouse_js?for=YOUR_TOKEN"></script>

El script de Polyguard busca el mismo div grnhse_app y admite el mismo parámetro de enlace directo gh_jid, así que los enlaces existentes a puestos concretos siguen funcionando.

3b. Si incrusta por primera vez¶

Añada un div contenedor donde deba aparecer el portal y, después, el script:

<div id="polyguard_jobs"></div>
<script src="https://careers.example.com/embed/embed_js?for=YOUR_TOKEN"></script>

El script rellena el primer contenedor que encuentra con uno de estos identificadores, en este orden: jobs-container, grnhse_app, polyguard_jobs. Si ninguno está en la página, no se muestra nada y no aparece ningún error.

3c. Dónde colocar la etiqueta de script¶

Coloque la etiqueta de script en cualquier punto posterior al div contenedor, o en cualquier punto si usa defer. El script espera a que la página termine de procesarse antes de buscar el contenedor, así que no puede ejecutarse demasiado pronto. Solo puede llegar tarde si su CMS inserta el contenedor después de cargarse la página; en ese caso, cargue el script después.

El portal ajusta su propio tamaño: informa de su altura a su página a medida que el candidato se mueve entre la lista y un puesto, y el marco crece y se reduce para encajar. No fije una altura al contenedor.

4. Autorice a su sitio a incrustar el portal¶

Este paso es obligatorio y el portal no se mostrará sin él.

Polyguard rechaza ser incrustado por cualquier sitio que no figure en una lista de autorizados. Es una protección contra el phishing: sin ella, un sitio fraudulento podría enmarcar su portal de empleo real y recoger solicitudes al amparo de su marca.

Envíe al soporte de Polyguard el origen completo de cada página que vaya a incrustar el portal y lo añadiremos a su aplicación. Un origen es el esquema y el dominio, sin ninguna ruta, y siempre con https:

https://www.example.com
https://example.com
https://staging.example.com

Tres detalles importantes:

• Solo https. Una página servida por http no puede incrustar el portal.
• Un comodín no cubre el dominio sin subdominio. https://*.example.com coincide con www.example.com pero no con example.com. Envíe ambos si usa ambos.
• Incluya los dominios de pruebas, de vista previa y los entornos de su agencia si quiere probar allí. Las URL de vista previa que cambian en cada despliegue necesitan la forma con comodín.

Puede consultar la lista actual en la Consola, en Settings → PreScreen → Embedding sites. Los administradores de la cuenta pueden verla; solo el personal de Polyguard puede modificarla, y el cambio surte efecto en el siguiente despliegue de su sitio, no de inmediato.

5. Enlaces directos y URL que se pueden compartir¶

El portal se ejecuta dentro de un marco, así que la barra de direcciones no cambiaría al navegar. El script mantiene sincronizada la URL de su página, de modo que los candidatos pueden copiar el enlace de un puesto y este se abre en ese puesto.

Ambos se leen al cargar la página, así que un enlace compartido o guardado en marcadores vuelve a abrir la misma vista. gh_jid es el mismo parámetro que usa Greenhouse, de modo que los enlaces que ya haya publicado, en anuncios de empleo o en redes sociales, siguen funcionando tras cambiar el script.

Si su página usa su propio enrutado o reescribe la cadena de consulta, asegúrese de que conserva los parámetros que no reconoce; de lo contrario, estos enlaces perderán el puesto.

6. Haga que el portal cargue más rápido¶

Añada una indicación de preconexión a la cabecera <head> de su página de empleo, por encima de la etiqueta de script:

<link rel="preconnect" href="https://careers.example.com" crossorigin>

El script no puede abrir su conexión con el portal hasta que su página haya procesado la etiqueta, la haya ejecutado y haya añadido el marco. La indicación adelanta la resolución DNS, el saludo TCP y la negociación TLS para que se solapen con el resto de la carga de la página, lo que suele ahorrar una ida y vuelta de red, y más en conexiones móviles.

Use el mismo origen que el src del script. El atributo crossorigin es obligatorio: el portal es un documento de otro origen, y una preconexión sin ese atributo abre una conexión que el marco no puede reutilizar.

7. Estilos¶

El portal hereda los colores, las tipografías y el logotipo configurados para su aplicación PreScreen en la Consola, en Settings → PreScreen, así que coincide con su sitio de empleo alojado desde el principio. Omite deliberadamente la cabecera y el pie del sitio, porque su propia página ya los aporta.

Dos ajustes que quizá quiera hacer, ambos gestionados por el soporte de Polyguard:

Si su página de empleo tiene una cabecera fija, indíqueselo al soporte: existe un ajuste en la URL de carga que reserva espacio para ella cuando el portal desplaza un diálogo hasta la vista. Se añade como &offset=120 (la altura de su cabecera en píxeles) en el src del script.

Enviar a los candidatos a la página alojada¶

De forma predeterminada, el candidato que pulsa un puesto permanece dentro del marco. También puede hacer que cada puesto abra su página de empleo alojada por Polyguard como página completa, algo recomendable si su página de empleo es estrecha o tiene muchos estilos. Pida al soporte que cambie los enlaces de los puestos del portal incrustado a la página alojada. El enlace "Todas las vacantes" de la página alojada devolverá entonces al candidato a su página de empleo.

8. Resolución de problemas¶

Cuando informe de un problema al soporte, incluya la URL de la página, el src del script tal y como aparece en su HTML y los errores que muestre la consola de desarrollo de su navegador.

9. Soporte¶

• Correo: [email protected]
• Consola: console.polyguard.ai
• Configuración del ATS: Greenhouse, Lever, Workable
• Envío de correos de Trust Check desde su dominio: Envío desde su dominio