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 (https://admin.yoochoose.net) 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
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 firstname.lastname@example.org 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.
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 is any character combination. The user IDs are case sensitive.
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 ID||URL encoded||XML encoded|
The attribute key is a POSIX alphanumeric code [A-Z], [0-9] plus "_" and "-". Attribute keys are case sensitive.
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: