Supplier Buy Now Implementation Guide

Supplier Buy Now Implementation Guide


The following article discusses various ways to implement Buy Now as a popup or embed within a page as a Product Based Dealer Locator or General Dealer Locator. Buy Now can be configured to open to a specific market (Online or Local) to show one or more specific dealer type (rental providers, retailers, or service centers) and displayed in a variety of ways, including styled to match your brand.

Prerequisites

Configure Network To Support Buy Now

Since Buy Now operates from your website and network, it may be necessary to ensure that your network firewall is configured to allow the omacro Buy Now script to properly communicate with the omacro web services outside of your network. Learn more about Buy Now Service Information for Network Professionals.

Include Script Within Website

The example below demonstrates what's needed to integrate the Buy Now widget with your site.

For more specific details about the parameters that are supported by the Buy Now script, please see the appropriate referenced below.

Choose How You Intend On Using Buy Now

Buy Now can be used for specific products (a button on a specific product page or a group of similar products) or as a general way to direct traffic to dealers without targeting a specific product. The following definitions may be helpful:
  1. Product Based Dealer Locator 
    Used as a way to direct traffic to dealers with a specific product or family of products (variants) in mind. This version can be utilized with a single model product or a group of products with variations.



  2. General Dealer Locator
    Often placed as a link somewhere on the the site's header or footer (or somewhere on the homepage), the General Dealer Locator is intended to direct traffic to dealers without specific products in mind. This option is also often combined with the embedding feature to make a dedicated webpage featuring Buy Now. 


Triggering Buy Now as a Popup via Dedicated Buttons

You can trigger Buy Now as a popup in several different ways:

1. Trigger as a Single Button

By default, the buy now button can be triggered to open to the default market as specified within omacro settings (Buy Now -> Settings & Features) page. Depending on your business requirements, you may choose to allow just one of the markets (online or local) to appear within the Buy Now popup and/or target a specific market to open by default.


Please note, changing Market Option settings will globally impact how ALL Buy Now markets appear on your website. 

To trigger the popup and display the default market that is configured on the Market Options screen, simply add the following HTML code.
  1. <a href="#obn" data-product="ABC-12345">But Now</a>

Please note, you must specify the data-product parameter's value as a SKU or GTIN listed on the omacro Manage Products page, otherwise the popup will display an error message.

The same functionality can live along side a site's existing shopping cart system, adding value to the shopping experience.


The button can be styled anyway you like and live along side existing site content and buttons.


An example of a single button that can be used to show both Online and/or Local markets.


2. Trigger as a Market Specific Button (Online/Local)

If you would prefer to trigger the popup to open to a specific market, the following code can be added to your button.

To trigger the popup and display the specific market, simply add the following HTML code.

Online Market (Market Code "ONL"):
  1. <a href="#obn" data-product="ABC-12345" data-market="ONL">But Online</a>
Local Market (Market Code "LOC"):
  1. <a href="#obn" data-product="ABC-12345" data-market="LOC">Buy Local</a>

Please note, you must specify the data-product parameter's value as a SKU or GTIN listed on the omacro Manage Products page, otherwise the popup will display an error message.

The HTML data-market property specifies the market the popup will open to. It can be the following value.
  1. ONL - Online Market
  2. LOC - Local Market
If a market is not set or incorrectly set, the popup will default to what is configured on the Market Options screen.

Also keep in mind, the button styles and placements are completely under your control and can match whatever theme your site utilizes.


An example of a two buttons configuration that launch into either Online or Local markets tab.

Embedding Buy Now onto a Page

Buy Now can be embedded directly onto a webpage rather than operate through a popup. This can be useful for dedicated dealer landing pages or for nesting the control inside a product page or within a dynamic element on a page such as a tab or accordion control. For implementation details, please review our Embedded Dealer Locator Guide. 

The following are a couple examples of how it can be used:


An example of embedding within a tab on a product page with customize styles.


An example of embedding on a dedicated landing page configured to show local markets with customized styles.

Exploring Buy Now Settings & Features

The following information describes the various options associated with Buy Now that are configurable within the omacro settings (Buy Now -> Settings & Features) page. Changing settings from the Settings & Feature page will globally impact how ALL Buy Now features operate on the site. Please note, some features described below can be controlled via HTML or JavaScript code instead and are described in the Additional Scripting Options section of this document.

Market Options

By default, the buy now button can be triggered to open to the default market as specified within omacro settings (Buy Now -> Settings & Features) page. Depending on your business requirements, you may choose to allow just one of the markets (online or local) to appear within the Buy Now popup and/or target a specific market to open by default.
  1. Choose Visible Tab (Online Retailers, Local Retailers)
    You can configure Buy Now to display which market tabs should appear. By default, both market tabs are visible. 
  2. Choose the Default Tab
    When Buy Now is triggered, you can control which market you would like to load first. By default, Online Market is selected. Note that if only one tab is visible, than that market will be chosen automatically.
  3. Domain Whitelist
    You can specify which domain names are allow access to request data to the omacro endpoints. This can be useful in preventing Buy Now from operating outside of your environment. The field supports a comma separated list of domains. Leave empty for no restrictions.

