Configure Product Catalog
a. Design a winning product, pricing, and bundling strategy.
This will be the most strategic aspect of onboarding to MonetizeNow. What you deliver, and how you deliver it, is the essence of your value proposition to your end-customers. Your Product Catalog represents the products, bundles, and pricing for your end-customers (based on desired restrictions and availability).
This is a step to be done in collaboration with Product, Marketing, and the experts at MonetizeNow.
We have put together two blog posts, Part 1 & Part 2 to help guide your thinking in shaping a product and pricing strategy. That said, some guiding principles to help you on this journey:
-
Price to value. What this broadly means for certain classes of products,
- Person-to-Person Offering - where the value is derived from another person's time dedicated to achieve an outcome - pricing based on hours or as a percentage of end outcome's value is recommend.
- Common examples include Consultative Services, Implementation Fees, Support, Product Customization.
- Product-to-Person Offering - where the value is derived from a user extracting insight, creating outputs, or experiencing the product - pricing based on a number of users (segmented by type of users) or as a percentage of end outcome's value is recommend. Note: If there is a Product-to-Person interaction where the product is consumed, then pricing based on units consumed is recommended.
- Common examples include Media Subscriptions, SaaS Seats.
- Common consumption examples include Utilities, Food, Gasoline.
- Product-to-Product Offering - where the value is derived from a system performing an action by engaging with another system - pricing based on usage, events, or as a percentage of end outcome's value is recommend.
- Common examples include Credits for AI Model Usage, Payment Processing Fees.
- Person-to-Person Offering - where the value is derived from another person's time dedicated to achieve an outcome - pricing based on hours or as a percentage of end outcome's value is recommend.
-
Bundle for simplicity,
- Your Product is the smallest logical unit you would offer / sell to a customer.
- Often these are a license, a seat, a credit.
- These could be connected to entitlements to dynamically activate product functionality
- Your Offering (or Bundle) is what a customer is buying and is the collection of all the products / features they can actually paying for.
- If someone can buy a product directly it is also an Offering
- If someone can only buy a product when a part of something bigger (e.g. Support with a Product) then it is only available as a Bundled Offering
- Your Rates should only represent different prices or payment frequencies for the exact same functionality / bundle / products.
- Most common would be Monthly vs. Annual Pricing.
As a rule of thumb:
- If your quote is repeating a lot of words or descriptions, your product catalog is likely too detailed.
- If your quote is unclear as to what the customer actually purchased, your product catalog is likely too vague.
- Your Product is the smallest logical unit you would offer / sell to a customer.
b. Upload products, bundles, and pricing into MonetizeNow Product Catalog
Once your product catalog is set strategically, follow our step-by-step guide to code-up your catalog into MonetizeNow.
Uploading the Product Catalog via Excel/CSV
MonetizeNow offers an Excel/CSV-based flow to configure your product catalog quickly and reliably, ideal during onboarding, sandbox testing, or for customers managing large or complex catalogs.
The catalog is structured across three connected layers
- Products → What you sell
- Offerings → How you package it
- Pricing → How it’s charged
Each layer is interconnected using internal IDs (referenced in the Values sheet in the Excel templates), so understanding the correct order and relationships is key.
Upload Sequence Overview
Upload Section | Upload File | Key Relationship |
---|---|---|
Add Products | Onboarding - Products Template.xlsx | No dependency |
Create Offerings | Onboarding - Offerings Template.xlsx | Linked to Product ID |
Price Offerings | Onboarding - Rate Template.xlsx | Linked to Offering ID |
Step-1: Add Products
Products are the top-level items in your catalog, they describe what you’re offering at a high level.
Required Columns (values tab → Products)
Column | Description |
---|---|
name | Display name of the product (e.g., "Pro Analytics") |
description | Optional internal/customer-facing product description |
status | Must be set to ACTIVE or INACTIVE |
Key Notes:
- Once uploaded, each product is automatically assigned a Product ID
- This id is what Offerings will use to associate themselves
Step-2: Create Offerings
Offerings are the specific configurations of how a product is sold. E.g., “Annual Plan” vs. “Monthly Plan” of the same product.
Required Columns (values tab → Offerings)
Column | Description |
---|---|
name | Name of the offering (shown to users & in quotes) |
description | Optional |
product_id | The ID of the product this offering belongs to (refer to Values sheet in Product upload) |
status | Must be ACTIVE to use |
start_date / end_date | Optional - used to restrict offering availability |
offering_type | Categorization (e.g., Standard, Add-ons) |
Key Notes:
- The product_id must match an existing product from your earlier upload
- name is customer-facing and used during quoting
- Use the Values tab of the product upload to grab the correct product IDs
- 5 max Products - WIP
Step-3: Price Offerings
This step defines how each offering is billed, including recurring pricing, one-time charges, and usage-based rates.
Required Columns (values tab → rates)
Column | Description |
---|---|
offering_id | ID of the offering this rate applies to (from Offerings upload) |
rate_name | Internal label for the pricing rule |
charge_type | RECURRING, ONE_TIME, or USAGE |
pricing_model | FLAT, TIERED, or VOLUME |
unit_price | Base unit cost |
charge_frequency | e.g., MONTHLY, ANNUAL (required for recurring types) |
currency | ISO format (e.g., USD) |
min_units / max_units | Required if using volume or tiered pricing |
Key Notes:
- The offering_id links the rate to a specific offering
- Use the Values tab of the Offerings template to find the right IDs
- Multiple pricing rows can exist for a single offering (e.g., flat recurring + usage-based add-on)
- Cannot mix tiered with other pricing models - WIP
Uploading in the UI
You’ll find the upload areas under Configure Catalog in your tenant:
- Add Products
- Create Offerings
- Price Offerings
Each section allows:
- Drag-and-drop or manual upload (CSV or XLSX)
- Template download
- Undo imports
Sandbox vs Production Flow
- Build and test your catalog structure in Sandbox
- Once finalized, reach out to the MN team for migration support (currently via internal tooling)
- In future, this migration will be available as a secure, admin-level self-service feature
FAQs- Troubleshooting Upload Errors
Issue | Likely Cause | What to Check or Do |
---|---|---|
Offering upload fails despite matching product name | You might be using the product name instead of the product ID | Use the product_id from the Values tab in the Products file |
Rate upload shows "invalid ID" error | offering_id doesn't match any existing offering | Copy the offering_id from the Values tab of the Offerings file |
Re-uploading doesn't update correctly | Uploading with mismatched names or IDs | Use Undo Import first, then re-upload with consistent field values |
Rates fail to upload even when fields are filled | Offerings may not have been uploaded or linked properly | Confirm that the associated Offering was uploaded successfully and is ACTIVE |
Uploaded pricing doesn't show in the UI | Pricing was linked to the wrong Offering ID | Recheck the ID, undo the import, and re-upload with the correct link |
Error about missing required fields | One or more columns were left blank or formatted incorrectly | Use the latest template from MN, and check that required columns like name, status, pricing_model, etc., are all filled |
Upload works but pricing isn't what I expected | Unit price or tier values might be misaligned | Double-check min_units, max_units, and pricing_mode settings |
Not sure what ID to use in Offerings or Rates | Manual copy-paste error or confusion over hierarchy | Always use the Values tab from the previous step's export (e.g., copy product ID for offerings, offering ID for rates) |
Updated 22 days ago