NATS5 Getting Started with Reporting

From TMM Wiki
Revision as of 00:20, 18 January 2021 by TMMJeff (talk | contribs)
Jump to navigationJump to search
NATS 5
Reporting Section
NATS5 Reports
Getting Started with Reporting
Report Types
Members Section
Members Management
Adding a Member
View Member Details
Restricted Values
OpenID Connect
Mod Auth OpenIDC
    Adtool
GET /adtool/admin
GET /adtool/adtools
GET /adtool/adtool
GET /adtool/adtool-rules
GET /adtool/adtool-rule
GET /adtool/categories
GET /adtool/field-options
GET /adtool/field-types
GET /adtool/groups
GET /adtool/search
GET /adtool/templates
GET /adtool/types
GET /adtool/type
POST /adtool/adtool
POST /adtool/adtool-rule
POST /adtool/category
POST /adtool/field
POST /adtool/field-option
POST /adtool/group
POST /adtool/import
POST /adtool/type
PATCH /adtool/adtool
PATCH /adtool/adtool-group
PATCH /adtool/adtool-rule
PATCH /adtool/category
PATCH /adtool/field
PATCH /adtool/field-option
PATCH /adtool/group
PATCH /adtool/move
PATCH /adtool/restore-adtool
PATCH /adtool/restore-category
PATCH /adtool/restore-field
PATCH /adtool/restore-field-option
PATCH /adtool/restore-type
PATCH /adtool/type
DELETE /adtool/adtool
DELETE /adtool/adtool-rule
DELETE /adtool/category
DELETE /adtool/field
DELETE /adtool/field-option
DELETE /adtool/group
DELETE /adtool/type
    Affiliate
DELETE /affiliate/account-rep
DELETE /affiliate/account-type
DELETE /affiliate/affiliate
DELETE /affiliate/doc
DELETE /affiliate/group
DELETE /affiliate/permissions
GET /affiliate/account-changes
GET /affiliate/account-types
GET /affiliate/admin-settings
GET /affiliate/campaigns
GET /affiliate/current
GET /affiliate/current-permissions
GET /affiliate/docs
GET /affiliate/doc
GET /affiliate/groups
GET /affiliate/group
GET /affiliate/hits
GET /affiliate/link-styles
GET /affiliate/loginids
GET /affiliate/loginlog
GET /affiliate/manual-payout
GET /affiliate/news-sections
GET /affiliate/notes
GET /affiliate/notices
GET /affiliate/override
GET /affiliate/payout
GET /affiliate/payment-periods
GET /affiliate/payvia-types
GET /affiliate/payvia-type
GET /affiliate/permissions
GET /affiliate/programcampaigns
GET /affiliate/referrer
GET /affiliate/referring-urls
GET /affiliate/reps
GET /affiliate/rest-methods
GET /affiliate/search
GET /affiliate/search-limited
GET /affiliate/settings
GET /affiliate/skins
GET /affiliate/soap-functions
GET /affiliate/status
PATCH /affiliate/adminsettings
PATCH /affiliate/account-change
PATCH /affiliate/account-type
PATCH /affiliate/account-type-permissions
PATCH /affiliate/admin-setting
PATCH /affiliate/affiliate-account-type
PATCH /affiliate/affiliate-group
PATCH /affiliate/allsettings
PATCH /affiliate/account-rep
PATCH /affiliate/avatar
PATCH /affiliate/customs
PATCH /affiliate/defaults
PATCH /affiliate/details
PATCH /affiliate/override
PATCH /affiliate/password
PATCH /affiliate/payment-period
PATCH /affiliate/payvia
PATCH /affiliate/payvia-info
PATCH /affiliate/permissions
PATCH /affiliate/referrer
PATCH /affiliate/reset-api
PATCH /affiliate/reset-rss
PATCH /affiliate/reset-tos
PATCH /affiliate/rest-permissions
PATCH /affiliate/restore
PATCH /affiliate/restore-account-type
PATCH /affiliate/settings
PATCH /affiliate/soap-permissions
PATCH /affiliate/status
POST /affiliate/account-type
POST /affiliate/add
POST /affiliate/doc
POST /affiliate/group
POST /affiliate/invoice
POST /affiliate/manual-sale
POST /affiliate/note
    Biller
