NEW INTEGRATIONS

Instagram Organic 

• The associated Facebook network must be added at the agency level and the Instagram Organic network can be added at the advertiser level.
• Date is the date the post was created.
• Metrics for a post are displayed for the lifetime of the post. Without the Post Display dimension selected the metrics will show aggregated value returns for the date range specified pertaining to all of the post not displayed in the date range.
• Campaign Groups and Margins are not available for this integration.
  
• Insights will only be available for media posted after the owner of the Instagram account converted it to a business account.
  • (if an agency had an Instagram Organic account starting in January but did not convert their account to a business account until March; data will only display in reports from when the account was established as a business account [March] and data prior cannot be retrieved for all other previous posts.)
• Story Objects
  • Stories must have enough data before we can fetch insights.
  • Story insights are only available for stories that are active at the time of the request, even if you have enabled 14-day story retention via the app.
  • Exits, Replies, Taps Forward and Tabs Back are metrics for story media objects.

Yahoo Gemini: Added to Shinobi

• Yahoo Gemini has been ported to Shinobi. Now can be used in both Legacy and Shinobi reporting.
• The Yahoo network will be added at the Agency level and Gemini will be added at the Advertiser level.

Yahoo Brightroll

• Yahoo will be added at the Agency Level and Yahoo Brightroll is to be added at the Advertiser Level.
• The total retention period of reporting data is 2 years. In other words, you will not be able to retrieve campaign data that is older than 2 years.
• Rate Limits are set for Brightroll:
  
• It is common to receive RPM errors (Request Per Minute). Through testing it has been verified that a report containing 6 widgets showing data for "Last Month" is the limit before receiving a "Data Error" on a report ran. It is uncommon that a user would exceed this limit. This is being documented to communicate that it is not a bug if a user is running reports with many Brightroll widgets and continues to get this error.
• It is recommended that when setting up widgets using Brightroll that no account is selected to avoid reaching the Rate Limit. There is no way for us to gauge the count and large data sets could easily exceed the limit if the user is not cautious to this.

NEW FEATURES/IMPROVEMENTS

High Charts - Combination Chart

• There is now the ability to include a primary and secondary chart type, allowing combinations for metrics.
• Only one dimension is allowed to support Combination Charts
• The first metric selected will apply to your primary chart and each metric selected after will apply to your secondary selection.
  
• There is a drop down in your chart settings in the template editor
• Overrides and edits to the widget will apply to the entire chart.
  
• Pie Charts are not supported
• Bar/ Column charts can be used separately.
  • When used together you will not see combination results, if selecting a secondary of a Bar > Column or a Column > Bar; the results will display a bar chart.

Add Comparison to graphs

• The ability to add comparison values has been added to all graph types. There are four available comparison options:
  • No Comparison
  • Previous Period
  • Previous Month
  • Previous Year
• Note that green/red arrows are not displayed for graphs, nor are the difference values, only current value and separately the comparison value. A legend is provided to know which time ranges are compared.
• The only override option for graphs is the on/off toggle, to show the graphic of the compared value.
• Comparisons can be viewed for all common metrics
• Comparisons are not available for pie charts
• Comparisons can be stacked or displayed side-by-side
• If a user changes the graph type (e.g. from area to bar), comparison jumps back to no comparison.
  
  

Table Font Options

• These changes are for styling flexibility can be seen for both Table Widgets and Pivot Table Widgets
• Within Global Settings under the "Theme" section you will find a section labeled specifically for whichever widget you would like to apply global styling changes to.
  
• If you open up the Table section, you will notice that there are multiple tabs focused for specific areas within the table. You have the General Font Style tab which affects the entire widget, you have the Row Font Style tab which will affect the entire table excluding the title, then you have the Header Row Font Style tab which will only affect the header row, the Alternate Row Font Style tab which will affect the even rows starting (header excluded) and finally the Total Row Font Style which only affects the total row.
  • Within each tab you will be able to have control over the font, bold, underline, italics, colour, background colour, font size, and alignment.
    
  • It is important to understand that there are 3 levels for the bold, underline and italic options.
    • If you have the option not being used, it will be unselected (see "B" below), if you have the option using the default, it will have a line through it (see "U" below) and if you have selected it, the button will have blue border (see "I" below).
      
