Paramètres de l'API Job Search : bonnes pratiques (v3)

Configurer l'API

Facteurs qui influencent les résultats de recherche

L'association de "Sélection d'emplois", "Activer l'élargissement" et "Désactiver la correspondance des mots clés" influe de manière significative sur le nombre et la pertinence des offres renvoyées au demandeur d'emploi. La configuration la plus appropriée de ces trois facteurs dépend des besoins de votre entreprise. La meilleure méthode pour déterminer la configuration vous convenant le mieux consiste à appliquer différents scénarios de test et à évaluer les résultats au cours d'une phase de test.

Sélection d'emplois : vous pouvez utiliser la sélection d'emplois pour attribuer des valeurs promotionnelles à des emplois individuels, ce qui vous permet de mettre en évidence les offres importantes pour vos besoins. Consultez la documentation sur la sélection d'emplois pour connaître les bonnes pratiques et les détails de mise en œuvre.
disableKeywordMatch : ce paramètre permet à l'API de renvoyer des correspondances de mots clés en plus des résultats pertinents déterminés par l'algorithme de ML. Le paramètre par défaut est false. Si vous conservez le paramètre par défaut, l'API Job Search de CTS renvoie les offres qui n'ont pas été renvoyées comme étant pertinentes par l'algorithme de ML, mais dont le titre ou la description contiennent une correspondance de mot clé avec la chaîne de requête du demandeur d'emploi. Si vous définissez ce paramètre sur true, la correspondance des mots clés est désactivée. Par conséquent, moins d'offres d'emploi (uniquement celles jugées pertinentes par la fonctionnalité de ML) sont renvoyées.
enableBroadening : ce paramètre vous permet de développer la requête du demandeur d'emploi en assouplissant les restrictions qu'il indique concernant la localisation et les catégories d'emploi. Il est défini sur false par défaut et activé lorsqu'il est défini sur true. Il est utilisé pour augmenter le nombre de résultats de recherche renvoyés.

Résultats de la configuration de recherche

Pour ne renvoyer que les offres d'emploi les plus pertinentes, définissez disableKeywordMatch sur true et enableBroadening sur false. Cela améliore les métriques de performance de l'API liées à la pertinence de la recherche, puisque seules les offres d'emploi pertinentes sont renvoyées. Toutefois, dans l'ensemble, moins d'offres sont renvoyées dans les résultats de la recherche.

Pour renvoyer un nombre plus élevé d’offres d'emploi, y compris des résultats pertinents et des correspondances de mots clés, définissez disableKeywordMatch sur false et enableBroadening sur false. Les résultats de correspondances de mots clés sont répertoriés après les offres d'emploi pertinentes dans les résultats, mais les résultats de l'extension de la requête ne sont pas renvoyés.

Pour renvoyer un nombre plus élevé d'offres d'emploi, y compris les offres pertinentes et celles de l'extension de la requête, définissez disableKeywordMatch sur true et enableBroadening sur true. La requête du demandeur d'emploi est élargie pour inclure les catégories d'emploi associées et les zones géographiques proches, répertoriées après les résultats correspondants. Les correspondances de mots clés ne sont pas renvoyées.

Pour renvoyer le plus grand nombre possible d'offres d'emploi, définissez disableKeywordMatch sur false et enableBroadening sur true. L'API Job Search renvoie les offres les plus pertinentes en haut des résultats de la recherche, suivis par les offres contenant des correspondances de mots clés et des extensions de requêtes (par localisation, par catégorie d'emploi, et autres). Cela maximise le nombre total d'offres d'emploi renvoyées.

diasableKeywordMatch	enableBroadening	Résultat
-	-	Renvoie un nombre plus élevé d'offres d'emploi, y compris les résultats pertinents et les correspondances de mots clés (mais en supposant que les offres présentées ont la valeur 'false').
+	+	Renvoie un nombre plus élevé d'offres d'emploi, y compris les offres pertinentes et celles de l'extension de la requête (mais en supposant que les offres présentées ont la valeur 'false').
-	+	Renvoie le nombre le plus élevé d'offres d'emploi (en supposant que la sélection d'emplois est définie sur 'false').
+	-	Renvoie uniquement les offres d'emploi les plus pertinentes (en supposant que la sélection d'emplois est définie sur 'false').

`Request.page_size`

Pour optimiser les performances et éviter la latence, configurez la page des résultats de manière à afficher un maximum de 20 offres d'emploi à la fois.

