Skip to main content
RichRelevance

RR to Manthan transfer of behavior data

Introduction 

View, purchase and Customer Preference behavioral data that is generated in the RichRelevance system for client users will be transferred to the Manthan systems. 

This data will be used to deliver an end-to-end algorithmic customer experience marketing solution that includes the leading business-to-consumer Customer Data Platform, Retail Marketing & Merchandising Solution, and Real-time Personalization Platform with advanced data science.

A RichRelevance component service named log-jsonifier is used to convert the behavior data generated in the RichRelevance systems to a json format and then use kafka data stream processing to transfer that data to systems at Manthan.

Currently, log-jsonifier is configured to convert and transfer the following data types:  1) view, 2) purchase and 3) Customer Preference.  This component is configurable to convert and transfer data for specific RR sites.

 

 

Parameters for the json format:
Name Description Additional Information and Options
datetime An epoch timestamp for the event.    
viewGuid guid generated by RR to assign a unique id to the event  
channelId The internal RR method that generated the event.  What channel did the event come from (online, mobile sdk, offline).  Generally this will be generated from a server-side api or a client-side p13n call. Values: recsForPlacement, TBD
site.id The RR internal database id for the site  
site.apiKey

The RR api_key created for the site. 

This value is known to the client and is used for server-side api calls.  It is also known for p13n calls.   

 
site.externalId The corresponding Manthan id for site.  This allows mapping from the RR site id to the Manthan site id.  
visitor.deviceId The Manthan guid that is passed to RR instrumentation, or the guid generated by RR for the user.  
visitor.deviceIdFirstView Is the deviceId newly generated? Values: true, false
visitor.userId The user id assigned by client site and passed in the RR behavior event.  TBD what about evnets with no userId?  
visitor.sessionId The session id assigned by the site in the RR behavior event.  
visitor.siteDenotedUserId
 

TBD - unclear what sites use this this in what situations. still looking for examples of where it is used.

Will usually not be included.

 
visitor.segmentIds
 
The segment ids that were assigned to this user.  
visitor.userAttributes
 
Data map with a name to value set of attributes associated with user  
visitor.ip ip address of the client user  
visitor.browser

information about the browser/device used by the client: 

osName => operating system used by the client user

browserVersion => version of the browser

flashVersion => flash version used by the browser

userAgent => device charastics from the userAgent attribute

clientDeviceType => TBD - what are the known values

 
visitor.languageId If provided, the language id from the client user  
page.type The type of view (click). One of home, brand, error, category, product, search, landing, cart, cartadd, purchase, email, ensemble, registry, registryadd  
page.referrer The url of the referrering page assuming it was from outside the site  
page.brand The brand of page. It could be on any page, but usually just on product and brand pages.  
page.refinements Any additional refining information for the page.  
page.contextAttributes Any additional context information for the page.  TBD - what are the values  
search.page   page.searchTerm - The term that was searched for.  
registry.page

 
page.list - The name of the list, registry or wishlist  
registryadd.page page.list - The name of the list, registry or wishlist  
purchase.page page.order
number => the order number 
products =>  the ordered products and information about them 
channel => the order channel 
emailHash => a hash of the users email 
cardHash => a hash of the credit card 
paymentMethod => self expanatory 
storeId => if physical store, the id of that store 
couponCode => self explanatory 
couponValue => how much the coupon reduced the price by 
totalPrice => price paid 
shippingCost => total shipping cost of order 
taxes => total taxes on order 
 
category.page page.categories => for now just ids mapped to empty objects, but in future may contain more infromation about categories
 
 
product.page page.products => ids and information about products  
registry.page page.products => ids and information about products  
cart.page page.products => ids and information about products  
registry.page page.products => ids and information about products  
cart.page page.products => ids and information about products  
cart_add.page page.products => ids and information about products  
registryadd.page page.products => ids and information about products  
   

 

 

Example: json format for rr_behavior topic data to send to Manthan:

1) Example data for a VIEW:

{
    "datetime": 1582245108338,
    "viewGuid": "0ac1fbd6-74c8-4162-2299-7b5c19022801",
    "channelId": "recsUsingStrategy",
    "site": {
        "id": 1825,
        "apiKey": "7e34192c3ac1c51e",
        "externalId": "manthanexternal"
    },
    "visitor": {
        "deviceId": "0ac0fbd6-74c8-4162-2299-7b5c19022801",
        "deviceIdFirstView": true,
        "userId": "9990220_10",
        "sessionId": "dEKaJ_IneiCe_Fj5VEqO1LsgR6L0220_10",
        "siteDenotedUserId": "0ac0fbd6-74c8-4162-2299-7b5c19022801",
        "ip": "4.7.9.150",
        "browser": {
            "osName": "Mac OS X",
            "browserVersion": "Chrome 8",
            "flashVersion": "11.5.31",
            "userAgent": "\u0006(\fIntel \u001C_13_6) AppleWebKit/537.36 \u0013\u001080.0.3987.116\u0014537.36",
            "clientDeviceType": "STANDARD"
        }
    },
    "page": {
        "type": "product",
        "products": [{
            "id": "380"
        }]
    }
}



2) Example data for a PURCHASE:

{
    "datetime": 1582245281306,
    "viewGuid": "0ac4fbd6-74c8-4162-2299-7b5c19022801",
    "channelId": "recsUsingStrategy",
    "site": {
        "id": 1825,
        "apiKey": "7e34192c3ac1c51e",
        "externalId": "manthanexternal"
    },
    "visitor": {
        "deviceId": "0ac3fbd6-74c8-4162-2299-7b5c19022801",
        "deviceIdFirstView": true,
        "userId": "9990220_10",
        "sessionId": "dEKaJ_IneiCe_Fj5VEqO1LsgR6L0220_10",
        "siteDenotedUserId": "0ac3fbd6-74c8-4162-2299-7b5c19022801",
        "ip": "4.7.9.150",
        "browser": {
            "osName": "Mac OS X",
            "browserVersion": "Chrome 8",
            "userAgent": "\u0006(\fIntel \u001C_13_6) AppleWebKit/537.36 \u0013\u001080.0.3987.116\u0014537.36",
            "clientDeviceType": "STANDARD"
        }
    },
    "page": {
        "type": "purchase",
        "order": {
            "number": "100010",
            "products": [{
                "id": "380",
                "quantity": 1,
                "price": 501,
                "type": "Product"
            }]
        }
    }
}



3) Example data for a Customer Preference:
{
    "datetime": 1582245281306,
    "viewGuid": "0ac4fbd6-74c8-4162-2299-7b5c19022801",
    "site": {
        "id": 1825,
        "apiKey": "7e34192c3ac1c51e",
        "externalId": "manthanexternal"
    },
    "visitor": {
        "deviceId": "0ac3fbd6-74c8-4162-2299-7b5c19022801",
        "deviceIdFirstView": true,
        "userId": "9990220_10",
        "sessionId": "dEKaJ_IneiCe_Fj5VEqO1LsgR6L0220_10",
        }
    },
    "preference": {
       "action": "like",
       "target": "product",
       "targetIds": [
         "V_18367017"
       ]
    }
}

 

 

  • Was this article helpful?