Internal Link Decoration and Campaign Parameters
You are able to add internal campaign parameters or decorate links within Viafoura's tools to attribute sources of traffic on your site to specific features. Viafoura allows you to add such parameters through the "Site Settings." Under "General" settings, you can enable the "Enable Internal Link Decoration/Campaign Parameters" setting and use the "Internal Link Decoration/Campaign Parameters" field to automatically add specified parameters to all automatically generated links within Viafoura products.
You can include UTM parameters, Campaign ID, or any other custom URL parameters within any automatically generated link.
Notes on Usage:
-
Affected Components: The parameters you paste into the "Internal Link Decoration/Campaign Parameters" field will be added to all of the following Viafoura components:
- Active Articles widget displayed under comments
- Standalone Trending Articles widgets
- Links from Tray Notification/Feed
- Share functionality for specific comments/replies
-
Excluded Components: At this time, this setting will not add parameters to any links inserted by visitors or editors within comments, blog posts, engagement starter, or chat messages. Additional tracking options may be added in the future.
Shortcodes
Use these shortcodes in your tracking parameter to include information about the Viafoura product and/or feature that generated the link.
| Shortcode | Outputs | Description |
|---|---|---|
| VIAFOURA_PRODUCT | conversations_top_pages | links from the Active Articles widget, usually displayed under comments |
| standalone_top_pages | links from the Standalone Trending Articles widget (list format) | |
| standalone_content_recirculation_with_ads | links from the Standalone Trending Articles widget (cards with ads) | |
| conversations | links from Share functionality for specific comments/replies | |
| tray_notification | links from Tray Notification/Feed |
Parameter Formatting
- Leaving the "Internal Link Decoration/Campaign Parameters" field empty, adding a string with no equal (=) sign, or adding a single parameter with no value (e.g., abc=) will effectively disable the functionality.
- Adding an extra & at the beginning or end of parameters will remove it.
- Adding an extra ? to parameters will URL encode it (i.e., it will add %3F to the URL). Adding any other special characters will result in them being escaped similarly to how ? is handled.
- After saving your settings, you may notice & being replaced with &. This occurs due to certain settings functionality (escaping characters for security reasons). In actual links, & will be replaced by &.
Updated 2 months ago