GET /biller/available
GET /biller/partner-available
GET /biller/billerdata
GET /biller/cascades
GET /biller/cascades-available
GET /biller/cascade-count
GET /biller/cascade-history
GET /biller/cascade-rules
GET /biller/cascade-rule
GET /biller/cascade-step-count
GET /biller/cascade-steps
GET /biller/cascade-detail
GET /biller/cascade-list
GET /biller/count
GET /biller/detail
GET /biller/fees
GET /biller/partner-fees
GET /biller/last_poll
GET /biller/partner-last-poll
GET /biller/list
GET /biller/partner-detail
GET /biller/partner-list
GET /biller/partner-shortnames
GET /biller/process_types
GET /biller/partner-process-types
GET /biller/shortnames
GET /biller/transaction_types
GET /biller/partner-transaction-types
GET /biller/taxes
POST /biller/add
POST /biller/cascade
POST /biller/cascade-rule
POST /biller/cascade-step
POST /biller/partner
PATCH /biller/cascade
PATCH /biller/cascade-rule
PATCH /biller/cascade-step
PATCH /biller/cascade-steps-reorder
PATCH /biller/fee
PATCH /biller/partner-fee
PATCH /biller/restore
PATCH /biller/restore-cascade
PATCH /biller/restore-partner
PATCH /biller/setting
PATCH /biller/partner-setting
PATCH /biller/tax
DELETE /biller/biller
DELETE /biller/cascade
DELETE /biller/cascade-rule
DELETE /biller/cascade-step
DELETE /biller/fee
DELETE /biller/partner-fee
DELETE /biller/partner
DELETE /biller/tax
    Codes
GET /codes/affiliate-codes
GET /codes/decode
GET /codes/linkcodes
GET /codes/strack
    Config
DELETE /config/setting
GET /config/section
GET /config/sections
PATCH /config/affiliate_default
PATCH /config/section
    Include
DELETE /include/include
DELETE /include/step
GET /include/include
GET /include/includes
GET /include/templates
PATCH /include/include
PATCH /include/restore
PATCH /include/step
POST /include/include
POST /include/step
    Mailing
DELETE /mailing/mailing
DELETE /mailing/mailing-rule
DELETE /mailing/queue
GET /mailing/mailing
GET /mailing/mailings
GET /mailing/mailing-rules
GET /mailing/mailing-rule
GET /mailing/queue
GET /mailing/removelist
PATCH /mailing/mailing
PATCH /mailing/mailing-rule
PATCH /mailing/removelist
PATCH /mailing/removelist-queue
PATCH /mailing/resend-queue
PATCH /mailing/restore-queue
PATCH /mailing/send-mailing
PATCH /mailing/send-test-mailing
POST /mailing/mailing
POST /mailing/mailing-rule
POST /mailing/removelist
    Maintenance
DELETE /maintenance/log
DELETE /maintenance/cache
GET /maintenance/admin-actions
GET /maintenance/log
GET /maintenance/logs
GET /maintenance/nats
GET /maintenance/report
GET /maintenance/report-progress
GET /maintenance/reports
GET /maintenance/server
GET /maintenance/table
GET /maintenance/tables
GET /maintenance/table-clean-count
GET /maintenance/table-clean-progress
PATCH /maintenance/log
PATCH /maintenance/report
PATCH /maintenance/table
    Member
GET /member/available_flags
GET /member/encryptusername
GET /member/authstring
GET /member/details
GET /member/flags
GET /member/loginlog
GET /member/matching
GET /member/notes
GET /member/notices
GET /member/restricted-values
GET /member/search
GET /member/suggestedcanceloffers
GET /member/surfer-actions
PATCH /member/details
PATCH /member/expiration
PATCH /member/expiremanual
PATCH /member/resend-transaction-email
PATCH /member/resend-transaction-postback
PATCH /member/restricted-value
PATCH /member/forget
PATCH /member/lock
PATCH /member/unlock
POST /member/flag
POST /member/login
POST /member/note
POST /member/restricted-value
DELETE /member/flag
DELETE /member/restricted-value
    Message
DELETE /message/message
DELETE /message/permanent
GET /message/count
GET /message/messages
GET /message/view
PATCH /message/read
PATCH /message/unread
PATCH /message/undelete
POST /message/message
    News
DELETE /news/entry
DELETE /news/section
GET /news/entry
GET /news/news
GET /news/sections
PATCH /news/entry
POST /news/entry
POST /news/section
    Notification
