Skip to content

Parse.ly

Parse.ly is a content analytics platform that gives creators, marketers, and developers the tools to understand content performance and prove content value.

The Parse.ly plugin is integrated on all WordPress VIP sites via a lightweight platform plugin called wp-parsely. Versions of wp-parsely on VIP Platform WordPress environments are managed by VIP MU plugins. By default, the production branch of VIP MU plugins will deploy the current version of wp-parsely.

Advance notice and details of upcoming wp-parsely releases are posted in the Lobby. An upcoming version of wp-parsely is made available on the staging branch of VIP MU plugins where it can be tested on non-production environments. The staging branch of VIP MU plugins can be configured to deploy to a non-production environment in the Software Management panel of the VIP Dashboard.

Basic integration

The wp-parsely plugin automatically:

  • Adds the Parse.ly tracking code to all pages of a WordPress VIP site. The tracking code is a small JavaScript code that monitors user actions and relays them to the Parse.ly analytics servers.
  • Includes metadata in one of Parse.ly’s recognized formats (either JSON-LD or repeated meta tags) on all site pages. You can exclude this using the wp_parsely_metadata filter if valid JSON-LD metadata is implemented outside the Parse.ly plugin. By default on VIP, the non-conflicting meta tags format is enabled. This can be changed in the wp-parsely settings page on wp-admin.

The Parse.ly dashboard, where the collected data for a site is visualized, is accessible with a paid plan. VIP customers can reach out to their Relationship Manager to find out more, or by completing a Demo request.

Advanced integration

The wp-parsely plugin is customizable and extensible, both from the wp-admin interface and through PHP and JavaScript WordPress filters.

If needed, the wp_parsely_load_js_tracker filter can conditionally load Parse.ly’s JavaScript tracking code with PHP. If the conditional event is client-side, the wpParselyOnLoad and wpParselyOnReady JavaScript hooks can be used instead. 

For more information, refer to Parse.ly’s WordPress documentation.

Enable the wp-parsely plugin

Enable the wp-parsely plugin to load via VIP MU plugins by setting the wpvip_parsely_load_mu filter to __return_true in plugin-loader.php:

/client-mu-plugins/plugin-loader.php
add_filter( 'wpvip_parsely_load_mu', '__return_true' );

Disable the wp-parsely plugin

Disabling the wp-parsely plugin is not recommended.

  • The data collection powered by the wp-parsely plugin is required for future VIP Platform features, including possible CMS editor integrations; auto-tagging with natural language processing; content recommendation add-ons; site/channel traffic statistics; and content engagement dashboards. Disabling wp-parsely may result in a less-than-ideal VIP product experience in the future.
  • If there are concerns about the performance impact of the wp-parsely JavaScript SDK, refer to Parse.ly’s documentation, “Will the Parse.ly tag break or slow down my site?”
  • If Parse.ly page metadata is causing issues on a site, report the issues in a Support ticket so that the Support team can assist. In some cases, improvements can be made to the plugin to reconcile a site’s metadata.

Disable the wp-parsely plugin from being loaded by VIP MU plugins by setting the wpvip_parsely_load_mu filter to __return_false in plugin-loader.php:

/client-mu-plugins/plugin-loader.php
add_filter( 'wpvip_parsely_load_mu', '__return_false' );

Testing and troubleshooting

  • The Validator tool can verify the site’s plugin settings and confirm the Parse.ly tracker is tracking page data.
  • The browser’s developer tools can be used to confirm that a site is sending page views and/or video starts.
  • A site must be publicly available for the plugin to work. Sites under restricted access are incompatible.
  • Parse.ly can only collect data from publicly accessible URLs. Password-protected pages, or pages blocked from crawler user agents, are incompatible.
  • The Parse.ly WordPress plugin is compatible with decoupled WordPress setups. However, some work on the client application is required. Review Parse.ly’s decoupled documentation and reach out to the Support team if needed.
  • A comprehensive list of configuration options can be found in Parse.ly’s WordPress documentation.
  • Additional integration issues can be diagnosed with Parse.ly’s troubleshooting guide.

Last updated: November 14, 2022