Configure web properties

  • Updated

In Optimizely Content Recommendations, you can configure Web Properties on the Content > Properties page. A web property represents your website within Content Recommendations solution. You can create unique tracking scripts for your site by adding web properties. 

Add a web property

To add a property, complete the following actions: 

  1. Go to Content > Properties.

  2. Click Add Web Property.

  3. Enter the following information:
    1. Title – Enter the name of the property.
    2. Hostnames – Enter domains and sub-domains you want to allowlist for content ingestion. Use separate lines for each name. 
    3. Collections – Enter a collection name, such as a theme or topic like finance or retirement, or expand the drop-down list to select from an existing collection.
  4. Click Save. 

Track using JavaScript

When you click Save, you are redirected to the Properties > My property > Tracking JavaScript page. This page provides on-screen instructions for setting up a property. 

In the Options section, complete the following:

  1. User Identification – Select the option that best describes the visitors of this property. 
  2. Automatic Event Tracking – Enable this option for sites that dynamically load content, such as with AJAX. This action requires manually triggering consume events. By default, this option should remain disabled.

  3. PDF Tracking – Enable to track PDF files. PDF tracking adds a function to the standard tracking script and picks up PDF links embedded on the page. If you click on the PDF link, it will trigger the scraping and indexing process. The PDF content is indexed, and you can use this to segment, assign to deliveries, and return in Content Recommendations.

    You can also add an RSS feed to enable PDF tracking.
  4. Click Done.

In the Installation & Usage section, you can find information on using a custom solution, inserting canonical tags, adding published dates, and implementing a JavaScript snippet. Use this information only if you are deploying with a manual installation. If you installed Content Recommendations using a NuGet package, you do not need to deploy a separate tracking script, as tracking is included in that installation.  

Find the following information in the Installation & Usage section:

  1. Caveats – View the information on which websites may require a custom solution to support tracking properly. Contact your customer success manager if you need to use a custom solution.

  2. Canonical Tags – See Consolidate duplicate URLs for information on using canonical meta tags. Canonical tags can help prevent article duplication issues. 

  3. Published Dates – Click Copy to Clipboard to copy the meta tag of the published date of your content. The published date is only imported if it contains the relevant meta tag. You must add these tags, particularly if filtering by published date is useful to you.  

  4. Include Code – Click Copy to Clipboard to copy and include the JavaScript snippet in the head of your webpage. Alternatively, if you use a tag manager like Google Tag Manager, you can use it to include the code. 

    Click Copy to Clipboard to copy the argument. When you dynamically load your site, you need to manually trigger the system's tracking by calling track with the consume argument. If you do not manually implement this call, no consume events are tracked. 

In the Optional functionality section, you can find additional information on tracking events, tracking conversions, and recoding user identifiers. 

  1. (Optional) Track Events – Add event calls, like consume, like, dislike, share, comment, group, and exit to the webpage to track additional personalization events.

  2. (Optional) Tracking Conversions – Click Copy to Clipboard to copy and add a convert event to the webpage to track conversions. 

    Content Recommendations cannot ingest granular conversion-level data, such as order ID, price, and so on.

  3. (Optional) Recoding User Identifiers – Click Copy to Clipboard to copy and add an identify event to the webpage to assign identifiers to a user.   

View or edit the web property

After making changes to a property, return to the Properties page. You can view your property in the list of properties. Click Edit to edit your property. 

You are redirected to the Properties > Edit page. Click Save after you make the changes.