DELETE /notification/notification
DELETE /notification/permanent
GET /notification/count
GET /notification/notifications
GET /notification/view
PATCH /notification/read
PATCH /notification/unread
PATCH /notification/undelete
    Option
GET /option/options
GET /option/rule
PATCH /option/rule
PATCH /option/text
POST /option/rule
    Payment
DELETE /payment/invoice
DELETE /payment/payout-period
DELETE /payment/payvia-field
DELETE /payment/payvia-field-mc
DELETE /payment/payvia-rule
GET /payment/dump-format
GET /payment/dump-formats
GET /payment/invoices
GET /payment/payments
GET /payment/payment-dumps
GET /payment/payment-dump
GET /payment/payment-search
GET /payment/payvia
GET /payment/payvias
GET /payment/payvia-fields
GET /payment/payvia-field-mcs
GET /payment/payout-period
GET /payment/payout-periods
GET /payment/payvia-rules
GET /payment/payvia-rule
GET /payment/payviarule
PATCH /payment/copy-dump-format
PATCH /payment/default-payout-period
PATCH /payment/dump-format
PATCH /payment/duplicate-payvia
PATCH /payment/invoice
PATCH /payment/payment
PATCH /payment/payment-paid
PATCH /payment/payment-store
PATCH /payment/payment-unstore
PATCH /payment/payments
PATCH /payment/payments-unstore
PATCH /payment/payout-period
PATCH /payment/payout-period-affiliates
PATCH /payment/payvia
PATCH /payment/payvia-field
PATCH /payment/payvia-fields-reorder
PATCH /payment/payvia-field-mc
PATCH /payment/payvia-field-mcs-reorder
PATCH /payment/payvia-rule
PATCH /payment/payviarule
PATCH /payment/restore-payout-period
PATCH /payment/restore-payvia-field
PATCH /payment/restore-payvia-field-mc
POST /payment/check-dump
POST /payment/dump-format
POST /payment/import-dump
POST /payment/invoice
POST /payment/payout-period
POST /payment/payvia
POST /payment/payvia-field
POST /payment/payvia-field-mc
POST /payment/payvia-rule
    Program
DELETE /program/program
DELETE /program/payout-change
DELETE /program/payout-change-tier
GET /program/additional-payout-change-targets
GET /program/affiliate-available
GET /program/detail
GET /program/list
GET /program/options
GET /program/payout-changes
GET /program/redirect-available
GET /program/sites
GET /program/tours
GET /program/types
PATCH /program/default_payout
PATCH /program/details
PATCH /program/disable_affiliate
PATCH /program/disable_tour
PATCH /program/enable_affiliate
PATCH /program/enable_site
PATCH /program/enable_tour
PATCH /program/move-payout-change
PATCH /program/payout-change
PATCH /program/payout-change-tier
POST /program/new
POST /program/payout-change
POST /program/payout-change-tier
    Report
GET /report/affiliate-ratios
GET /report/hits
GET /report/hit-totals
GET /report/profitloss
GET /report/profit-loss
GET /report/fields
GET /report/focus
GET /report/focuses
GET /report/groups
GET /report/perspective
GET /report/perspectives
GET /report/report
GET /report/subscription
GET /report/surfer
GET /report/surferaction
GET /report/transactionpayouts
GET /report/transactions
GET /report/transaction
GET /report/report-widget
GET /report/widgets
GET /report/widget
GET /report/widget-info
GET /report/views
POST /report/focus
POST /report/group
POST /report/perspective
PATCH /report/focus
PATCH /report/focus-enabled
PATCH /report/focus-default
PATCH /report/focuses-reorder
PATCH /report/perspective
PATCH /report/perspective-group
PATCH /report/report-widget
PATCH /report/widget
DELETE /report/focus
    Reward
DELETE /reward/category
DELETE /reward/purchase
DELETE /reward/point
DELETE /reward/reward
GET /reward/categories
GET /reward/points
GET /reward/purchases
GET /reward/rewards
PATCH /reward/move-point
PATCH /reward/point
PATCH /reward/reward
PATCH /reward/ship-purchase
PATCH /reward/unship-purchase
POST /reward/category
POST /reward/point
POST /reward/reward
    Service
GET /service/check-functions
GET /service/condition
GET /service/countries
GET /service/country
GET /service/datetime
GET /service/languages
GET /service/periods
GET /service/ping
GET /service/project
GET /service/rule-condition-data
GET /service/rule-info
GET /service/stats-breakdowns
GET /service/timezone
GET /service/timestamp
POST /service/sendemail
    Site