• Each tab to the right overrides the tab to left of it.
• You are able to override the global table settings on the widget level under the style section as well as being able to override the widget level settings on the metric or dimension level within the "Dimension Overrides" or "Metric Overrides" section. For each level of override, you will have all of the same options for styling available.
• Some things to note: 1) we are not able to control the background colour of the title, 2) The row "x rows not shown" background colour can not be controlled
  

Scorecard - Style Options

• Scorecard styling options have been introduced as follows:
  • Global Setting:
    • Font Size, Bold, Italic, Underline
    • Background Color
  • Scorecard Setting and Metric Override
    • Font, Color, Font Size, Bold, Italic, Underline
    • Background Color
• Global settings set styling values for the entire template.
• Widget level settings override global settings and are applied to the entire widget
• Metric level settings override widget settings and are applied to an area of the widget
• Settings have three states: selected, deselected, and inactive.
  
  • Selected settings are ones that apply the value of the setting, for example text is underlined:
    
  • A deselected setting means that users want the setting to explicitly not apply, for example users want text to not be italicized:
    
  • Inactive setting means that it neither selected nor deselected, in which case the setting assumes the default setting or the value from the setting in a previous level. For example, if widget level settings are inactive, then global setting values are shown, or if metric override settings are not used, then widget level settings are applied.
    
• Style options include: text emphasis (B/I/), colors, font style, and alignment.
  
• Two areas are defined within the widget, Main and Comparison
  
  
  

Default Font Settings in Template Settings

• H1 - H6, Primary, Footer and Headings now have the same styling options:
  • Font
  • Font Size
  • Font Color
  • Bold / Italic / Underline
  • Align (left, middle, right)
  • Vertical Align (top, middle, bottom)
    
• These settings exist on a global level, widget level, and once the text editor (Fruela) is invoked, the usual formatting settings there remain.
• Hierarchy takes effect, with text editor settings overriding widget level settings, which in turn override any global settings.
• Note that vertical alignment only exists on a global and widget level settings.

Add Comparison to the table with Date Dimension

• Date comparisons have been added to enable comparisons between two time ranges.
• Comparisons are available for the following aggregate date-based dimensions:
  
• For date dimension: comparisons are available for all date consolidation options:
  
• Comparisons are available for all common metrics such as clicks and cost. There are 4 comparison modes:
  
  
  • No comparison: no comparison is done
  • Previous Period: The number of days from the selected time-range is computed, and then the "previous period" is defined as the immediate time-range preceding the selected time-range with the same number of days. Aggregation comparison within the time-range is done by counting the number of days in the first aggregate period in the selected range (e.g. quarter), and then comparing it to the same number of days in "previous period" chronologically.
  • Previous Month: The comparison is done for the selected time-range, compared to the same time-range minus a month. Note that there are some exceptions to this as some computations must account for leap years, shorter months etc.
  • Previous Year: The comparison is simply the selected time-range minus one year on the start and end dates. Note that the number of days within each year may not be the same.
  • Exceptions: In some, more unusual scenarios, the number of consolidations that exist in each time period in the comparison may not be the same. For example, the number of quarters in one time range may be different than the number of quarters in the "previous period". In these cases, the consolidation periods are aligned chronologically.
• Typical override functions are available as in other comparisons:
  
• Note: Pivot tables are not supported with this feature.

Support Campaign Groups for All Data Sources

• All Datasources that have Campaign Name are now supported within Campaign Groups: Google Adwords, Bing Ads, Facebook Ads, Google Analytics, Twitter Ads, DoubleClick, The Tradedesk, Adroll, Centro, DoubleClick Bid Manager, Simpli.fi, Call Tracking, LinkedIn, AppNexus, Google Sheets, Zapier, and Email
• Each Campaign group can only have one of each unique data source. If you try to select the same data source as a filter for the same campaign group, you will not see the data source in the drop down option.
• There has been a small change to the UI in how you see and the filters to a campaign group.
  
• There are a few things to note for the behaviour of the template editor with respect to data sources that use mappings, such as Sheets, Zapier and Email Integration:
  

Custom Dimension Aggregation

• Users are now able to aggregate between various dimensions and any data sources.
• These apply to all table and graph types
• A new dialog lets users customize the name, display options, and select the dimensions across the data sources that were added for the widget. Note that a user can only select dimensions that are part of the data sources that were added to the widget.
  
• Various types of filters can be applied to the custom dimension.
• Custom dimensions cannot be selected to be part of other custom dimensions.
• Like values between aggregated dimensions are combined into a single entry. For example, if two dimensions have the same campaign name, the values will be combined for that name.
  

