Guides
Shape Help Center

2025

What's New for the week of May 26th, 2025?

Facebook Ads & Facebook Page Insights: Meta Graph API v25 Upgrade

Product Area: Integrations / Reporting
Jira: DT-2342

We've upgraded both NinjaCat's Facebook Ads and Facebook Page Insights connectors to Meta's Graph API v25. Alongside the Facebook Ads v25 upgrade, this release also restores reporting for Page Impressions (affected by Meta's November 2025 Pages API change) and adds new paid/organic breakdown metrics at both the Page and Post level on the Page Insights side.

What's new — five new metrics (Facebook Page Insights):

  • Page Media Views (Paid)
  • Page Media Views (Organic)
  • Post Media Views (Paid)
  • Post Media Views (Organic)
  • Post Media Views (Followers)

The Page-level paid/organic split is new capability with no prior equivalent in NinjaCat. The Post-level breakdowns replace previously-deprecated post impressions paid/organic/fan metrics.

What's changed:

  • The metric previously labeled Page Impressions is now labeled Page Media Views, matching Meta's naming. Existing saved reports, dashboards, and scheduled deliveries continue to work — the metric's identity is unchanged, only its label and backend API call have moved.
  • 11 legacy Page Impressions variants (paid, viral, and the 9 story-type breakdowns) have been deprecated by Meta and are no longer available when building new reports. Saved reports will continue to return data through Meta's current API window; once Meta retires them later in 2026, those reports will stop returning data for those columns. Where Meta has provided a replacement, we've mapped to it. Viral-reach has no equivalent in the new API.

What you don't need to do:
Existing reports, dashboards, and scheduled deliveries continue to run on both connectors. No migration step required.

What's New for the week of February 17th, 2025?

Customizable Comparison Arrows

Product Area: Template Editor

We have added new customization options for comparison arrows in the Template Editor's Scorecard and Table widgets. Users can now:
• Change arrow styles using predefined types (more styles coming soon)
• Customize arrow colors for increase, decrease, and neutral states
• Access these options via Template Settings under the Styling section
• Further personalize individual widgets by selecting Custom arrow colors
These enhancements give users greater control over their template aesthetics.
To customize your arrows:

  1. Go To The Template Settings Tab
  2. Navigate to Styling
  3. Adjust comparison arrow styling and color preferences
  4. For widget-specific changes, select Custom under Arrow Colors.

Account-Specific Dashboard Template Configuration

Product Area: Dashboard

We have added functionality allowing account-specific dashboard template configurations. Users can now customize dashboard template selections at the account level through the following path:
Account Command Center > More Actions > Settings > Dashboard tab
This new feature enables:
• Including/excluding specific templates per account
• Template selection visibility control
• Customized dashboard per account
Templates excluded from an account's dashboard selection will not appear in that account's dashboard view or downloads. This enhancement provides greater customization flexibility at the individual account level, eliminating the need to create multiple templates for minor variations.

What's New for the week of February 3rd, 2025?

Small but Mighty Update: Template Editor Enhancement

Product Area: Template Editor

We've made another small but powerful improvement to the template editor! When adding or editing data source, dimension, metrics, or filters, your selected items now stay pinned to the top while scrolling through the list. This makes it much easier to track what you've selected, especially when working with data sources that allow multiple selections.

LinkedIn Organization Update to 202501

Product Area: Integrations

We are thrilled to announce that we've updated LinkedIn Organization to the latest version! We are now on 202501. Customers should not notice any changes to the functioning of our integration.

Addition of LinkedIn Organization Dimensions & Metrics

Product Area: Integrations

These are the dimensions and metrics added to the LinkedIn Organization Provider which have been specifically requested:
Requested Field / NC UI Name
Post Caption /Post Commentary
Post Image / Post Image Preview
Post Title / Post Title (Article)
Post Type / Post Type
Audience / Post Audience Distribution
Shares / Post Reposts Gained (Organic)
Reactions / Post Reactions Count (Total of: Post Likes Count (total), Post Empathy (total), Post Praise Count (total), Post Maybe Count (total), Post Interest Count (total), Post Appreciation (total)), Post Likes Gained (Organic) and Post Likes Count (total)
(Note: Requested metric isn't available in the API. They are requesting Reactions gained and lost over a set time period, and outside of the "Like"-reaction, this data isn't available)
Comments / Post Comments Gained (Organic)
Engagement also known as Engagement Rate / Post Engagement (Organic)
Impressions / Post Impressions Gained (Organic)
Reposts / Post Reposts Gained (Organic)
Clicks / Post Clicks Gained (Organic)
CTR / Post CTR (Organic)
Unique Views / Post Unique Impressions
Views Metric / Post Impressions Gained (Organic)
Additional Fields Added
Dimensions: Post ID, Post Description (article), Post Created At, Post Last Modified, Post Link, Post Published At, Post State, Post Visibility, Post Image Status, Post Question (poll)
Metrics: Post Appreciation (total), Post Top-Level Comment Count, Post Comment Count, Post Empathy (total), Post Interest Count (total), Post Maybe Count (total), Post Praise Count (total)
Potential Delays in Data Retrieval
Due to the current structure of our API, requests for data can sometimes take tens of minutes to complete. This means that when you make requests from the template editor, there is a possibility that they may time out. However, please note that even if a request times out, it may still process in the background and the data will be cached for up to one day.
Strategy to Validate Data
Our logic filters out any posts created after the end of your requested date range. This means that if you select a date range that goes further back in time, we can eliminate more recent posts from the data retrieval. By doing this, we can significantly decrease the number of posts we need to check, which should lead to faster request completion times. In some cases, this optimization may even turn what would have been a timing-out request into one that completes successfully.

Chart Widget Enhancements

Product Area: Template Editor

We have made several enhancements to chart widgets to give you more control over your visualizations:
Year Display Options

  • Select year format in any chart: 4 digits, 2 digits, or hidden
  • Affects all year displays on dimensions and data labels
    Mixed Chart Type Controls
  • New option to control layer order in mixed charts (e.g., column and line)
  • Choose whether primary or secondary chart appears on top
  • Default setting keeps primary chart on top
  • Toggle "Secondary Chart on Top" option to adjust layering
    Data Label Positioning
  • Available for all chart types
  • Adjust data label position when enabled
  • Prevents visual interference with chart elements.

Paused Report Status Now Visible in List View

Product Area: Reports List

We've added a new "Paused" status to the report list page. Previously, you could only see if a report was paused by clicking the "More Actions" menu. Now, paused reports are clearly visible in the main list view. You can also filter specifically for paused reports using the status filter at the top of the page.

Success Center

Product Area: Overall App

We are excited to announce the release of our new Success Center for Customer Success. You'll notice a new Success Center navigation button located below Settings in the main menu.
This feature allows us to deliver in-app messages and onboarding journey checklists directly to users.
Please note that we have removed the "Resources" navigation item, as this functionality is now handled by our new chatbot system.

• Users without Contact NinjaCat permissions will not see the Success Center.

What's New for the week of January 27th, 2025?

Fixed Management API issues, allowing for the ability to add mapping to several data sources

Added the ability to add/update mappings through the https://api.ninjacat.io/management_open_api/mapping endpoint not only for Meta Ads and Google Ads but also for Bing Ads, GAM, DV360 and Koddi

Standard Datasets

Product Area: Data Cloud

There are now 3 new datasets available to add to an Agency (by NinjaCat, upon request) that contain account settings and account group information.

  1. ACCOUNT_GROUPS -- All advertisers w/ their assigned Account Group Values
  2. ACCOUNT_NETWORK_SETTINGS -- some network settings as well as currency settings per network.
  3. ACCOUNT_REFERENCE -- containing Account Owners, External ID, Website, and other settings from the Account Command Center.

What's New for the week of January 20th, 2025?

LinkedIn Update to 202411

We are happy to announce that we've updated LinkedIn to the latest version! We are now on 202411. Customers should not notice any changes to the functioning of our integration.

FB Ads and FB Insights Update to V20

We're happy to announce that we've updated both FB Ads & FB Insights to V20. Customers should not notice any changes to the functioning of our integration.

Google Ads Update to V18

We're happy to announce that we've updated Google Ads to the latest version! We are now on V18. Customers should not notice any changes to the functioning of our integration.

Apple Search Ads Update to V5.1

We're happy to announce that we've updated Apple Search Ads to the latest version! We are now on V5.1. Customers should not notice any changes to the functioning of our integration.

What's New for the week of January 13th, 2025?

Fixed API Issues with Report Downloads and File Names with "/" or "\"

  • Adjusted the API logic to provide clearer error handling for large or complex files. For cases where a report exceeds a threshold (9 MB), the API now returns a direct URL for downloading the report instead of failing with an error. This link will expire 60 mins after generation.
  • We changed "/" and "\" to "_" in the file names which resolved the issue of these invalid characters making file names invalid and causing errors.