`customAttributes`

customAttributes vous permet d'attribuer des valeurs supplémentaires à vos offres d'emploi en fonction de vos besoins professionnels (par exemple, des scores GPA) et d'utiliser ces valeurs pour filtrer les résultats.

Champ de localisation géographique

Vous trouverez un aperçu détaillé du champ associé à la localisation dans la section Champs de localisation géographique. En saisissant l'adresse postale de l'offre d'emploi au lieu des coordonnées GPS dans le champ d'adresse, vous permettez à l'API d'améliorer la détection de la localisation et la pertinence de la recherche.

`locationFilter`

Utilisez le code regionCode si une seule entreprise propose plusieurs postes vacants situés dans différentes régions géographiques. L'attribution d'un code regionCode à chaque fiche de poste garantit qu'une requête de recherche renvoie des offres d'emploi uniquement dans la localisation indiquée par le demandeur d'emploi, plutôt que dans les résultats globaux de cette entreprise. Par exemple, une recherche avec le mot clé "Cambridge" sans regionCode renvoie les résultats de Cambridge au Royaume-Uni et de Cambridge (Massachusetts) aux États-Unis. L'omission de ce code diminue donc la pertinence de la recherche.

`Region_code` et `Language_code`

Définissez request.filters.location_filters.region_code de façon à correspondre à la zone géographique recherchée par l'utilisateur (comme le Royaume-Uni). Définissez request.filters.language_code sur le code de langue approprié pour cette région (en_GB dans ce cas) afin que l'API puisse utiliser une logique de recherche localisée (par exemple, "chauffeur de camion" dans en_GB par opposition à "chauffeur de camion" aux États-Unis).

`radiusinMiles`

Ce paramètre définit un rayon (en miles) autour de la localisation indiquée par le demandeur d'emploi. L'API renvoie les résultats appartenant à cette zone géographique. L'application de cette distance à la zone géographique des résultats de la recherche dépend du type d'informations de localisation saisies. Si le demandeur d'emploi saisit une adresse postale, la distance radiusInMiles est définie à partir d'un point unique. Si le demandeur d'emploi saisit une ville, l'API applique un cadre de sélection autour des limites de la ville et calcule la distance depuis les bords du cadre défini. Si l'utilisateur ne saisit qu'un État ou un pays, le paramètre radiusInMilesest ignoré.

Assurez-vous que le rayon de distance est le plus petit possible. Si vous définissez la distance sur une plage plus large, la recherche renvoie des résultats pouvant se situer en dehors de la localisation souhaitée par le demandeur d'emploi, ce qui diminue la pertinence de sa requête. Par exemple, si vous recherchez des offres d'emploi à New York avec le paramètre radiusInMiles défini sur 100 miles, vous obtenez des résultats à la fois dans le nord de l'État de New York et dans le New Jersey. Si vous indiquez un rayon le plus petit possible, vous augmentez la pertinence des résultats.

`postingExpireTime`

Ce paramètre définit la durée pendant laquelle une offre d'emploi est active avant sa suppression des résultats de la recherche. La valeur par défaut est 30 jours après l'heure de création de l'offre dans le fuseau horaire UTC.

`Job_employment_type`

Ce champ n'est pas obligatoire. Toutefois, l'utilisation de Job_employment_type augmente la pertinence des résultats de la recherche d'emploi.

Configurer l'API : classement personnalisé

La recherche de sélection d'emplois vous permet d'influencer les résultats de recherche d'un utilisateur en mettant en évidence les emplois en fonction d'une seule variable (promotionValue). Pour plus d'informations, consultez la documentation sur la recherche de sélection d'emplois. Le classement personnalisé vous permet d'influencer les résultats en fonction de plusieurs variables, offrant ainsi un meilleur contrôle sur les classements, quelle que soit leur pertinence. Cette fonctionnalité est très utile pour les applications nécessitant un équilibre entre la pertinence et les intérêts économiques, telles qu'un système d'abonnement à CPC (coût par clic) multiniveaux. L'influence sur le classement des offres d'emploi en plus du score de pertinence d'origine est basée sur deux variables : rankingExpression et importanceLevel.

