24TTL's Where-to-Buy Online solution allows manufacturing brands to request product offers from online retailers and display them as logo links on a widget on their site. This allows customers to be redirected from the product card on the brand's site directly to the product card on the retailer's site without leaving the page, providing a seamless buying path.

When a user visits a product page on a brand site and clicks the "Where to Buy" button, the widget sends a request to the 24WTB API, which returns in response a json with offers for that product on various retailer sites, which stores information about price, currency, availability in the online store, link to the product page and other parameters. If the offers are available for display, the system gives the answer "200" and the widget renders a Json file in the form of links-logos of different retailers. If there are no offers, the system gives the answer "204" and the widget displays a phrase about the lack of offers.

The 24WTB widget is used to visualize online retailer offers for a specific brand product. 

Offers are displayed when the visitor clicks the "Where to Buy" button (or any other name). The widget call contains parameters defining the brand, productID and product mapping type, by which a request is made to the system and a list of available offers is displayed. 

The widget's functions are as follows: 

The initialization widget method is to configure the settings of the widget appearance, as well as the data of the product for which offers are displayed on the page. During widget initialization a request is made to the server part of the service, which contains data on the product, then in response comes JSON-object with the available retailers’ product offers. Widget script generates a layout based on this data and visual settings of the widget and displays it on the page of the site, where the widget is used. The widget is inserted to the page element, which is also specified in the initialization settings. 

Besides data receiving through widget it is possible to receive data when you address to API of service in JSON format. At a request it is necessary to specify some obligatory parameters which will allow to receive information for the necessary product. More information about these parameters is described in section "Getting the list of product offers via API".

You need to place two script tags at the bottom of the site to integrate the widget:

1 - Connecting the widget script.

2 - Widget initialization.

The connection code of the widget script looks like this:

<script src="https://widget.24wtb.com/wtbWidget.js"></script>

An example of widget initialization code:

<script>
var wtbWidget = new WtbWidget();
wtbWidget.init({
    el: ".product-gallery__light-button-right",
    licenseId: '4c579eab-adb2-4187-bb4b-cc69f01a08bd',
    productId: ‘3838782532436', 
    skuType: 'ean',
    buttonClass: 'btn',
    buttonText: 'WHERE TO BUY',
    widgetLinkColor: '#00b8ac',
    widgetListColor: '#00b8ac',
    footerBg: '#00b8ac',
    footerColor: '#fff',
});
</script>
								

Widget is ready to work!

You can get a list of product offerings through the 24WTB API.

The URL example below contains several variables that are needed to get product offers. Based on these variables, 24WTB will display a list of online store offers for the product on the widget on the brand site.

https://core.24wtb.com/api/v1/{license_id}/online/product?{product_sku_type}={product_sku_value}

where: 

{license_id} = unique ID provided when registering with 24WTB Online

{product_sku_type} (acceptable values - mpn, ean or custom_id) = The type of data used to map the product

{product_sku_value} = MPN (Manufacturer Part Number) or EAN (European Article Number/ barcode) or custom_id, unique product code on the brand's website)

Examples:
 JSON with MPN and EAN

https://core.24wtb.com/api/v1/1957063e-e342-4eba-b42b-e0ac9c9aed97/online/product?mpn=BM235CLI

https://core.24wtb.com/api/v1/1957063e-e342-4eba-b42b-e0ac9c9aed97/online/product?ean=3838942142796

If you plan to track campaigns (e.g., various media, ads, selling leads, etc.) from which users go to your own landing page where the "Where to Buy" button is located, you need to add a CID parameter to the media URLs and implement the following script to have the CID value captured and displayed on the 24WTB dashboard. 

What is CID?

24WTB offers the ability to link your tracking system to 24WTB's lead and sales tracking feature. You'll be able to see overall information on users who clicked over from an individual ad campaign and make in-depth insights into user behavior.

For detailed information and technical documentation, please contact your Custom Success Manager.

For hands-on examples, we have developed the Sandbox where you can play with the parameters.

24TTL's Where-to-Buy Offline allows brands to query the nearest offline stores for a selected product and display them on a map as dots, which the user can click on and get detailed information on each of them. The widget displays only those stores that sell the desired categories for the selected product. For example, for a refrigerator, stores that sell this category will be displayed. The 24WTB-Offline service helps the user quickly find up-to-date information about the nearest offline stores where a particular product can be purchased. 

When the user goes to the product page on the brand's website, opens the map with the "Where to buy - Offline", the widget sends a request to the API, which returns a json response with data on offline stores. Json includes the following information: store name, opening hours, address, longitude and latitude coordinates, telephone, email and other possible parameters. Once a response has been received, it is visualized on a map widget as available offline store options where the customer can go to purchase an item. After clicking on an available store, the user will see more information about it.

You can get a list of offline stores for a specific product through the 24WTB API.

The following URL example contains several variables that are needed to get information on offline stores. Based on these variables, 24WTB will display a list of offline stores that are within the specified radius around the customer's selected geolocation.

https://core.24wtb.com/api/v1/{license_id}/offline/product/by-area?{product_sku_type}={product_sku_value}&latitude={latitude}&longitude={longitude}&distance={distance}

where: 

{license_id} = the unique ID provided when registering with 24WTB

{product_sku_type} (allowed type are mpn, ean or custom_id) = The type of data used to map the product

{product_sku_value} (allowed values are mpn, ean or custom_id) = Manufacturer part number or EAN code (13 digit numeric code/barcode) or custom_id, unique product code on brand site)

{latitude} = Latitude of the center of the circle where you search for stores

{longitude} = Longitude of the center of the circle where you search for the stores

{distance} = Circle radius in meters. Maximum distance 100,000 m (100 km)

Examples:
 JSON with MPN and EAN

https://core.24wtb.com/api/v1/1957063e-e342-4eba-b42b-e0ac9c9aed97/offline/product/by-area?mpn=PNKH33333&latitude=55.753927&longitude=37.610834&distance=10000

https://core.24wtb.com/api/v1/1957063e-e342-4eba-b42b-e0ac9c9aed97/offline/product/by-area?ean=2222222222222&latitude=55.753927&longitude=37.610834&distance=10000