Salsa Engage allows you to pass in field data via a query string so that you can pre-populate info on your forms. Here's how it works:
- Identify the parameters you wish to pass into the form fields
- Append those variables to your activity address
- Share the full address on your website or other channels
Default Parameter Names and Variables
Each form field on a Salsa Engage Activity page has a parameter name (this includes custom fields).
Below is a list of our default fields you can pass in a query string to pre-populate the fields on the forms. The variables are in italics:
|Address Line 1||address-line1|
|Address Line 2||address-line2|
|Set the donation as recurring?||recurring (value of yes)|
|Opt-in Status for emails||receive-updates (value of yes)|
For Custom Fields, the variable will always start with scf and then the field name. You can access the parameter value by clicking on that field in your activity form:
Write the URL
The format of the Salsa activity form is standard for any query string, just like UTM parameters for Google Analytics.
For example, the default activity link would look like https://subdomain.salsalabs.org/donatenow/index.html.
When using the parameters above, you could populate the name, email and donation amount by setting it up as...
*If your donation form does not have a button for $10, this would be populated directly into the Other amount field. If you do not have the Other amount box, none of those options will populate with a choice.
This string uses the following symbols:
|?||Use the question mark only after the URL. It indicates that what follows is a query string.|
Use the "equals" sign to indicate with what the field for the parameter that you enter should be populated.
|&||Use the ampersand to concatenate multiple parameters/value combinations.|
Manually Add Tracking Codes to a URL
Salsa Engage also enables you to add a Salsa Tracking Code parameter to your URLs manually. For instance, you are adding your URL to an online ad and want to measure ROI from that activity. You'll be able to see and compare "Views" and "Conversions" metrics in your activity results to measure which code is performing the best for that activity.
To use a Salsa Tracking Code, simply add the following field-value pair to your URL query string:
A URL with a tracking code would look like this:
You can query for these codes on specific activity forms in Engage. Use the Salsa Tracking Code option by going to Supporters > Query > Create a new query.
Salsa Tracking Code data is also available in activity and transaction CSV export files in the "Salsa Track" column.
Add Default Tracking Codes to Activities
Please see this article for more information on adding a default tracking code on an Activity for identifying the source of a transaction or supporter if you do not pass the code into your form.