- 5 Minutes to read
- Print
- DarkLight
Methods and Use Cases for User Matching
- 5 Minutes to read
- Print
- DarkLight
This page contains a list of ways to match users between Mapp Intelligence and Mapp Engage.
1. Campaign Matching
Campaign matching connects users who interact with campaign links (email, SMS, etc.) by using URL parameters that identify the user.
A) Campaigns with your website as a landing page
This method works if you send campaigns from Mapp Engage directly to your website, which includes the Mapp Intelligence tracking script.
How does it work?
All links in your Mapp Engage campaigns contain the URL parameter “uc701” for user matching. The Mapp Intelligence tracking script on the landing page uses this parameter to identify users.
How can I integrate it?
The URL parameter in Mapp Engage will be automatically added to all your campaigns. No manual adjustments are necessary.
On your website, use one of the following tracking script versions:
Smart Pixel (version 1.3.1 or later)
Tag Integration (Pixel V5) (version 5.2.5 or later)
Please contact your account manager if you are using a different tracking version and cannot update.
How can I test if it is working?
Check if the uc701 parameter has been added to the URL of your landing page.
If not, please check Tracking & Links Tab. It should contain the link parameter.
Use a debugger (e.g., our Mapp Cloud Debugger) to check if the Mapp Engage contact ID has been tracked in the uc701 parameter.
If not, you might not use a supported tracking pixel version.
B) Campaigns with a Third-Party Landing Page
This method works when you send campaigns from Mapp Engage to a landing page that does not have an integrated Mapp Intelligence tracking script. There are links on this landing page that lead to your website. The website contains the Mapp Intelligence tracking script.
How does it work?
All links in your Mapp Engage campaigns contain the URL parameter “uc701” for user matching. Since the landing page doesn’t include the Mapp Intelligence tracking script, you need to integrate a Javascript that reads the URL parameter out and automatically adds it to the links leading to your website.
How can I integrate it?
The URL parameter in Mapp Engage will be automatically added to all your campaigns.
Integrate the Javascript on the third-party landing page.
Setup
Integration Steps:
Download the zip file that includes the JavaScript file.
(Optional) Make the Adjustments in the file ‘mapp-matching.min.js’
Example:(function(){ var mappMatchingConfig = window.mappMatchingConfig || { domain: [] }; /* ... */ })();
Parameter
Description
domain
Here, you can enter the domains to be marked for Mapp User Matching. If you do not enter anything, all links not equal to the current domain will be marked by default.
You can use strings with wildcards and regular expressions when specifying domains.
For example:
"test.mapp.com"
"*.mapp.com"
/test\.mapp\.com/
/.+\.mapp\.com/
Include the script file on the third-party landing page:
<html> <head> <title>title of the page</title> </head> <body> The content of your third-party landing page is placed here. <script type="text/javascript" src="js/mapp-matching.min.js"></script> </body> </html>
On your website, use one of the following tracking script versions:
Smart pixel: check the documentation for more details. Use version 1.3.1 or later
Tag Integration: check the documentation for more details. Use version 5.2.5 or later
How can I test if it is working?
Check if the uc701 parameter has been added to the URL of your third-party landing page.
If not, please reach out to your Mapp contact.
Check if the uc701 parameter has been added to the URL of your website landing page.
If not, the script is not working properly. Please make sure that the configuration is correct.Use a debugger (e.g., our Mapp Cloud Debugger) to check if the Mapp Engage contact ID has been tracked in the uc701 parameter.
If not, you might not use a supported tracking pixel version.
C) Campaign Matching via Redirect
User matching via redirect can be used as an alternative method.
This methode is only used in exceptional cases, as there is a risk that the redirect will not work correctly in certain cases.
Please contact your account manager if you are still interested in the implementation and require further information.
2. Web Matching
This method works if users are on your website and you want to match them with the Mapp Engage contacts.
This can be done if they provide their email address (e.g. when logging in or subscribe to a newsletter). This email address will be matched with the contact email address in Mapp Engage. If the user exists, he will be matched.
If he doesn’t exist, he will be added as a new user in Mapp Engage.
Continuous identification
As long as the user does not delete his cookies, he can continue to be identified and matched in subsequent visits. If the user deletes the cookies, identification is only possible after a new login.
How does it work?
As soon as the email address is tracked on the website (e.g. when logging in or registering for the newsletter), it must be transferred in the tracking script. Further information can optionally be transmitted.
In case of a new registration (e.g., a new subscriber), you should send the Group that the user will be assigned to and the registration mode.
Example of a registration form with included parameters
All parameters will be sent to Mapp Engage via Mapp Intelligence.
Customer ID
We strongly recommend that you also send this email address in the Customer ID to minimize discrepancies between Mapp Intelligence and Mapp Engage.
Watch this video for more details.
(Placeholder)
How can I integrate it?
Integrate the email address and other optional parameters into the tracking script on your website. You can find more information on this in the documentation.
Documentation Smart Pixel (version 1.4.5 or later)
Documentation Tag Integration (version 5.3.1 or later)
How can I test if it is working?
The tracking request on the website contains the parameters er1-er7 (only “er1” is mandatory and should contain the email address). Use a debugger (e.g., our Mapp Cloud Debugger) to check for this information.
Please note that the contact ID (parameter uc701) is exchanged directly between Mapp Intelligence and Engage. It is therefore not visible in the track request.
3. Mobile Matching
Mobile matching connects mobile application users using Mapp Engage and Mapp Intelligence SDKs.
How does it work?
User matching happens completely automatically within the app.
Cross-Channel Mapping
If you measure websites in addition to the app, you should transmit the email address as a unique identifier. Use the customer ID parameter in the app and also the registration email on the website (see Web Matching).
How can I integrate it?
Please activate User Matching in the SKD.
How can I test if it is working?
The tracking request on the app contains the parameter uc701. Use a debugger to check for this information.