GET /site/base-templates
GET /site/billers
GET /site/cookies
GET /site/coupon
GET /site/coupons
GET /site/coupon-revisions
GET /site/email-settings
GET /site/groups
GET /site/option
GET /site/options
GET /site/options-available
GET /site/option-fields
GET /site/option-rules
GET /site/option-rule
GET /site/option-type
GET /site/option-types
GET /site/programs
GET /site/redirect
GET /site/redirects
GET /site/redirect-rules
GET /site/redirect-rule
GET /site/site-list
GET /site/site
GET /site/site-notices
GET /site/site-partner
GET /site/site-partners
GET /site/site-type
GET /site/sites
GET /site/template
GET /site/templates
GET /site/template-sections
GET /site/template-sites
GET /site/tour
GET /site/tours
GET /site/tour-emails
GET /site/tour-notices
POST /site/coupon
POST /site/group
POST /site/option
POST /site/option-rule
POST /site/redirect
POST /site/redirect-rule
POST /site/site-partner
POST /site/site-tour
POST /site/copy-template
POST /site/tour
PATCH /site/cookie
PATCH /site/coupon
PATCH /site/duplicate-option
PATCH /site/email-settings
PATCH /site/group
PATCH /site/move
PATCH /site/option
PATCH /site/option-rule
PATCH /site/redirect
PATCH /site/redirect-rule
PATCH /site/reset-coupon
PATCH /site/restore-group
PATCH /site/restore-option
PATCH /site/restore-redirect
PATCH /site/restore-site
PATCH /site/restore-site-partner
PATCH /site/restore-tour
PATCH /site/site
PATCH /site/site-partner
PATCH /site/template
PATCH /site/tour
DELETE /site/cookie
DELETE /site/group
DELETE /site/option
DELETE /site/option-rule
DELETE /site/site
DELETE /site/site-partner
DELETE /site/redirect
DELETE /site/redirect-rule
DELETE /site/template
DELETE /site/tour
DELETE /site/tour-field
    Skin
DELETE /skin/skin
DELETE /skin/template
GET /skin/colors
GET /skin/export
GET /skin/skins
GET /skin/sections
GET /skin/templates
GET /skin/template
PATCH /skin/colors
PATCH /skin/flush
PATCH /skin/skin
PATCH /skin/template
POST /skin/copy-template
POST /skin/import
POST /skin/skin
POST /skin/template


The NATS5 Reporting Admin offers quick access to all the statistics within your program. There are multiple Report Types available that can be Customized and Saved to best suit your needs.


NATS5 Report Features

You will find standard features across each report in your NATS5 reporting admin:


NATS-Report-example.png


  • 1: Mark As Favorite - Marking a report as a "favorite" will add it to the top of the report list in the left-hand navigation.
  • 2: Breakdown - The report breakdown defined how data is grouped within your table (and graph if applicable).
  • 3: Save Report - Saving your report will save all the settings (search, breakdown, period, Focus, etc.), and will add a link to the saved report to your left-hand navigation.
  • 4: Advanced Search Filter - Clicking the large textbox on the page will allow you to add search parameters to filter your report data easily.
  • 5: Period / Date Range - The date range of your search criteria
  • 6: Dump Report Data - This will provide a CSV dump of the data within your report.
  • 7: Report Focus - A Focus is the collection of Data displayed in your Graph and Table. You can add your own Focus, and switch between them.
  • 8: Enable/Disable Graph Points - Clicking any of the data points displayed above the graph will toggle the respective data within the graph below.
  • 9: Report Graph / 10: Report Table - A visual representation of the data within your report.
    • The data points here are defined by the Focus used by this report.
  • Report Navigation - Saving a report will add that report into your left navigation list. Marking a report as a Favorite will add it to the top of the list.


Filtering Your Report Data

Advanced Search Bar

NATS5-Advanced-Search-Menu.png


The Advanced Search Filter allows you to refine your search results using a simple menu system to select your search criteria. To get started:

  • Click the text box and a menu will appear.
  • Using your mouse, finger, or the Up and Down arrows will allow you to select your search parameter. For example, "Site".
  • Next, select your comparison operator. Depending on your search parameter, you may see:
    • = (equal)
    • like
    • > (greater than)
  • Select (or type) your search value. For example, the name of a Site.