Agency / Account Settings - Margins for other providers

• There is now the ability to add margin values for all data providers on an agency level, advertiser level, and data source level.
  • Margin calculations are available for all data sources
• Margins are available on an agency, advertiser and data source levels for all data source, with the exception Email and Zapier (only agency and advertiser levels).

Add more Report Clips

• The following addition text editor clips have been added to the General Tab for the Text, Header and Cover Page Widgets:
• Account Owner Email, Account Website, Account Contact, Account Email, Account External id
  

Improve report error handling

• If a report runs and gets into the "Data Error" or "Critical Error" status, there will now be a report than can be accessed to provide more details of the underlying problems. You will be able to access this report by clicking on the status area.
  
• When you click on the status of a report, the error report page will appear containing information of the agency, account, report name, template name and each error stating the error name, its description, location (page) and widget title.
  
• If a report ends up with a data error due to one account failing that is part of an account group, each account group that is having an issue will be listed in the report.
• If a "critical error" arises, this report will only have a description appear

Facebook - Remap Conversions/Click Metrics

• Within Account Settings>Advanced tab under the Facebook Section you will now see the ability to select your conversion action, revenue action and click action to be used for what is displayed for conversion, action value and clicks metrics within Facebook Ads.
• For Conversion and Revenue there is a list of actions that can be chosen and choosing those actions will sum up the result. If nothing is chosen, it will use the default value.
• For Clicks, your option is either Inline Clicks or Clicks
• If the feature switch "Hide Legacy Reporting" is enabled, than the following field "Facebook action as conversion (Legacy)" will not be displayed.
  

Ability to whitelabel the navigation menu colour

• NinjaCat administrators now have the ability change the navigation menu colour for an agency with premium white-label options using a hex code of the desired colour. Speak to your Customer Success Representative for details, or email your hex code to: support@ninjacat.io.
  

Added a starl image display option for Star Rating metrics

• The "Star Rating" metric has been added to Vendasta, Google My Business, Call Tracking and FB Insights. This does not replace the "rating" metric that currently existed, but rather shows the rating metric in the form of stars.
• This metric is supported in the table and pivot table widgets.
• Comparisons are also supported.
• Star Ratings will be rounded to the nearest half star.
• There will be a new "display as" type found in custom metrics and in mappings for Email, Sheets and Zapier integrations.
• Any value that is >5 will only be displayed as 5 stars. To convert other star ratings to a 5-star rating, use a custom metric with the formula: (Rating * 5)/Max_Rating
  
  

Dashboards Version 2 - BETA

• Dashboards V2 is only available if the feature switch "Dashboard 2" is enabled. Speak to your Customer Success Representative to have this turned on for your agency.
• On the agency level, the dashboard version can be set within Setup>Agency Settings>Dashboard Setting
  
• By adding the "Dashboard 2" feature switch, the following tab will appear within the Reporting Navigation "Dashboards (Beta)" for users that have the "Manage Reports" or "View Reports" permission.
  
• Within Account>Settings, there is now a new tab called "Dashboard Setting" which sets the dashboard that will be used for this specific account. If you have set Version 2 (Beta) at the agency level, by default the dashboard version will be set to "Version 2 (Beta) and the dashboard will be set to use the Default Selection.
  
• In order to create various dashboard profiles you will have to go to Reporting>Dashboards (Beta) tab
  
• Some things to note on this dashboard profile list page:
  • You can query on name of profile, networks, # of accounts and # of templates
  • Just like with the report list and template list, the network icons are a union of all networks being used in that profile. For networks that have the same icon only one will be displayed.
  • # of Accounts is the number of accounts that are using V2 Dashboards and selected that particular profile.
  • # of Templates is the number of templates being used in that particular profile
  • If you click on "view", you will only be able to select which of the accounts that are associated to this profile you would like to access.
• Creating a Dashboard Profile:
  • You must give a name for a dashboard profile
  • You may or may not set a dashboard to be default. There can only be one default dashboard profile at a time. Those accounts that have set their profile to use "default" will change based on this setting.
  • By default, the "Last Month" date range will be set with 6 other predetermined dates to choose from. If you want the dashboard to have the option to select custom date ranges, then the toggle "Allow user to Select Custom Dates" needs to be selected.
  • In order to save a profile, you must add at least one template and provide a "view name" to it which will be used for the menu of your dashboard.
  • The templates can be changed it order by drag and dropping the row to reorder.
  • Under Dashboard Styles, you can choose whether you want to choose the account owner information in the header of the account dashboard and set a dashboard background colour and upload a dashboard logo.
    • If you do not select to upload a dashboard logo, it will the account logo and if none exists it will display the agency logo.
• When viewing the dashboard there will be a dropdown by the account name. This dropdown will include all accounts the current agency user has access to. If there are too many views and can not be fit on the allotted space a dropdown will appear to show all views to choose from.

Upgrade DCM to version 2.8

• Doubleclick 2.7 is being deprecated on Nov 30th, 2017.

Date Dimension - Quarter

• The Aggregate "Quarter" dimension has now been added

Facebook - deprecated Video15SecViews

• The Video15SecViews metric has been removed from the list of Facebook metrics

Make "Ad (Name) an aggregate dimension for DCM in Shinobi to

• Ad Name is now an aggregatable dimension between DCM, Bing Ads and Google Adwords

Simpli-fi Ad Image

• There is now the "Ad" dimension within Simpli.fi datasource similar to that of Facebook Ad showing the ad image and the file name.
• When you click on the image it will go to preview.

Support Arizona Timezone (America/Phoenix)

• We now have the following timezone available in the Time Zone dropdown locating in Agency Settings or Account Settings:
  • [UTC -07:00} Mountain Standard Time no DST

Facebook Insights - Post shares, like and comments metrics

• Within Facebook Insights when selecting the dimensions "Post", "Post Message", "Post Name", "Post Type" or "Post URL" the following metrics are now available: "Post Comments", "Post Likes" and "Post Shares"

BUG FIXES

Campaign Groups - Caching Issues

• The issue of caching has been resolved. This was mainly seen when changes to the campaign group were made and were not seen right away in the template editor such as adding a new campaign group, editing or deleting an existing one.
• Now any changes that are done in campaign groups are applied right away in the template editor.

Two banners on dashboards for White-labeled agencies

• There is now one banner on the top header.

Key Press Routing - no "Key Press" recorded

• Key press is now recorded in both the database as well as the NinjaTrack Call UI

NinjaTrack digest emails - busy calls missing

• NinjaTrack Daily Digest emails have been updated to include all calls including those that have not been completed.

Twitter Ads not handling empty data when checking if request is complete

• This was specifically for the case where the provider is called multiple times (like for account groups) and the second (or later) call has no data. The arrays were incorrectly being set to null instead of reset as empty arrays.

Help text update for Google Place ID

• When adding Google Place as an advertiser network, the help text now reads "To find the place id please go to Google Place Finder, search for the business and copy the place ID."

Account Commandrig Center - Data Sources description text does not wrap entire word.

• The description is now ellipsed.
  

Google Sheets with Account Groups corrected

• In the case where you use google sheets and account grouping, if you are NOT using a filter on the mapping level then if you select an account that is NOT part of the account you will only see data pertinent for that account alone. However, if you select an account that is part of the account group, then you will see all account data for the accounts that are part of this account group
• In the case where you use google sheets and account grouping where you have a filter set on the mapping level i.e. account name, Ninjacat ID, etc, then if you select an account that does not match the filter you will will see "No data was returned" message in the widget. If you select an account that is part of your sheet and filter and is part of the account group, you will then see all data for all the accounts that are part of your account group.

Removed NinjaTrack banner announcing "NEW" Exec summary widget

Adwords - Non-aggregate Adwords dimension Month of Year sorts out of order

• All non-aggregate dimensions for Adwords that have aggregate equivalents for dates have been removed.

Email Provider bug fixes

• lines in the csv (usually at the end) that don't have a column value for advertiser or date crashed the provider.
• emails without attachments crashed the provider.
• lines that ended with only /n and not with /r/n weren't being processed properly.
• Special characters will no longer crash the application, nor will cause the application to process the same email several times.

Campaign Groups need to be added for AppNexus

• Campaign groups can now be added for the AppNexus data source

Facebook - deprecated Video15SecViews

• The metric named Video15SecViews is no longer available

.csv report headings don't match .pdf report headings

• Both types of downloads are now matching the template editor for headers, including custom dimensions and metrics.

Last X Months not giving correct date range

• For both quick and relative date selection, the application now calculates the correct date range.