Skip to main content

Personalization (PID)

Understanding PID and User Tracking​

What is PID?​

PID is a parameter that can only be used with Talroo's API. It exists in search URLs:

api.jobs2careers.com/api/search.php?id=9999&pass=ABCDEF&ip=X&q=X&l=X&pid=1234

Talroo's job recommendation system uses personalization to provide more relevant job matches. Publishers can enhance personalization by using the pid (Private ID, non-PII) parameter in the Search API call. Adding personalization will unlock higher quality search and long-term revenue.

Important

The previous personalization parameter, uid, has been deprecated. Switch over to pid for best results.

How Publishers Can Enable Personalization​

Publishers can pass their own user identifiers through the (non-PII) pid parameter in Search. This helps Talroo personalize job recommendations for users.

Best Practices for Publishers​

PID Granularity​

  • Use the same pid for returning users
  • Ensure each user has a unique pid value
  • It should not be a single site ID or change with each query
  • It should uniquely identify a user for personalization

PID Guidelines​

Use a unique and secure, non-PII identifier, like a salted hash of their internal account ID.

Example:

sha256(<salt> + <account_id>) = sha256("hello_world_1234567890")
Privacy Notice

Avoid email hashes: These are considered personally identifiable information (PII) and should not be used.