Skip to content
knowledge-base-2

Linking Users

Accurate attribution requires connecting user activity across logged-out and logged-in states. Topsort provides API tools to solve this issue, enabling you to link two opaque user IDs.

How it Works

Users often interact with ads while logged out (e.g., user_id = 123) and later, they log in, gaining a distinct user ID (e.g., user_id = 456). Without linking these IDs, activities from the logged-out session are disconnected from post-login actions, leading to inaccurate attribution.

Our Link Users API enables you to inform Topsort that two opaque user IDs belong to the same person. Improving attribution accuracy. Required fields to use our API:

Field

Type

Required

Description

from

string

yes

The original (e.g., logged-out) opaque user ID. (1-64 chars)

to

string

yes

The target (e.g., logged-in) opaque user ID. (1-64 chars)

Note: from and to IDs must not be identical.