Advanced Settings & Cross Submit

Add Google Analytics to Public Forms 

SAM Leads can add Google Analytics tags to SAM's Public Forms to track traffic.

There are two ways to add Google Analytics to your forms: 

1. Add Google Analytics tag to the Text Shown at the Top of Form
2. Create a Template and add the Template to the Form 

Cross-Submit (SAM Mini API)

The Cross-Submit functionality allows you to submit data into SAM from another website/system.

It works by re-posting a form's data to a SAM webpage in the background (server-side). This requires a web software developer to setup, but can usually be accomplished within a couple of hours.

By default, the Cross-Submit functionality is disabled, so you must first enable it via the "Forms Security Settings" and then enable it for each form. Then you must "Link Fields" between the two systems. (Please see instructions below.)

The Cross-Submit - Secret Key is an additional level of security for your cross-submit forms. By passing a special secret code along with your data, we can verify that the source is legitimate, to keep out any malicious submits. The default security without a secret key is that the special SAM webpage address has to be known, and by keeping the re-post on the server-side we hide the special SAM webpage address. 

Enable Cross-Submit functionality option (First Time Only)

1. Settings
2. Security Center
3. Forms Security Settings, (sidebar)
4. Edit Settings
5. Set Cross-Submit - Enabled to Yes
6. Set Cross-Submit - Secret Key (optional but highly recommend, see field hint)

Enable Cross-Submit for a Form

1. Open a public form in the Form Customizer 
2. Advanced Options (sidebar)
3. Advanced Form Properties (sidebar)
4. Scroll to the Cross-Submit section
5. Set Cross-Submit - Enabled for this Form to Yes
6. Optional - Set Cross-Submit - Secret Key for this Form - For even higher level of security.

Linking Fields

The names of form fields submitted must match the Field's "DB Column Name" or "Alternate Names" in SAM. You can either rename your form's data, or you can add "Alternate Names" for the fields in SAM. To view a field's "DB Column Name" go to the Field Properties for that Field and click on "View Field Properties" in the Advanced Options, and then look for the "DB Column Name" field.

Add Alternate Names

1. Open the Field Properties for an individual Field 
2. Advanced Options (sidebar)
3. Alternate Names for Cross-Submit
4. Add Field - Alternate Names

URL of the SAM Cross-Submit page

The URL of the SAM Cross-Submit page will be the same as its URL when viewed by pressing "Open Public Form" link, except the last 8 characters, will instead be _xin.ashx

For example, if the normal Public Form File name is Inquiry_Form_Edt.aspx, the Cross-Submit file name will be Inquiry_Form_xin.ashx.

To Test: Open the cross-submit URL in the browser, if it opens to a blank white page, then its correct, but if you get an error message, then it means that something is wrong with your URL.

Additional Notes

POST Method required. (Instead of GET)

Firewall of your webserver should allow port 443 outgoing.

The "Cross-Submit | Secret Key" is entered via Advanced Form Properties or Forms Security Settings and it can be any alpha-numeric text, like X52Cda12Cdfa231. Pass in the Secret Key via a Query String named "key" (without the quotes).