For the complete documentation index, see llms.txt. This page is also available as Markdown.

Product Catalogue

Feed your live competitions into a Meta product catalogue so you can run catalogue ads and tag products across Facebook and Instagram.

A Meta product catalogue is a list of everything you sell that lives inside Meta. Once your competitions are in a catalogue, you can run catalogue ads (the kind that automatically show people the right products), tag competitions in your posts, and let Meta promote the most relevant competition to each shopper.

RaffleX gives you a ready-made catalogue feed, a web address that lists all of your currently active competitions in the format Meta expects. You add this address to Meta once, and from then on it keeps your catalogue up to date for you.

Your catalogue feed address is:

https://yourdomain.com/api/meta/catalogue.xml

Replace yourdomain.com with your own site domain (the address customers visit to enter your competitions).

The feed only ever lists competitions that are currently live. A scheduled competition is added once its start date arrives. As you launch new competitions or others close, the feed updates on its own, so your Meta catalogue stays in step with your site.


What the feed includes

For every active competition, the feed provides the details Meta needs to build a catalogue entry:

  • Title and description

  • A link to the competition page on your site

  • The featured image

  • Price (in your site's currency)

  • Your site name as the brand

  • The closing date

Everything is already formatted to Meta's requirements, so you do not need to edit or prepare anything yourself.


How to add the feed to Meta

You add the feed inside Meta Commerce Manager, which is part of your Meta Business account.

  1. Go to business.facebook.com and open Commerce Manager.

  2. If you do not already have a catalogue, create one and choose the e-commerce (online products) type.

  3. Open your catalogue, go to Data Sources (sometimes shown as Catalogue then Data Sources), and click Add Items.

  4. Choose Data Feed as the method.

  5. When asked for your file, select the scheduled feed option and paste in your catalogue feed address from above.

  6. Give the feed a name, choose your default currency, and set how often Meta should refresh it. Daily is a good choice for most sites.

  7. Click Upload (or Next) to finish. Meta will fetch your feed and add your competitions to the catalogue.

Last updated