rankingExpression: cette variable contrôle le classement des offres d'emploi en fonction de leurs scores de pertinence existants (tels que déterminés par l'algorithme de l'API). "rankingExpression" doit être défini sur "filterable" pour que l'API puisse indexer le paramètre.
importanceLevel : ce paramètre définit le niveau d'importance du classement d'une offre d'emploi lorsque celle-ci est renvoyée dans les résultats de recherche. Six niveaux possibles sont proposés : non spécifié, NONE, LOW, MID, HIGH et EXTREME. Si vous définissez la valeur de ce paramètre sur EXTREME, tous les autres facteurs de pertinence générés par l'API seront ignorés. Utilisez donc cette valeur avec modération. Les offres d'emploi définies sur EXTREME sont renvoyées en haut de la requête du demandeur d'emploi, en lieu et place des offres les plus pertinentes.
Sélection d'emplois et Classement personnalisé : la sélection d'emplois est particulièrement utile pour promouvoir une seule catégorie d'offres d'emploi (par exemple, des offres dans une entreprise donnée) au-dessus du classement en fonction de la pertinence. Si vous devez classer les offres d'emploi en fonction de variables de CPC (coût par clic) multiniveaux en plus du classement en fonction de la pertinence, le classement personnalisé constitue un meilleur choix.

Recherche basée sur le temps de trajet

Une recherche basée sur le temps de trajet permet aux demandeurs d'emploi de rechercher des offres en fonction du temps de trajet souhaité. Pour activer cette fonctionnalité, vous devez inclure un objet CommuteFilter supplémentaire dans le champ JobQuery.commuteFilter. Cet objet permet au demandeur d'emploi de sélectionner commuteMethod, travelDuration et startCoordinates. Le demandeur d'emploi peut également sélectionner des options telles que roadTraffic (TRAFFIC_FREE ou BUSY_HOUR) et departureTime lors du calcul du temps de trajet. Pour en savoir plus, consultez la page sur la mise en œuvre et le guide d'utilisation de ce type de recherche.

Gestion des données et traitement des erreurs

Intégrité des données

Importer des offres d'emploi : certains problèmes liés aux données peuvent empêcher l'importation d'offres d'emploi dans l'API. Pour en savoir plus, consultez la page Codes de réponse HTTP. Voici quelques exemples courants :
- La localisation des offres d'emploi étant incorrecte, la requête ne peut pas être résolue.
- Les champs "Entreprise" ou "Offre d'emploi" n'existent pas, ce qui renvoie une requête erronée.
Il existe trois options principales pour résoudre les problèmes d'importation d'offres d'emploi :
- Vérifiez la journalisation depuis votre backend.
- Vérifiez l'outil de gestion CTS pour l'enregistrement des données.
- Configurez l'outil Stackdriver Monitoring sur la console Cloud pour collecter des métadonnées, des métriques et des événements.
Indexer des offres d'emploi : l'API Job Search est conçue pour indexer toutes vos offres importées sur une période donnée. Vous pouvez toutefois être soumis à des restrictions en matière de quota. Vérifiez que votre système ne contient pas de restrictions sur les requêtes d'indexation avant d'envoyer des offres d'emploi à CTS.

Mécanismes de traitement des erreurs

Le traitement des erreurs est essentiel pour éviter une attaque par déni de service distribué (DDoS) auto-infligée, qui entraîne l'exclusion des demandeurs d'emploi. Les services API fournis via Internet peuvent également rencontrer des problèmes de connexion intermittente, d'interruption prolongée, de maintenance soudaine des services, et d'autres événements nécessitant qu'une application cliente relance la requête API. Cette nouvelle tentative doit être conçue avec un comportement adapté au réseau, comme un intervalle exponentiel entre les tentatives.

Élimination des doublons

L'expérience du demandeur d'emploi peut être affectée par la présence de doublons dans les offres d'emploi proposées. L'API Job Search comprend deux fonctionnalités permettant de réduire les doublons :

Créer des offres : si vous essayez de créer deux offres d'emploi ou plus avec certains critères identiques, l'enregistrement est rejeté et vous rencontrez une erreur 4xx. Les critères concernés sont les suivants :
- même companyName, ET
- même job_req_id, ET
- même lieu/languageCode
Rechercher des offres d'emploi : l'API Job Search CTS affiche les offres pertinentes pour la requête de recherche du demandeur d'emploi. L'algorithme de pertinence inclut une fonctionnalité intégrée, qui permet de diversifier les offres d'emploi renvoyées, en évitant que des offres presque identiques ne s'affichent les unes à côté des autres dans les résultats de recherche.