Child pages
  • 3b. Data Import, Users
Skip to end of metadata
Go to start of metadata

All the features described in this chapter are available only for the advanced edition of the Recommender Engine.

BASIC Authentication is enabled by default. Use the customerid/mandator as username and the license key as password. The license key is displayed in the upper right in the Admin GUI ( after logging in with your registration credentials.

Please read an introduction to the user attribute import in the user guide
User Guide Chapter 11b. User Attribute Import

Metadata import

It is useful to add metadata to users in order to classify them and attach them to user-type clusters. We provide the following "user metadata" import format in order to enrich tracked user data with information that cannot be calculated from their behavior but only provided by a customer itself. An example for this metadata could be "gender", "postal code", "discount rate", etc. 

Please contact if you are planning to import user metadata in order to be compliant with privacy regulations.

 Following is an example user metadata in .xml format. All attribute keys and values are chosen arbitrary.

  <user id="CUSTOMER_1234">
      <attribute key="country" value="DE"  type="NOMINAL"/>    <!-- NOMINAL is a default value -->
      <attribute key="discountrate" value="2" type="NUMERIC"/>
      <attribute key="wants" value="I am looking for good products here" type="TEXT"/>
      <attribute key="type" value="reseller"/>
      <attribute key="favorite_film_genre" value="comedy"/>
      <attribute key="favorite_film_genre" value="horror"/>
      <attribute key="favorite_film_genre" value="animation"/>


Following request is used to fetch user attributes for the specified users:


Following URL is used to update the set of the user attributes:


The users are provided in the specified XML format (do not forget the HTTP Content-Type=text/xml header).


User ID

User ID is any character combination. The user IDs are case sensitive.

Because of transferring as part of an URL in the event tracking it is recommended to avoid space character and slashes (both forward and back slashes). Apache web-servers (and products based on this Apache project) have very sophisticated and non-transparent rules for handling slashed in th URL.

If transferred in the URL the user ID must be URL-Encoded. If transferred in the XML-attribute it must be XML-Encoded. As follow:

User IDURL encodedXML encoded


The attribute key is a POSIX alphanumeric code [A-Z], [0-9] plus "_" and "-". Attribute keys are case sensitive.

Attribute Type

Following types are supported:

  • NUMERIC - Decimal value like "1.23" or "-2345". 
  • NOMINAL - A value from a fixed length list like "gender" or "favorite film genre". It is a default value.
  • TEXT - Longer usually free entered text
  • DATE - XSD formatted date like "2014-08-07"
  • DATETIME - XSD formatted time without a time zone like "2014-08-07T14:43:12"


The "source" is used to define the view on the specified user. If you have multiple sources/systems for updating user attributes like e.g.

  • registration service to set the gender and age of the user.
  • facebook linked application to set the favorite brands the user "liked" in your shop.

Every new upload of attributes will replace the previous attribute set of the same user and the same source.

If you need to get all the available attributes for all sources, use query string parameter "allSources", like:


In this case an additional XML-attribute "source" will be added, if the source is different to the source provided in the request ("facebook" in the example above).




  • No labels