How to Identify Visitors via URL Parameters (UTMs) – Face2Face.io

What Are URL Parameters?

URL parameters are small pieces of data added to the end of a URL to pass information. They start with a question mark (?) and follow this format:

?key=value

To include multiple parameters, separate them with an ampersand (&):

?key1=value1&key2=value2

For example:

https://yourwebsite.com/?f2f-userId=12345&f2f-name=JohnDoe

f2f-userId=12345 assigns a unique ID to the visitor.

f2f-name=JohnDoe sets the visitor’s name as “John Doe.”

How F2F Uses URL Parameters

The F2F SDK automatically detects f2f-[key]=[value] parameters in the URL and associates them with the visitor’s session. This data can be used for identification, segmentation, and triggering workflows.

How to Use F2F Parameters

Build Your URL Add ?f2f-[key]=[value] to any link leading to your website:

https://yourwebsite.com/?f2f-userId=5678

Chain multiple parameters using &:

https://yourwebsite.com/?f2f-userId=5678&f2f-role=admin

Share the URL Use these links in emails, ads, or other campaigns.

Track and Identify Visitors When visitors click the link, the F2F SDK captures the parameters and stores them in their session data.

How to Use Parameters in F2F

Parameters provide flexibility and can enhance your workflows:

As Workflow Filters: Parameters can filter users in your workflows. For example, you can set a workflow to trigger only for users with:

?f2f-role=premiu

View on User Profiles: Captured parameters are visible in the user’s profile in the F2F dashboard. This helps agents understand the visitor’s context.

Send in Notifications: Parameters can be included in notifications sent to Slack, Discord, or a webhook. This allows your team to get real-time context about the visitor.

Modify the Visitor’s Name: Using the f2f-name parameter will replace the default F2F name for the visitor. For example:

https://yourwebsite.com/?f2f-name=JaneDoe

This changes the displayed visitor name to “Jane Doe” in the dashboard and notifications.

Examples of URL Parameters

Identify a Visitor:

https://yourwebsite.com/?f2f-userId=12345

Tracks the visitor with the ID 12345.

Set a Custom Name:

https://yourwebsite.com/?f2f-name=JaneDoe

Displays “Jane Doe” instead of the default name.

Tag a Campaign:

https://yourwebsite.com/?f2f-campaign=summer-sale

Identifies the campaign source.

Combine Parameters:

https://yourwebsite.com/?f2f-userId=789&f2f-role=manager&f2f-campaign=promo2025

Captures the visitor ID, role, and campaign.

Tips for Best Results

Be Consistent: Use clear keys like f2f-userId, f2f-name, and f2f-campaign.

Test First: Verify your URLs to ensure parameters are captured correctly.

Privacy Compliance: Make sure your use of parameters adheres to relevant data protection regulations.

Conclusion

With f2f-[key]=[value], you can identify and personalize visitor experiences. Whether used to modify names, filter workflows, or send detailed notifications, URL parameters make it easy to collect and act on visitor data. Try it today to create seamless, tailored interactions with your users!