MonkeyLearn App Installation Guide

MonkeyLearn is a machine learning-based text analytics platform that offers detailed insights about your content, such as feedback, surveys, charts, etc. It helps to analyze customer sentiments by collecting data in one place and sorting their response in a simple, clean, and structured manner.

The MonkeyLearn app offers detailed insights into the performance of your content, such as feedback, surveys, charts, etc. By analyzing customer experience, you can improve the overall performance of your website.

Prerequisites

• MonkeyLearn account
• Contentstack account
• Access to the Contentstack Organization/Stack as the Owner/Admin.

Let's go through the steps required to install and configure the MonkeyLearn app within Contentstack Marketplace.

Steps for Execution

1. Fetch the credentials from your MonkeyLearn account
2. Install the MonkeyLearn Application
3. Use MonkeyLearn within your Stack

1. Fetch the credentials from your MonkeyLearn account

   To configure the application, you need to create a MonkeyLearn account. To do so, follow the below steps:

   1. Navigate to MonkeyLearn to create an account.
   2. Under the “User Profile” section, click My Account.
      
   3. Under API Key, you will see the API Key. Click Revoke and re-generate to create a new one.
      

   Note: In the Plan and Pricing section, you can check for the plans based on your requirement.

   To use the MonkeyLearn app, you can either use a pre-defined model or can create a custom model from your MonkeyLearn account. To create a Classifier custom model, refer to How to build a Custom Classifier document

   Note: To create an Extractor custom model, refer to the How to build a Custom Extractor document.

2. Install the MonkeyLearn Application

   Follow the steps to install the application in Contentstack.

   1. Log in to your Contentstack account.
   2. On the left navigation panel, you will find the icon for Marketplace. Click the icon to navigate to Marketplace. 
      
   3. Select MonkeyLearn from the list of apps.
   4. On the right-hand side, click the Install App button.
      
   5. In the authorization window, select the stack where you want to install the app. Click the Authorize & Install button.
      
   6. On the Configuration page, enter the API Key you retrieved from MonkeyLearn in step 1.
   7. Select Scope. Select the scope for which the MonkeyLearn app will be available for running the analysis on the Contentstack content types.
      1. All Content Types: The scope of the app is defined for all the content types in the selected stack.
      2. Specific Content Type: The scope of the app is defined for specific content type (types) in the selected stack.
      
      
   8. Click Save.
   9. Click Open Stack to start using the MonkeyLearn application.

   Note: The MonkeyLearn app can be used to view and analyze the text for the entries of your stack via the sidebar widget UI location.

3. Use MonkeyLearn within your Stack

   To use the MonkeyLearn application in an entry of your stack, you can use text-based fields such as Single Line Textbox, Multi Line Textbox, JSON RTE Field, Number and Date fields, Global Fields, Reference Fields etc.

   Note: You can only use text-based fields of a content type while using the MonkeyLearn app.

   To use the MonkeyLearn application, follow the steps given below:

   1. Go to your stack, click the Content Models icon on the left navigation panel, and click the + New Content Type button.
   2. Create a content type by adding relevant details and click Save and proceed.
      
   3. In the Content Type Builder page, add text fields such as the Multi Line Textbox field and JSON RTE field in your content type by clicking the Insert a field link represented by a + sign.
   4. Click Save or Save and Close.
   5. On the left navigation panel, navigate to the Entries page and click + New Entry to create a new entry for the above content type. Click Proceed. 
      
   6. Enter the text in the selected fields. Click Save.
      
   7. On the right navigation panel, select Widgets.
      
   8. Within Widgets, click the Entry Widgets dropdown, and under Apps, select the app that you configured in the sidebar widget configuration page.
      
   9. Select the Model from the dropdown.

      Note: The list of models is fetched from your MonkeyLearn account you selected previously.

      
      
   10. Select the Entry Field in which you want to perform the text analysis.
       
       
   11. Click Run to process the text. The results are displayed in the sidebar widget.

       Note: The results are based on the corresponding model you selected.