Display Tracking
As a data licensee, you will receive a unique URL for each listing that points to an image on our servers. This URL is made available via the TrackingImageURL field on the Property Resource.
You are required, as a licensee, to display the image referenced by this URL on any webpage, mobile application screen, or other digital experience where a Listing is displayed to a consumer, in a manner that ensures the Tracking Image is loaded whenever the Listing is viewed.
The Tracking Image is a material component of our reporting, analytics, and compensation model. Failure to properly implement or maintain the Tracking Image constitutes a material breach of the licensing agreement.
Image Tag Specification
Licensees should place the following tag on each listing detail page, using the TrackingImageURL from that listing's feed data:
<img src="{TrackingImageURL}"/>Licensees at their discretion may modify this tag as follows
- alt property - You may add an alt property of your choosing. For example,
alt="Courtesy of"oralt="Tracking Image" - onerror property - You may add an onerror property to adjust the styling of the image should it fail to load. For example
onerror="this.style.display='none'" - style query param - You may append a 'style' query param to the TrackingImageURL to pick from one of several image styles. Options include
badge(default) andpixel. For example:
<img src="{TrackingImageURL}?style=badge" alt="Courtesy of" onerror="this.style.display='none'" />Style Parameter
There are two style options available for the Tracking Image.
- badge - This renders a 95x35 image of the Realtracs logo.
- pixel - This renders a 1x1 transparent pixel.
How it Works
When your listing detail page is rendered, the browser (or mobile app) will make a request to our servers for the image referenced by the TrackingImageURL. Once our servers receive the request, we will record the impression from your website and return a 307 redirect to an image to be rendered.
Display Requirements
We have no display requirements other than the image must be rendered anytime the listing detail is viewed. You may place the tracking image wherever you chose. It need not be displayed in a prominent location.
The tracking image cannot be lazy loaded nor can its retrieval be otherwise impeded. You may not establish a proxy or cache for the Tracking Image. The device where the content is displayed must make the request for the Tracking Image directly to the URL provided.