LUX LUX

Identification

This part of the documentation describes different possibilities to identify your leads. Identification means that you are able to know the person behind the lead. And this needs a unique identification-property from the lead. E.g. firstname would be - of course - not a good property because this is not unique. Marketing Automation tools are going to use the email-address as unique property of the user. And... emails are great because, you can:

  • identify the lead
  • see the firstname as part of the email address (mostly given in business cases)
  • see the lastname as part of the email address (mostly given in business cases)
  • see the company as part of the email address (mostly given in business cases)
  • having an url (company) where you can simply find more interesting stuff of your lead
  • send marketing relevant information in newsletters

So, if email-addresses are great, and we want to collect the email from our unknown leads - how can we do this? The answer is simple: We have to deal a bit with our visitors. Let them download an interesting asset (e.g. a whitepaper) but ask for their email address first. Another way would be to offer a callback-form where you offer to call the visitor - also ask for the email address here. Is there a form, where the visitor can get access to a software? You guessed it, ask for the email address.

Going back to the technical part - forms will help us on lead identification.

The possibilities to identify a lead in lux:

  • Identify via field mapping configuration (any single form field in TYPO3)
  • Identify via form mapping configuration (any form in TYPO3)
  • Identify via Email4link CKEditor plugin
  • Identify via Frontend login
  • Identify via Luxletter extension

1. Field mapping

The easiest way for an identification is to offer some forms on your website where you listen to the values that your visitors add there. Lux will help you to listen on any webform (no matter if it is powermail, femanager, form, formhandler, felogin or a static html content). The technique behind is simple. You can map field names to lead properties via TypoScript.

The default mapping will e.g. map a field with name tx_powermail_pi1[field][e-mail] to the lead property email (see TypoScript below).

lib.lux.settings {

    # All identification settings
    identification {
        # En- or Disable field and form identification
        _enable = {$plugin.tx_lux.settings.fieldandformidentification}

        # Auto identify with EVERY input field of your website.
        # Disabled for forms with [data-lux-form-identification] and also disabled for fields with [data-lux-disable]
        # Using a * as wildcard will search for a string in a string while using a key without * will search for the exact match.
        fieldMapping {
            # "email" is the key-field for visitor identification and merging.
            email {
                0 = *[email]
                1 = *[e-mail]
                2 = *[e_mail]
            }
            firstname {
                0 = *[firstname]
                1 = *[first-name]
                2 = *[first_name]
                3 = *[firstName]
                4 = *[vorname]
            }
            lastname {
                0 = *[lastname]
                1 = *[last-name]
                2 = *[last_name]
                3 = *[lastName]
                4 = *[surname]
                5 = *[sur-name]
                6 = *[sur_name]
                7 = *[name]
                8 = *[nachname]
            }
            company {
                0 = *[company]
                1 = *[firma]
            }
            phone {
                0 = *[phone]
                1 = *[telefon]
                2 = *[tel]
            }
            username {
                0 = username
                1 = user
                2 = benutzername
                3 = benutze
            }
        }
    }
}
Copied!

Note: Take care that your lib.lux configuration is recognized by lux (see FAQ section how to copy it to plugin.tx_lux_fe)

You can test the field mapping by adding a simple form to your frontend. Open a second browser and fill out the form. As soon as you enter an email and leave the field (on blur), the values are sent asynchronical to Lux. You don't have to submit the form. Just go into the backend and check if the lead gets identified.

Note: Password fields are ignored for this function

Example powermail form in frontend:

Example lead identification in dashboard:

Note: Re-Initialization for forms, loaded via AJAX can also be done with a script like:

const lux = LuxSingleton.getInstance();
lux.addFieldListeners();
Copied!

2. FormFieldMapping

Another way for identifications is to listen to complete form submits of any forms on your website. If you want to send all field information of a form to lux, just add a data-lux-form-identification attribute to the form-tag itself. See table for data-attribute value:

Field Description Explanation
data-lux-form-identification="true" Catch submit, track values and do a form.submit() at the end Default usage
data-lux-form-identification="submitButton" Catch submit, track values and do a lastSubmitButton.click() at the end Important if submit button click is needed (e.g. for "typo3/cms-form")
data-lux-form-identification="preventDefault" Catch submit, track values and don't submit When you don't need a submit (e.g. for LUXenterprise workflows)

There some different things when comparing FormFieldMappinng with FieldMapping (see above):

  • The data will be sent to lux when the visitor submits the form and not before
  • The complete form will be sent to lux (but only the fields that are defined in mapping configuration)
  • You have to change the markup of the forms with a data-attribute to the form tag

