There are two ways Acrolinx can recognize your content. The approach you choose will depend on your organization's workflows and content types.
Notice
When you switch between these recognition methods, it fundamentally changes the way Acrolinx classifies your content for Analytics. This can make it difficult to compare data from before and after the switch. To get the most valuable Analytics, we recommend that you don't switch between these methods regularly.
-
Content Reference - lets you define exactly how Acrolinx should recognize your content.
-
Content Fingerprint - lets Acrolinx recognize your content for you.
Tip
Not sure which approach to take? Read our reference guide for more information.
In this method, Acrolinx uses the file path as the unique reference for your content by defailt. Basically, what you see as the "Source" in a Scorecard is the default reference.
 |
To configure the Content Reference, follow these steps:
-
In the Dashboard, navigate to Analytics > Administration > Content Recognition.
-
Select Content Reference.
-
Navigate to Guidance Settings > Content Profiles, click on the relevant Content Profile. For our Markdown example above, we'd pick the Markdown Content Profile.
-
Navigate to DETAILS > Content Reference.
-
Select Use part of the content as content reference, and enter the XPath for your stable attribute.
-
For example, your XPath could look like this if you use the "slug" parameter in Markdown front matter:
-
For example, your XPath could look like this if you use the html title tag <title> from your content as content reference:
-
To test if your content reference is working, check a relevant file, and go to the Scorecard Archive dashboard. In the Document column, you should now see the content reference that you defined instead of the file path.
If you have a reliable, stable attribute that applies to all iterations of each piece of content, the Content Reference is a useful solution.
Notice
Because the Content Fingerprint method automatically classifies your content for you, similar sets of articles can potentially result in false positives. Before you decide to use this method, consider the nature of your content and decide if it’s the best option for you.
To set a Content Fingerprint for all of your content, follow these steps:
-
In the Dashboard, navigate to Analytics > Administration > Content Recognition.
-
Select Content Fingerprint.
Once you select Content Fingerprint as the method to recognize your content, this will apply to all future checks. It doesn't apply to existing check data.