Note: Use this document if your business already participated in or completed the development work for the new simplified Shops ads experience feature.
For instructions on enabling the lightweight BOPIS experience, see the documentation here.
Shops ads for omni-channel business is designed to provide a seamless shopping experience by showing pick-up in-store options directly within Facebook or Instagram post-ad click.
To integrate the BOPIS feature in your shop enabled with checkout experiences for Shops ads, you will need to support two things:
Estimated effort: 2 weeks
Component | Advertiser Status | Integration Level of Effort | Stakeholders |
---|---|---|---|
Store Location Setup | Adding stores in Business Manager | 1 Day | Marketing Team, Feed Partner |
Creating Local Inventory Catalog for Shops: A Step-by-Step Guide | Pick-up details | 1-2 Weeks | eComm Team/Feed Partner |
Checkout Process Integration | Additional field for BOPIS | 1 Day | eCommTeam |
You need to set up your store locations by following the steps mentioned in the Help Center article.
o take advantage of the lightweight Shops Ads offsite integration, the easiest way to add stores is in Business Manager.
You need to set up your store locations by following the steps mentioned in the Help Center article.
There is also an option to add a feed that can be managed dynamically with these instructions.
You need to set up your store locations by following the steps mentioned in the Help Center article.
There is also an option to add a feed that can be managed dynamically with these instructions.
retailer_item_id
(unique identifier for each item. This id should be the same as the one from your shops catalog)store_code
(unique identifier for each store location. This should match the store code for the store locations you set up previously)quantity
(available quantity for each item at the store)By following these steps, you should be able to successfully create a catalog with local inventory feed.
This option can be used if you have a fixed set of products/SKUs eligible for pick-up in store.
To correctly process orders from your Facebook and Instagram Shops, you will need to process the checkout URL that will be redirected to your e-commerce site.
Example checkout URL for items with pickup information:
https://www.example.com/custom/checkout?products=123:3,124:2,125:1&products_json={"123":{"store_code":"1"},124":{"store_code":"2"}}
products_json
: An optional JSON structure that contains the store_code
information for every product in the order./** * This method is to extract the order and store code from the query * for product and in-store mapping in an order. * @param {query} parsed URL query. * @return {product_store} Object of product ID and store code. * */ function processCheckout(query) { const searchData = JSON.parse(query.products_json); const product_store = Object.keys(searchData).map(productId => ({ product: productId, store_code: searchData[productId].store_code, })); return product_store; }