Skip to main content

JSON Integration: Core Integration

Client-side JSON integration returns content as a single block of JSON, which your webpage formats and displays.

For every webpage you want to integrate, identify the correct page type and include the JavaScript code on your webpage.

Required page types (every site must integrate these pages)

  • Item page: A page that shows detailed product information for a single product.
  • Purchase Complete page: The page displayed to customers immediately after they successfully purchase their items.

Common page types (most sites integrate these pages)

  • Home page: A generic page that does not have a specific product or product category associated to it.
  • Search page: Displays the results of a keyword search performed by the shopper.
  • Category page: Displays a group of related products or a group of sub-categories that help the customer navigate deeper into the site. You may call it a department page, genre page, vertical page, etc., depending on your nomenclature.
  • Brand page: Features a specific brand.
  • Add to Cart page: The page (or modal or interstitial) that is displayed just after shoppers add products to their carts.
  • Cart page: Displays the entire contents of a shopper’s cart.
  • Error page: Displays a system or page error.

Special page types

  • My Page: A page on your site that is about an individual shopper.
  • Generic page: If you have a page that doesn’t fit any of the other page types, you might consider using the generic page.
  • Add to Registry page: The page that displays right after a shopper has added an item to a registry or wish list.

Integration Code Basics

In each example, you’ll see the personalization file, callback function, and a primary code block.

  • Include the personalization file just below the tag, before the callback function.
  • The callback function must come after the personalization file and before the primary code block.
  • The primary code block sets the page context and must have some values set dynamically. Include the Primary code block just below the personalization file.