The default field-mapping is similar to the FieldMapping: E.g. map a field with name tx_form_formframework[e-mail] to the lead property email (see TypoScript below).

Note: A * as wildcard character symbols a placeholder for any string so *[email] is matching for fieldnames like tx_form_formframework[test-99][email], tx_powermail_pi1[field][email] and also tx_femanager_pi1[email]

lib.lux.settings {

    # All identification settings
    identification {
        # En- or Disable field and form identification
        _enable = {$plugin.tx_lux.settings.fieldandformidentification}

        # Identify by complete form submits with '<form data-lux-form-identification="true">'
        # - data-lux-form-identification="true" will catch submit, track values and does a form.submit()
        # - data-lux-form-identification="submitButton" will catch submit, track values and does a submitButton.click(). This is needed for "typo3/cms-form"
        # - data-lux-form-identification="preventDefault" will catch submit and track values without a further submit
        # Using a * as wildcard will search for a string in a string while using a key without * will search for the exact match.
        formFieldMapping {
            email {
                0 = email
                1 = *[email]
                2 = *[e-mail]
                3 = *[e_mail]
            }
            firstname {
                0 = firstname
                1 = *[firstname]
                2 = *[first-name]
                3 = *[first_name]
                4 = *[firstName]
                5 = *[vorname]
            }
            lastname {
                0 = lastname
                1 = *[lastname]
                2 = *[last-name]
                3 = *[last_name]
                4 = *[lastName]
                5 = *[surname]
                6 = *[sur-name]
                7 = *[sur_name]
                8 = *[name]
                9 = *[nachname]
            }
            company {
                0 = company
                1 = *[company]
                2 = *[firma]
            }
            phone {
                0 = phone
                1 = *[phone]
                2 = *[telefon]
                3 = *[tel]
            }
            product {
                0 = product
                1 = *[product]
                2 = *[produkt]
            }
            message {
                0 = message
                1 = *[message]
                2 = *[nachricht]
            }
        }
    }
}
Copied!

Note: Take care that your lib.lux configuration is recognized by lux (see FAQ section how to copy it to plugin.tx_lux_fe)

Note: If you want to stop the submit process, because lux had a workflow for the submit action (show text on form submit, etc..), you can use data-lux-form-identification="preventDefault" instead of data-lux-form-identification="true"

Note: If you are using a JavaScript based validation in your form, it's possible that there are conflicts with FormFieldMapping

Example form (added via content element html):

<form data-lux-form-identification="preventDefault" action="#">
	<div class="form-group">
		<label for="email">Ihre E-Mail-Adresse</label>
		<input type="email" class="form-control" id="email" name="test[email]">
	</div>
	<div class="form-group">
		<label for="firstname">Vorname</label>
		<input type="text" class="form-control" id="firstname" name="firstname">
	</div>
	<div class="form-group">
		<label for="lastname">Nachname</label>
		<input type="text" class="form-control" id="lastname" name="lastname">
	</div>
	<div class="form-group">
		<label for="company">Firma</label>
		<input type="text" class="form-control" id="company" name="company">
	</div>
	<div class="form-group">
		<label for="phone">Phone</label>
		<input type="text" class="form-control" id="phone" name="phone">
	</div>
	<div class="form-group">
		<label for="product">Zu welchem Produkt können wir Ihnen helfen?</label>
		<select class="form-control" id="product" name="product">
			<option>Lux</option>
			<option>Content Publisher</option>
			<option>Schulpaket</option>
			<option>CERMAT</option>
			<option>Personendatenbank</option>
		</select>
	</div>
	<div class="form-group">
		<label for="message">Ihre Nachricht an uns</label>
		<textarea class="form-control" id="message" rows="3" name="message"></textarea>
	</div>
	<div class="form-check">
		<label class="form-check-label">
			<input type="checkbox" class="form-check-input" value="1" name="agb" required>
			<a href="/privacy/">Datenschutzerklärung</a> gelesen und akzeptiert
		</label>
	</div>
	<button type="submit" class="btn btn-primary">Nachricht versenden</button>
</form>
Copied!

Form in frontend:

Example lead identification in dashboard:

Note: Re-Initialization for forms, loaded via AJAX can also be done with a script like:

const lux = LuxSingleton.getInstance();
lux.addFormListeners();
Copied!

4. Frontend login of a frontend user

If a frontend user logs in into TYPO3, lux automatically creates a relation to this user. If the field fe_users.email is filled, lux take over this field property and identification is resolved.

5. Luxletter

The extension Extension luxletter is a email marketing extension that allows you to send newsletters to your users. If a user clicks on a link in this newsletter, lux identifies who has clicked the link. See documentation of luxletter for more details to this extension.