Overview
Data mapping is for teams that send respondents to Surveys through their own links (email merge fields, CRM templates, printed QR with hand-built URLs, and similar). Each mapping defines:
A friendly name so you can pick it in Survey builder (General tab)
Contact field parameters — query keys that fill first name, last name, email, or custom fields you add
Location parameter — the query key that selects which GiveMe5 location the response belongs to, using external values you map to each location
What you can do here:
Create or edit mappings from Surveys → Data mapping
Match URL keys to internal field names — so
fn,email, or your own keys line up withfirstname,email, etc.Map external location codes — e.g.
store=westin the URL ties to the correct GiveMe5 location rowPreview the URL — the editor shows a sample pattern using your current Survey host (default or verified custom domain)
Open Data mapping from the main Surveys list (same screen as Create survey).
How a mapped URL is structured
The public survey path is always:
https:// your survey host / account segment / survey slug
Optional query parameters follow, driven by your mapping:
One parameter per contact field you configure (for example
fn={{firstname}}in the preview indicates the real URL will substitute encoded values)One location parameter (default key often
loc, customizable) whose values you map in a table from external value → GiveMe5 location
Preview text uses placeholders such as {{firstname}} to show which internal field each query key feeds.
Default contact fields
New mappings often start with three rows (you can add or remove fields):
URL parameter (example) | Internal field |
|
|
|
|
|
|
You can add more rows for other URL parameter names and internal field names your integration uses.
Merge tags and email preview
For Automations Campaign Links pointing at Survey, the system sends customers to your survey; when you need pre-filled identity or location in the query string, configure Data mapping on the survey and use the documented parameter names in your outbound links.
Related topics
Survey builder — attach a mapping on the General tab
Custom Survey domain — optional branded host for survey links