Query Parameters

How to provide lead enrichment data to Spara.

Including lead enrichment data as query parameters ensures a better buying experience and higher conversion metrics. This applies to any deployment scenario. By supplying Spara with this information you ensure that Spara will a) not attempt to recapture this data, and b) may modify its behavior to better suit each conversation.

Step 1: Add query parameters to URLs

Add query parameters to the URL of any webpage that loads a Spara interface.

For example, let's say that ACME's sales journey is...

  • Leads submit a webform at acme.com/form. This form includes fields for first name and email address.

  • Upon form submission, the lead is redirected to acme.com/chat, which loads the Spara Fullscreen interface.

The correct way to handle this redirect is by including URL-encoded query parameters for form fields first name and email address:

https://acme.com/chat?FirstName=John&Email=john%40company.com

Spara Fullscreen is then loaded already knowing the lead's first name and email address.

Step 2: Map query parameters

Spara automatically maps the standard marketing UTM parameters to Spara fields:

  • utm_campaign

  • utm_source

  • utm_medium

  • utm_campaign

  • utm_term

  • utm_content

All other query parameters must be mapped to Spara fields. This is how Spara knows which query parameters are relevant and what they mean.

To map query parameters, go to your Integrations page. Add new mappings by clicking the "Add Field +" button.

How do Spara fields work?

Some notes on how Spara fields, aka mapped query parameters, work:

  • Fields are persisted across all user sessions.

  • Each field may only have a single value.

  • Any field may be overwritten at any time. Fields are never deleted or overwritten by null or none.

For example, consider the following scenario in which Spara is loaded on every acme.com webpage:

  • Anonymous Lead 123 visits acme.com?utm_campaign=twitter and talks to Spara. Throughout the conversation, Lead 123 navigates to multiple acme.com webpages.

  • 24 hours later….Anonymous Lead 123 visits acme.com/pricing?utm_source=google. They do not talk to Spara.

  • 6 days later…Anonymous Lead 123 visits acme.com?utm_campaign=linkedin. They talk to Spara.

After all three sessions, Anonymous Lead 123 has the following fields set in Spara's database:

  • utm_campaign=linkedin

  • utm_source=google

Note that utm_campaign=twitter was set in at the start of the first session, but then overwritten to utm_campgin=linkedin by the third session.

Last updated