Log consent on your existing forms

Triggerbee logs and stores consent information on each contact when they convert through our Widgets. This article will take you through how to log it when a user submits an existing form on your website.

Note: If you haven't already, read this guide on how to add a checkbox and a policy link on your existing forms.

Consent events

If you want to log Consent from your own forms to Triggerbee, you need to use the javascript method mtr_consent.logConsent();

You can use the following events to send Consent information to Triggerbee:

Consent information	Description	Js Variable	Example
Context Title	The title of the form or the page where the form was submitted	`contextTitle`	Forms: "Checkout form" "Contact form" "Widget 20% off" Page titles: "About us" "Acme Inc - A better way to do business" "Acme Inc - Contact us"
Consent Text	The text that the user agrees with and consents to	`consentText`	"I consent to receive email communication and understand that my personal data will be handled in accordance with the privacy policy"

Logging consent on a form submission

The following command sends an event to Triggerbee indicating that the user ticked the Consent checkbox:

window.mtr_consent.logConsent(contextTitle, consentText);

You can rename your variable for the Title or Text, but the order of appearance is important. The first parameter consentTitle logs the Title of the form or page, and the second parameter consentText logs the text that the user leaves their consent to.

Note: If you already use mtr.goal() to log a goal when the form is submitted, it's not necessary to send the Consent information to Triggerbee separately.

To stop the Consent data to be sent to Triggerbee separately, you can add a false parameter to the variable
var sendEventToTracker = false; window.mtr_consent.logConsent (contextTitle, consentText, sendEventToTracker);

Example: How to log consent when a form is submitted

This is how you would log Consent when a form is submitted on your website. The privacy policy version of the given Consent is set automatically to the privacy policy version currently published on the website.

// Get the page title and store it in a variable
// Recommended way is to get the form name
var contextTitle = window.document.title;

// Find the consent checkbox label
 var consentTextIdentifier = 'label[for="consent"]';

// Store the label text in a variable
 var consentText = document.querySelector(consentTextIdentifier).innerText;

// Do not send the consent data to the tracker separately
// The mtr.goal() event makes sure the data gets sent
var sendToTracker = false;

// Add your consent data on the contact in Triggerbee
 window.mtr_consent.logConsent(contextTitle, consentText, sendToTracker);

Note: Before making this call you must first log the email address of the user, see instructions here.