Online Market Options

The following options are specific to the Online market tab.
  1. Enable United States MAP Restrictions
    You can prevent any product that violates US MAP from appearing within Buy Now. If enabled, be sure to refer to the USA MAP Reporting tool to help identify potential product pricing issues. Note this feature is only functional on Product-Based Dealer Locators.
  2. Show Retailer Pricing
    Enabling this feature will show product pricing if available. Note this feature is only functional on Product-Based Dealer Locators.
  3. Show Retailers with 'Out of Stock' Status 
    If checked, this will allow dealers to appear within Buy Now regardless of stock status.
  4. Show Retailers with Available Stock First
    Place dealers with available stock first before other dealers whose stock status is unknown or out of stock.
  5. Show Retailers Stock Status
    Only show dealers with reported stock status.  
  6. Allow User to Change Their Country
    Determine whether to allow the user to change their country. If enabled, a country picker option will be available within the Online market tab.
  7. Sorting
    You can choose one of three options to control how dealers will appear. 
    1. Alphabetical - Sorting of dealers appear in alphabetical order.
    2. Random (round robin) - Sorting of dealers appears completely random.
    3. Specific Sort Order - Sorting is based on the predefined dealer list order. This option is useful for prioritizing dealers you would like featured in a specific order. Any dealers not specified are then placed in random (round robin) order.

Local Market Options

The following options are specific to the Local market tab.
  1. Show Inventory Status
    Display the reported inventory if available. Status could be Likely, Limited, None, Unknown.
  2. Only Show Retailers Within the User's Country
    Prevent dealer from showing within the results if located outside of the user's own country. 
  3. Mapping
    Control whether to show specific dealer types. Dealers can be configured and assigned various dealer attributes (Retail Location, Service Center, Online, Rental Provider) from the Sellers -> Manage Sellers page. A dealer can have one more more attributes applied to it. Selected attributes propagate to their satellite locations automatically. Note: This feature is also available as a custom rule defined in HTML. Learn more how to Add Custom Rules To Dealer Results.
    1. Show Rental Providers - If unchecked and the dealer has been assigned exclusively as a Rental Provider, that dealer will not show in the results.
    2. Show Service Centers - If unchecked and the dealer has been assigned exclusively as a Service Center, that dealer will not show in the results.
  4. Primary Map Radius & Secondary Map Radius - You can control the radius of how far to search on a map for local dealers. Learn more about how to Adjust Map Search Radius On Buy Now Popup

Setting Custom 'No Results' Message

You can create a custom message to be displayed when no dealers are found. The input supports custom formatting as well as basic HTML elements for layout and styling. By default, the message contains no styling.




Additional Scripting Options

Setting Custom Paging Size for Online Markets Results

You can configure the number of dealers that will appear on the Online markets tab via a couple HTML options. By default, up-to 12 results will show but you can configure the the page size to be as low as 1 and as many as unlimited (no paging at all). This can be applied globally or on to a specific button (and even different across multiple buttons). Learn how to Add Custom Page Size To Online Dealer Results

Customize and Making Visual Changes to Results Window Through CSS Overrides

The Results Window (Popup) can be completely visually customized via CSS Overriding. Adjust the button styles, basic layout, colors, hide options, configure sizing and even how the control's user experience is for various devices. Make Buy Now match your site's brand by Customize and Making Visual Changes to Results Window Through CSS Overrides

If you have a campaign that requires linking to a page with Buy Now and you would like the Results Window to, you can do so by a Direct Trigger of Buy Now Dealer Locator via Email or Outside Links.

    • Related Articles

    • Buy Now API Guide

      The following guide is aimed at assisting developers in understanding how the omacro Buy Now services work in an effort to develop a custom front-end solution. If you are not familiar with this type of development, it is highly recommended that you ...

    • Manage Supplier Buy Now Links In Bulk

      Introduction Easily and effectively manage your supplier "Buy Now" links in bulk and better visualize which products are available to your company using the "Buy Now Links" data grid. View which products are available and from which suppliers: See ...

    • Product Based Dealer Locator Website Code Implementation

      Step 1: Include script within website The example below demonstrates what's needed to integrate the Buy Now widget with your site. Simply update desired parameters then copy the snippet into your website. <script id="omacro-widget-buynow" ...

    • Track Buy Now Activity With Google Analytics

      Introduction Buy Now can be used with 3rd-party analytics tools like Google Analytics to target specific URL parameters. Gain precise insights into how customers engage with Buy Now. This article will outline the basics of product seller link URL and ...

    • Buy Now Service Information for Network Professionals

      The Buy Now popup client-side script works in conjunction with a number of omacro web service endpoints to deliver it's content. For successful operation of the service, it is important to ensure the Buy Now script can properly communicate with it's ...