User identification

Turn anonymous visitors into persistent and searchable profiles.

Profiles let you track users with a stable identifier and provide several advantages:

• Cross-device continuity when the same user is identified again
• Searchable visitor records in the dashboard
• Better attribution from anonymous traffic to known accounts

How to identify a user

Use the window.flowsery() method:

window.flowsery('identify', {
  userId: 'user_123',
  name: 'John Wayne',
  image: 'https://example.com/avatar.jpg',
  profileData: {
    email: 'john@example.com',
    role: 'admin',
    plan: 'pro',
  },
});

Current contract

• userId is required
• name is optional
• image is optional
• Custom fields belong inside profileData

Reliable loading

If identify calls can fire before the main tracker script loads, place the queue shim in your document head:

<script id="flowsery-queue">
  window.flowsery =
    window.flowsery ||
    function () {
      window.flowsery.q = window.flowsery.q || [];
      window.flowsery.q.push(arguments);
    };
</script>

Notes

• Identify links a known user to the visitor profile. It does not replace custom goals.
• If revenue attribution is enabled, connected payment-provider flows can also enrich customer identity when matching data is available.