What is field mapping?
Field mapping is the process of matching the fields of your Getsitecontrol widget to the corresponding fields of the third party service the widget is integrated with. When new data is collected through the widget, Getsitecontrol will send the data to the mapped fields in your integration.
Apart from the data collected directly through the widget, you can also choose to include other custom parameters, such as user's location, and map those to target fields of your choice.
Setting up field mapping
You’ll be asked to map the widget fields when setting up an integration on the Integrations tab.
Once you choose the necessary third party app and select a mailing list from the drop-down menu, click the Map widget fields… button to start mapping fields.
On the left you’ll see the list of fields that Getsitecontrol can export. And on the right you’ll find the list of fields that your integrated service can import.
Some of the fields may be matched up automatically.
Required fields in the integrated service are marked with an asterisk. These fields must be filled out. If they are not, the integration will not work correctly and your subscribers’ data won’t be passed to the list in your app.
Tip: if you don't want Getsitecontrol to fill in these fields, you can set them to be optional instead of required in your third party service settings.
There are four types of fields you can choose to pass to your integration service:
JS API field
Form fields are the actual fields of your widget that get filled in by website visitors, e.g. “Email”, “Name”, “Message”. You can choose which field in your form corresponds to which field in your integrated service.
System fields include additional details about your website visitors that are collected when they submit a reply through your widget, e.g. “Country”, “OS”, “Browser”, “Language”.
If you want to send some of these details to your integration, make sure you match them up to the necessary fields in the integrated app.
JS API fields
You can use Getsitecontrol widget API to pass additional details about your website visitors when they submit a reply. Check this page for instructions on how to pass additional properties about website visitors.
This is an advanced feature that requires some programming knowledge. Please note that we are unable to provide support for creating or troubleshooting custom code.
Here you can add any text value you want to be sent to a certain field in your integrated app. This value will be passed along all submissions made via this particular widget.
To add contacts collected with the widget to a particular group you need to choose any option from the drop-down list. It doesn't matter which one you choose. If the field is empty, contacts will not be added to the group. If the field is not empty, contacts will be added to the group.
Field mapping for Google Sheets
Field mapping works a bit differently for the integration with Google Sheets.
On the left you’ll see the list of fields that Getsitecontrol can export, as usual. And on the right you’ll find the list of columns that will be added to your Google spreadsheet once you set up the integration.
You can change the names of the columns on the right and add new fields to pass some extra details. The data submitted through the form will be added in the new rows in a specific spreadsheet.
Field mapping for Webhooks
When setting up Webhooks, you’ll also need to map the widget fields. The ones on the left are the fields that Getsitecontrol can export. The ones on the right are the key values in the POST requests.
You can change the names of these columns and add new fields to pass some extra details.