Local Gift Cards

This documentation applies to the Local Gift Cards product. It is a limited-time and invite-only program for now. You may not see this option if you do not have access.

As part of the Facebook COVID-19 SMB relief effort, Facebook is building a prominent Newsfeed unit helping users discover and purchase Gift Cards from your website. Partners participating to this program must provide available Gift Cards through a Product Catalog integration connected with a Facebook Page Shop.

The Local Gift Cards unit is personalized and renders products available within up to 80 km (50 miles) radius from the location of potential buyers. To achieve this, we do require that your product catalog is enriched with the street address of the physical store for participating businesses (see Feed Data Model below).

Integration Steps

In order to setup your shop and start selling gift cards on Facebook there are three steps:

Create a Page Shop
Upload Catalog
Test and Launch

User Experience

These are design mocks and may not represent the end product.

Create a Page Shop

Manually Create a Facebook Page dedicated to Local Gift Cards, and add a Shop to your Page.

Make sure your Page Shop is configured for Offsite Links. All new Page Shops based in the US are now configured for Onsite Checkout by default. If your Facebook account is registered in the US, you may need to coordinate with your Facebook contact to create a Offsite Shop.

Upload Catalog

All the Gift Cards you are offering in this experience must be uploaded into a Product Catalog associated with your Page Shop. To mark your products as Gift Cards, you must implement the field specifications in your feed as below.

Gift Card Catalog Data Model

Dynamic fields: The following fields are essential components of the experience, and must be pulled from your database.

Attribute	Type	Required	Description
`id`	`string`	Required	Unique ID for item. Can be a variant for a product. If there are multiple instances of the same ID, we ignore all instances. This maps to `retailer_id` after the product is imported.
`brand`	`string`	Required	Name of the business selling the Digital Good. Must be 100 characters or less.
`description`	`string`	Required	High level overview of what the business does and what they sell
`product_type`	`string`	Optional	Retailer-defined category for product, e.g Restaurant, Hair Dresser, Coffee Shop etc.
`link`	`string`	Required	Link to item on the merchant's website.
`image_link`	`string`	Required	Product images display in square (1:1) format. The minimum image resolution is 500 x 500 px. We recommend 1024 x 1024 px for best quality.
`google_product_category`	`string`	Required	Value depending on product category; Accepted values are: `53` - Gift Cards `2559` - Vouchers `135` - Food Ordering `4181` - Donations `166` - Merchandise
`address`	`string`	Required	JSON with either a street address or a latitude/longitude position. Address. eg: `{"city": "Naperville", "postal_code": "60564", "country": "US", "region": "IL","street_address": "4931 S Rte. 59"}` Lat/Lon. eg: `{ "latitude": "45.234543", "longitude": "5.323498"}`

Static fields: The following fields are not displayed to potential buyers, but are required by our catalog ingestion and filtering process. These can be hardcoded.

Attribute	Type	Required	Description
`price`	`string`	Required	Cost of item and currency. Currency should follow ISO 4217 currency codes such as `9.99 USD`
`title`	`string`	Required	Same as `brand`
`additional_image_link`	`string`	Optional	You can include up to 10 additional images; provide them as comma-separated URLs.
`inventory`	`integer`	Required	Any value
`availability`	`string`	Required	Whether item is in stock; Accepted values are: `in stock` - Item ships immediately `out of stock` - No plan to restock
`condition`	`string`	Required	Must be set to `new`
`delivery_method`	`string`	Required	Must be set to `redemption_code`
`availability_radius`	`string`	Required	A number representing the availability radius from the address of the product in kilometers (miles are not supported). This information is only used with Advantage+ catalog ads with local products. Must be between 1KM - 80KM

Example CSV Feed

id,brand,title,description,link,image_link,additional_image_link,price,inventory,google_product_category,availability,condition,delivery_method,address,availability_radius
FB_product_12,Business Name,Hardcoded,Hardcoded,https://www.facebook.com/events/birthdays/,https://upload.wikimedia.org/wikipedia/commons/b/b8/Pizza_Napoli.jpg,https://upload.wikimedia.org/wikipedia/commons/thumb/9/91/Pizza-3007395.jpg/2560px-Pizza-3007395.jpg,5.00 USD,1,Arts & Entertainment > Party & Celebration > Gift Giving > Gift Cards & Certificates,in stock,new,redemption_code,"{street_address: ""1 hacker way"", city: ""Menlo Park"", region: ""CA"", country: ""US"", postal_code: ""94025""}",1
FB_product_34,Business Name,Hardcoded,Hardcoded,https://www.facebook.com/events/birthdays/,https://upload.wikimedia.org/wikipedia/commons/b/b8/Pizza_Napoli.jpg,https://upload.wikimedia.org/wikipedia/commons/thumb/9/91/Pizza-3007395.jpg/2560px-Pizza-3007395.jpg,10.00 USD,1,Arts & Entertainment > Party & Celebration > Gift Giving > Gift Cards & Certificates,in stock,new,redemption_code,"{street_address: ""1 hacker way"", city: ""Menlo Park"", region: ""CA"", country: ""US"", postal_code: ""94025""}",1

Catalog Upload Options

There are two ways to upload your inventory to Commerce Manager. If you can host the feed file to your website, then using Scheduled Feed is the preferred way as it's the simplest and easiest to set up. Schedule can be setup to update hourly, daily or weekly.

If you can't host a feed file or you need to update inventory more frequently than every hour, you can use our Feed API to push the feed file to us.

More info on these approaches can be found below:

Test and Launch

You can test the experience directly on your Page Shop. When you are ready to launch, we recommend that you follow these steps:

Make sure your Page Shop is published
Remove the "Shop" Section from your Page Tabs
Coordinate with your Facebook contact to get your page added to the allow list (please provide your Facebook Page ID)