Knowledge Base

How do I cookie sync with Narrative?


Cookies are used to create a semi-persistent identifier for a particular computer's browser. Web browsers enforce a rule that a cookie that is set by a domain (ex: can only be read within that same domain. This rule means that different companies typically have different cookie-based identifiers.

To share identifiers that live in their own namespaces, we leverage cookie syncing, by passing the IDs as query parameters to create a shared understanding.

Currently, Narrative only supports partners initiating the sync with us.

Partner Initiated Syncs

For partners who are initiating the sync with Narrative the following endpoint and query parameters can be used:



Query Parameters



companyId: (Required) A unique ID assigned to the partner by Narrative

id: (Required) Type and Value of the identifier formatted as partner_id_type:partner_id_value. For cookies, the partner_id_type will be assigned to the partner by Narrative

red: (Optional) If the partner would like Narrative to redirect back to the partner with the Narrative ID a properly encoded URL can be used


BrandA would like to initiate a cookie sync with Narrative.

  • companyID: 789
  • customerID is [123456789]

Pixel before:[[XXX]]

Pixel after:[[123456789]]


${}: On the redirect parameter this macro will be replaced with the Narrative cookie identifier.

Example URL


< Back

Hi! I’m Rosetta, your big data assistant. Ask me anything! If you want to talk to one of our wonderful human team members, let me know! I can schedule a call for you.