A lot of these pages may contain content that should not come back as recommendations. The content to exclude is different for different use cases, but typical examples are front pages, section fronts, image galleries, expired events etc. There is a variety of approaches available to blacklist, depending on the volume and extent of the exclusions.
By default Cxense will only display pages that are identified as articles in recommendations.
For deleted content
By default Cxense will not delete content automatically. For pages which are gone (deleted) completely, send an /document/delete API call with the URL of the deleted content.
The recommended approach to prevent content from coming back as recommendations is to mark up the html of the pages with the
cXenseParse:recs:recommendable tag as described in the Cxense Content - Review and Refinement section.
Optional an explicit API call to /profile/content/push, with the just changed URL could be made, to force Cxense to reprocess the page ASAP.
If the sections of excluded content frequently changes or are difficult to update, or if different Cxense Content widgets will deliver different parts of the content, exclusions can also be done as part of the content configuration. This is done by appending an "
and not" fragment to the content-configuration query parameter as described on Content settings object.
Example: Request all content except what is stored under the top level sport section
Backend Exclusion Rules
However, if there are sections of your site where it is impractical to tag every page with the
cXenseParse:recs:recommendable tag and/or the number of pages in that section is very large, you can contact firstname.lastname@example.org to have the section added to content exclusion lists so they are not placed in the recommendations engine.
For sections of the page that is currently not used for recommendations, but might be used at a later stage, it is better to apply query side filtering using the
Exclude individual articles through API usage
Cxense offers "override exclusion" of articles by using the Cxense /profile/content API. This can be used in situations where there is either no direct access to the CMS rendering the HTML content, or where the content must be removed before it would be practical to have the change made to the HTML.
- See the /profile/content API documentation for more background details for how the API works, but this is a specific example to this usage. Check API authentication how to install and use
The placeholders are:
site_group_id- analytics account id (technical term: site group) owning the site where the article is hosted
site_id- site id owning the article
url- the url for the page to remove from recommendations
- If the change must become effective within a few minutes, either log into the Cxense Analytics UI and click the refetch button for the article, or use the /profile/content/push API to recrawl the article right away. Otherwise it will be updated the next time the article is automatically recrawled, which depends on i.e. the number of page views it currently gets.