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 a 5 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:

  1. Create a Page Shop

  2. Upload Catalog

  3. Test and Launch

User Experience

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

Local Gift Cards Unit

Local Aggregated Gift Cards Shop View

Gift Card PDP

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.

AttributeTypeRequiredDescription

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.

link

string

Required

Link to item on the merchant's website.

image_link

string

Required

URL of product image.

additional_image_link

string

Optional

You can include up to 10 additional images; provide them as comma-separated URLs.

price

string

Required

Cost of item and currency. Currency should follow ISO 4217 currency codes such as 9.99 USD

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.

AttributeTypeRequiredDescription

title

string

Required

Any value

description

string

Required

Any value

inventory

integer

Required

Any value

google_product_category

string

Required

Must be set to Arts & Entertainment > Party & Celebration > Gift Giving > Gift Cards & Certificates

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 Dynamic 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,"{city: Naperville"""," postal_code: ""60564"""," country: ""US"""," region: ""IL""","street_address: ""4931 S Rte. 59""}""",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,"{city: Naperville"""," postal_code: ""60564"""," country: ""US"""," region: ""IL""","street_address: ""4931 S Rte. 59""}""",1

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:

  1. Make sure your Page Shop is published
  2. Remove the "Shop" Section from your Page Tabs
  3. Coordinate with your Facebook contact to whitelist your page (please provide your Facebook Page ID)