Once selected, the search parameter will be applied, and the data in your report will be automatically refreshed.


Period / Date Range

You can also set the Date Range of the data to include in your report by clicking the Period button next to the Advanced Search box:

NATS5-Period-Menu.png

Many common date ranges are included within the period menu, like This Period, Last 30 Days, Last Month, etc. But you can also specify a date range by clicking Free Form at the bottom of the menu.


Report Focus / Graph and Table Data

The data points displayed in the graph and table of a report (like Raw Hits or Total Expenses) is called a Focus. NATS comes with one or more specific Focuses for each report type. For example, your Profit and Loss report includes:

  • Summary focus: This provides a simple summary of all your profit and loss data.
    • Data Points: Raw Hits, Raw Hit / Joins Ratio, Unique Hits, Unique Hits / Joins Ratio, Total Joins, Total Income, Total Expenses, Net
  • Traffic focus: This provides details about the new surfer traffic and new signups
    • Data Points: Raw Hits, Unique Hits, Initial, Initial Amount, Trial, Trial Amount, Total Joins, Total Income, Total Expenses, Net

You can switch between the Focuses within your report by clicking the select box above the name.

NATS5-Focus-Select.png


Customize Focus

NATS comes with a few specific Focuses, as noted above. You can also add your own to include whatever data points work best for your reporting needs. To get started, click the button next to your currently loaded Focus.

NATS5-Focus-Action.png

From here, you will be able to:

  • Edit this Focus
  • Duplicate your Focus
  • Add a new focus


Customize Modal

Clicking the button to the left of the name of the Focus will display a list of actions. No matter which you click, a modal will be displayed with two tabs:


Details Tab

NATS5-Focus-Edt-A.png

This tab will allow you to set the name of your Focus, as well as a description.


Data Points Tab

NATS5-Focus-Edt-B.png

This tab allows you to select the data points for that Focus.

  • Data Points Available (left column) - The left column in the modal shows all the data points (like Raw Hits or Total Expenses) available for this report type.
    • Typing in the text box above the list will narrow the data point list.
    • Clicking the plus icon (+) next to a data point will allow you to Enable/Add that data point to your Focus. Visually, you will see if added to the right column within the modal.
  • Enabled Data Points (right column) - This will show you all the data points that have been added to this Focus.
    • You can change the data points' order by moving them up and down within your list. This will change the order in which they are displayed in your table and graph.
    • You can enable the data point in the Table or the Graph (if applicable) by checking off the respective checkbox.
      • Not all data points can be displayed in the graph.
    • You can remove that data point from your Focus altogether if you click the Remove button.


A few things to note:

  • You can not edit a focus that comes with NATS. For example, the Summary Focus on the Profit and Loss report.
  • You can not add a Focus with the same name as another Focus already in your system.
  • You must click the Save button for your changes to take effect.
  • Any Focus you create will be available for all the users with access to your reporting admin.


Marking a Report as a Favorite

Marking a report as a Favorite will give you easy access to this report by placing it at the top of the report list in the left-hand navigation. Besides marking a report as a favorite, you can also create your own report Groups that show up at the top of the left-hand navigation.

NATS5-LeftNav.png

To mark a report as a Favorite, click the Star icon to the left of any report you are viewing.


Saving a Custom Report

You can save your current search filters, date range, data breakdown, and even your default Focus into a new custom report for quick access in the future.

You can also save as many reports as you like. For example:

  • Create a Profit and Loss report for a specific Affiliate Group, broken down by affiliates, for the last 90 days, using a focus with specific data about their sales.
  • Create a Profit and Loss report for a specific Site and a specific Biller, using a focus with specific data about negative transaction types.

To start:

  • Navigate to the report you may want to save. For example, the Profit and Loss report.
  • Change your search filter, breakdown, etc., to what you would like to include in your report.
  • Click the Save Report button in the top right of the page. A modal window will appear:

NATS5-Save-Report.png

Once saved, the new report will be added to your report navigation list. And if you marked your new report as a Favorite, you will see a quick link to the news report at the top of the report navigation list.

Updating a Custom Report

You will be able to use your custom report just like any other report in your system. You can:

  • Change the filters
  • Update the date range
  • Switch to a new focus

If you change a setting when on a custom report, you may see a change to the buttons on the top right side of your report page. For example:

NATS5-Save-Report-As.png

This will let you know of a change to the report and allow easy access to review the changes, save the changes without review, or save your report as something new.