Our initial release of the HubSpot Forms based integration is fairly simple and leverages the un-authenticated features of HubSpots API and it's built in forms.
For anyone desiring technical insight, we are using this method to send data over to HubSpot. The beauty with this approach is it's very simple to get up and running. To get started, log into your RaiseDonors account -> Admin area -> integrations tab. Then click "setup" for HubSpot Forms.
Enable the integration.
Provide your Portal ID from HubSpot. You can locate the portal ID by logging into HubSpot and looking at the top right of your screen.
Provide a default Form GUID, which can be found here. This is your default form to send data from RaiseDonors into HubSpot. You can customize this per page using RaiseDonors' page builder.
Provide your Tracking Code, which can be found here. This script will be included on each of your donation pages at RaiseDonors.
You're finished completing the integration of all the donation pages in RaiseDonors into HubSpot!
You can go into any page editor in RaiseDonors and provide a specific Form Guid from Hubspot. This allows greater control and flexibility to target a specific HubSpot form from individual pages in RaiseDonors.
We currently use the following naming convention for the Form Field Names. The following Hubspot form field names are specified in RaiseDonors and not adjustable. If your custom form in HubSpot has different form field names, consider these two options:
- Rename the form field names in your HubSpot form to align with the form field names documented below.
- Leverage the customized approach to add your HubSpot form field names and/or additional form field names not present in the list below.
|HubSpot form field name||RaiseDonors data field name|
|donation_page_url||Donation.Url (clean/landing url)|
|Donation.RawUrl (unmodified url when landing on donation page, with all parameters)|
|If a product is included|
|Always included - Hubspot's optional properties (custom fields not needed)|
|pageUrl||Donation.Url (clean/landing url)|
|Want to add more? You can!
Regarding the hutk field being sent to HubSpot, it must be present in the users cookie collection before arriving on a Raisedonors donation form. The hutk field is a cookie that HubSpot creates for lead activity tracking. Generally this comes from a landing page in HubSpot. When that cookie is present in the donors browser, RaiseDonors will search for that cookie ('hubspotutk') and then send it along to HubSpot as part of the integration. If that cookie doesn't exist, the hutk field is not sent to HubSpot.
Future ideas include...
- Leveraging the API to pull back form names, so that you do not need to retrieve the Form GUID.