Add isobject Tags

You must embed the <isobject> tag in ISML templates to collect active data from customer storefront activity. This tag can appear any number of times in the same page, with no limit, but the tag must be placed where <script> tags are valid.

Note: See Add JavaScript Alls for DHTML Widgets if you use DHTML widgets in your storefront.

If the same product appears in multiple tags in the same page, for the same type of count only the first one is counted. It's unnecessary to wrap all product representations that result from searches, but those that are not wrapped are excluded from analytics collection. It's unnecessary to wrap the HTML content for every representation of every product that appears in the site. For example, it isn't always appropriate to wrap products in pages that show the contents of the cart.

You must set the <isobject> tag <view> attribute to one of the following values, or data won't be collected.

Value Collects Details
detail

product views

Each HTML page containing an <isobject> tag with view="detail" counts as one product view for the product.

This value enables you to tag your site to collect hits on product information. The <isobject> tag must be placed so that it wraps the ISML that represents the product details on a product detail page.

Most sites use only one template to render product information on a product detail page. You can also tag templates that render a Quick view or show the products in a set.

The tag results in an increment of the number of product views for a product. There are no clear rules about how many or what kind of details must be shown of a product for it to count as a view instead of an impression. To make the impressions and views metrics meaningful, the views and impressions attributes must not be used interchangeably. You might want to require that the storefront customer initiate an action to get more information about a product in order to consider it as a view. This action can call a quick view, click through to the product detail page, or click through on a product set to see details about the products in that set.

recommendation

product impressions

Each HTML page containing an <isobject> tag with view="recommendations" counts as one product impression for the product.

This value enables you to tag your site to collect product recommendations hits. The <isobject> tag must be placed so that it wraps the ISML that represents each product recommended to the storefront customer.

Each template must wrap its recommended products in this tag, or those products are excluded from analytics collection.

A site can have multiple templates that render recommendations, including the home page, landing pages, product detail pages, and in slots, search results, order confirmations, and cart views. If your site uses many different templates to render recommendations, you should create a common template that renders the product information included by these templates, and add the <isobject> tag there. You can also place the recommendation type in the pipeline dictionary or make it a module attribute.

The <isobject> tag increments the number of product impressions for a specified product and tracks that the product was recommended to the customer as part of the visit. The fact that it was recommended stays in effect until the customer ends the visit or completes the ordering process.

The same product can only count for one product impression per page using this method; if multiple tags specify the same product, it's only counted once.

setproduct

product impressions

Each HTML page containing an <isobject> tag with view="setproduct" counts as one product impression for the product.

This value enables you to tag your site to collect hits on products that are part of a product set.

The <isobject> tag must be placed so that it wraps the ISML that represents each product that is part of a product set.

Most sites only have a few templates that render the product detail page for a product set. Each product set product detail page template must wrap each product in the set in this tag, or those products are excluded from analytics collection. As a best practice, don't include the tag unless the products in the set are represented on the page. For example, if a product set is rendered in a slot among other recommended products, it isn't appropriate to add the tag for the products in the set if they are not represented individually to the customer. When the set products are shown in greater detail, it's better to consider the product detail value.

The <isobject> tag increments the number of product impressions for a product. Even if the product has some representation on a page, if the page isn't intended to merchandise the product, there is no need for a tag. For example, if a product set doesn't have its own image and the images of the set products appear instead; this by itself isn't enough reason to tag the set products

The same product can only count for one product impression per page using this method; if multiple tags specify the same product, it's only counted once.

searchhit

product impressions

Each HTML page containing an isobject tag with view="searchhit" counts as one product impression for the product.

This value enables you to tag your site to collect hits on search results.

The <isobject> tag must be placed so that it wraps the ISML for HTML components that represent the product: product name, image, callout, price, swatches, and other components.

Use the instance type of ProductSearchHit in the tag's attribute, when the view is of type searchhit.

Most sites use only a single template to render products in search results. A site with different search result layouts for different categories might have multiple templates.

When a search is performed by other than the storefront customer, other view values might achieve more meaningful results. For example, when a search is performed using the API to determine the products to show in a slot, the product detail or recommendation view types might be a better choice, depending on the level of detail shown for the product and the merchandising intent.

The <isobject> tag increments the number of product impressions for the wrapped product. The same product can only count for one product impression per page using this method; if multiple tags specify the same product, it is only counted once.

If you don't wrap a product representation in a template, analytics data isn't affected by that representation in that template. You can place this tag anywhere an ISML template that contains a representation of a product with the intent of merchandising that product for sale on the site. If a product representation is tagged but doesn't exactly match one of the view types listed previously, select the view type that most closely matches the intent.

Examples

<isobject object="${ProductSearchHit}" view="searchhit"><div class="image">...</div></isobject>
 <isobject object="${pdict.Product}" view="setproduct">
 <isinclude template="product/components/subproduct"/>
</isobject>
<isobject object="${product}" view="recommendation">
 <isproducttile product="${product}" showswatches="${true}" showpricing="${true}" ​showpromotion="${true}" showrating="${true}">
</isobject>

SiteGenesis and Examples

The following table shows examples of the <isobject> tag, and identifies the SiteGenesis templates that contain an example of the tag.

Tag example SiteGenesis template
<isobject object="${pdict.Product}" view="detail"> product/productdetails.isml
<isobject object="${pdict.Product}" view="setproduct">

product/producttocontentPS.isml

product/components/bonusproduct.isml

<isobject object="${ProductSearchHit}" view="searchhit"> search/productgrid.isml
<isobject object="${product}" view="recommendation">
Note: This attribute does not currently aggregate data and is included for future development.
slots/product/product_1x4.isml

Related Links

Tagging Pages for Data Collection

X Privacy Update: We use cookies to make interactions with our websites and services easy and meaningful, to better understand how they are used and to tailor advertising. By continuing to use this site you are giving us your consent to do this.