Supported Meta Tags
The Content.ad widget detects the title, image and URL for each page of internal content, but they can also be explicitly defined by using meta tags. Content.ad recognizes the following tags:
- ca_title
The title that should be used by the widget when displaying the page as a recommended article. - ca_image
A full path to the image that should be used by the widget when displaying the page as a recommended article. - ca_url
The URL that should be used when sending users to a piece of content. By default the system uses the first URL it encounters but this can be controlled through the use of this meta tag.
Supported Widget Call Parameters
- id [required]
Default Value: none
The unique identifier for your account (API Key).
- wid [required]
Default Value: none
The unique identifier for your widget.
- d [required]
Default Value: none
The unique identifier for your domain.
- contentRating
(widget setting)
Sets the maximum content rating of the ads that appear in the widget. Accepts “G”,”PG”,”PG-13″ and “R”.
- serve
Default Value: 1
Whether or not to serve a particular page as recommended content. Set to 0 on pages which should not be served as related content – such as a home or category page.
- lazyLoad
Default Value: 0
Whether or not the widget should load after the rest of the page has completely loaded. When set to 0, the widget may load faster but it could also affect the performance of other elements on your page.
- pubdate
Default Value: none
The date on which a page was published. This can be used to filter out old content that you don’t want to be served. Format: yyyy-mm-dd hh:mm:ss
- blockIntl
Default Value: 0
Whether or not the widget should return results for visitors outside of the US and Canada. When set to 1, the widget will not display for users outside of these countries.
- blockMobile
Default Value: 0
Whether or not the widget should return results for visitors on mobile devices. When set to 1, the widget will not display for mobile users.
- blockDesktop
Default Value: 0
Whether or not the widget should return results for visitors on desktop or tablet devices. When set to 1, the widget will not display for desktop or tablet users.
- loadMultiple
Default Value: 0
In the event that the same widget will be dynamically reloaded on the same page without a page refresh, this must be set to 1. Most implementations will not need to set this.
- pre
Default Value: none
Adds this value to the beginning of all links in the rendered widget. This is useful for adding macros when serving the widget through a third party ad service such as Google DFP.
- internalTarget
Default Value: _top
Sets the value of the “target” attribute on internal links (more info).
- externalTargetDefault
Value: _blank
Sets the value of the “target” attribute on sponsored links (more info).
- exitPop
Default Value: false
When set to true, the widget will only appear when the user is about to leave the page. Required for Exit Pop widgets. More info
- exitPopMobile
Default Value: false
When set to true, the widget will only appear when the user scrolls up or reaches the bottom of the page. Required for Mobile Slider widgets. More info
- exitPopExpireDays
Default Value: none
When widget is an exit pop, sets the frequency that the widget appears for each user. Accepts a decimal defining the number of days. When not set, the widget appears once per session. When set to 0, it appears on every pageview.
- clientId
Default Value: none
Assigns a tracking parameter to any clicks generated from this impression. Accepts any string up to 64 characters.
- clientId2
Default Value: none
Assigns a tracking parameter to any clicks generated from this impression (separate from clientId). Accepts any string up to 64 characters.
Please note: The parameters clientId and clientId2 should not be user-specific values. More Info
Example
(function() {
var params =
{
id: "821fb445-6e5e-47fd-9548-c91708f89a4a",
d: "dGVzdGluZzMyMS5jb20=",
wid: "01234",
clientId: "[your code to pull the utm_campaign value]",
clientId2: "[your code to pull the page title]",
cb: (new Date()).getTime()
}; var qs=[];
for(var key in params) qs.push(key+'='+encodeURIComponent(params[key]));
var s = d.createElement('script');s.type='text/javascript';s.async=true;
var p = 'https:' == document.location.protocol ? 'https' : 'http';
s.src = p + "://api.content.ad/Scripts/widget2.aspx?" + qs.join('&');
d.getElementById("contentad01234").appendChild(s);
})();