Verifying the install
The Marketing Factory and Unomi installation has some manual steps and can be error prone. The Jahia product team will improve these software to ease installation and updates over the next months, but in the meantime you can check that you correctly configured Marketing Factory and Unomi by doing the following tests:
Verify that visitors data can be sent to Unomi:
For each address defined as "Apache Unomi public URL" in the "Connection to Apache Unomi" settings:
- Copy and paste the address to your browser and add "/context.json". For instance: https://unomi.jahia.com/context.json.
- Check that some json is sent back (starting with {"profileId":" ..) by Unomi
If your computer is on a VPN, you can try to reach the address from your phone to ensure that you're actually testing outside of your company network.
Verify that profiles can be updated from the Marketing Factory UI:
In the "Audience" => "Visitors" panel, open any profile and update any property to a random value. Refresh the profile page and ensure that your change was saved. After, you can revert the change.
Verify that personalization using the countries, states, regions and city can be used
- Add a personalization on a random content, we'll call it "content1"
- Add a second content variation, we'll call it "content2"
- Open the variant conditions, reorder the variants for content2 to be above content1
- For content2, set the conditions to custom => Geographic => Geolocation by country
- Select the country you're currently in
- Select the state / province / region you're currently in
- Hit Save
Verify that the geolocation is working
To verify that the geolocation is working, you must first go through the 7 steps described above.
- If the country selection is successful:
- Publish your personalization
- Go to live mode
- Verify that you see content2
If you're on a VPN, you can either change the personalization condition to match your VPN location or test the personalization from your mobile.
Verify that personalization using maps view can be used
- Add a personalization on another random content, we'll call it "contentA"
- Add a second content variation, we'll call it "contentB"
- Open the variant conditions, reorder the variants for contentB to be above content1
- For content2, set the conditions to custom => Geographic => Geolocation by point and click on "draw circle condition" below the map
- Select the location where you're currently at
- Hit Save
- Publish your personalization
- Go to live mode
- Ensure that you see contentB
If you don't see a map: It's very likely that the google maps key is empty or wrong. Please check the value in Marketing Factory => Settings => Connection to Apache Unomi
Verify that DX user data is collected in Apache Unomi
- Create a new DX User (from DX administration). For instance:
Login: jsmith
Password: jsmith00
First Name: john
Last Name: smith
- Logout of DX
- Login with jsmith / jsmith00
- Logout of DX
- Login with your real user
- Go to Marketing Factory => Audience => Visitors
- The visitor John smith should appear
- Open this profile
- Check that the first name and the last name in the profile are matching the ones that you set in DX.
Verify that internal searches are collected
If your website has a search form:
- In live mode, type "test search" in your search form
- Submit the form
- Go to Marketing Factory => Site Metrics => Internal Searches
- Check that "test search" appears in the list
Verify that profiles are consolidated across sessions
- Open a test browser (for instance I use Chrome to edit content, configuration and personalization and Firefox only in live mode to ensure that I can recreate conditions of new visitors) : clean all your cookies
- Open your website in live mode
- Open the debug mode of your brower
- Go to storage => cookies
- Copy the value of "wem-profile-id"
- Close the test browser (really quit the application)
- Open the test browser again, with your website in live mode, in debug mode
- Check that the value of "wem-profile-id" is still the same
In any situation and especially if one of the test above is not successfull, you can contact the Jahia support team. You can also review the Elasticsearch, Apache Unomi cluster setup that is the documentation about how our IT team installed and configured Apache Unomi on the jahia.com servers.