Unique Identifier

Ayesha Akhtar
Ayesha Akhtar
  • Updated

Feature Snapshot

Summary:
The Unique Identifier is a feature that lead generators can take advantage of to add information to TrustedForm Certificates that help identify the user who is generated a lead(s). This is particularly useful when multiple certificates are being generated for the user so that their relationship can be expressed by having them all share the same unique identifier.

Key Benefits:

  • Helps group multiple certificates generated across different pages/offers.

Typical Use Cases:

  • Linking consumer interactions on multi‑page forms.
  • Explaining the need for multiple certificates to be used as evidence during litigation.

How the Unique Identifier works

When a visitor reaches a webpage with the TrustedForm Certify Web SDK installed, the site generates a Unique Identifier—often a GUID, UUID, or session ID—that is passed to TrustedForm during initialization. This value is then embedded within the certificate under the Publisher Provided Data section. By comparing these identifiers across different certificates, lead generators/buyers can confirm that multiple certificates belong together as part of a single consumer session.


Step‑by‑Step Instructions

  1. Generate the Identifier:
    Implement custom logic on your website to generate a Unique Identifier for each user session using robust methods such as GUID or UUID.

  2. Pass the Identifier to TrustedForm:
    Modify your TrustedForm Certify integration to include the generated Unique Identifier as noted in the Certify implentation guide. Ensure this value is assigned before the TrustedForm script executes so it is captured in the certificate.

  3. Deploy the Updated Script:
    Publish your updated webpage with the modified script that passes the Unique Identifier along with the standard data collection.

  4. Verify the Identifier in Certificates:
    Submit a test form and check the resulting TrustedForm certificate. Scroll down to the Publisher Provided Data section to confirm that the Unique Identifier is displayed as expected.

Expected Result:
The TrustedForm certificate will show a new field in the Publisher Provided Data section that displays the Unique Identifier, linking all certificates generated within the same user session.


Validation & Monitoring (optional)

  • Test the Setup: Submit a test lead from your website and confirm that the certificate includes the Unique Identifier.

Best Practices

  • Generate a truly unique value using GUID or UUID algorithms.
  • Assign the Unique Identifier before the TrustedForm script loads to avoid missing data.
  • Consistently propagate the same identifier throughout multi‑page forms to ensure accurate linking.
  • Internally log the Unique Identifier for cross‑verification with your lead records.

Troubleshooting

Symptom / Error Likely Cause Resolution
Unique Identifier missing on certificate Identifier not set before TrustedForm script initialization Ensure that your site’s logic generates and injects the Unique Identifier prior to script load
Inconsistent Identifier values across certificates New identifier generated on each page load during the same session Propagate the same Unique Identifier throughout the entire user session
Malformed Identifier displayed Generation method producing incorrectly formatted value Validate your GUID/UUID generation logic and adjust formatting to meet standard identifier formats

Frequently Asked Questions (FAQ)

Q: What is a Unique Identifier?
A: It is a dynamically generated value assigned per user session that links multiple TrustedForm certificates together into a single comprehensive lead record.

Q: Why is the Unique Identifier important?
A: It enables you to correlate multiple certificates from a consumer’s journey, ensuring complete lead tracking, enhanced compliance, and improved fraud detection.

Q: How do I add a Unique Identifier to my certificates?
A: Implement a method on your website to generate a Unique Identifier before loading the TrustedForm script, and then pass this value via your TrustedForm Certify integration so that it is embedded in the certificate’s Publisher Provided Data section.

Q: What format should the Unique Identifier be in?
A: It is recommended to use GUIDs or UUIDs for consistent, robust, and unambiguous identification across all certificates.


Glossary

Term Definition
Unique Identifier A dynamic value generated per user session that links multiple TrustedForm certificates together into one complete lead record.
Publisher Provided Data The section of a TrustedForm certificate where custom data—such as a Unique Identifier—is embedded by the publisher.

Was this article helpful?

0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.