Skip to main content

Add Facebook Dynamic Ads export

Use the export Facebook Dynamic Ads in Productsup to upload your product catalog to Facebook and use it for ads across the entire Meta ecosystem.

Introduction

Note

This document covers the setup of the export Facebook Dynamic Ads and the difference between all Facebook exports available in Productsup.

Using Productsup, you can send your product catalog to Facebook Commerce Manager, one of Meta Business Manager tools. With your product catalog available in Commerce Manager, you can advertise your products to wide audiences across the entire Meta ecosystem based on users' interests and previous behavior. The Meta ecosystem includes Facebook, Instagram, Messenger, and the Audience Network.

Productsup offers the following exports to send data to the Meta ecosystem:

Export name

Export purpose and description

Facebook Dynamic Ads

Sending your product catalog to Facebook Commerce Manager, where you can find it as a data feed added in the Data sources tab.

You can use this export as a flat-file or API-based export. For a detailed breakdown of the differences and advantages of these options, see Difference between flat-file and API destinations for Facebook Dynamic Ads.

This export sends your entire catalog to Commerce Manager. If you have millions of products, exporting the entire catalog may take considerable time.

See the following sections in this document for information on setting up this export.

Facebook Dynamic Ads (Delta Upload)

Sending changed products to Facebook Commerce Manager via the Facebook Marketing API. This export uses delta files, which means it sends only new, updated, and deleted products to Facebook instead of the entire catalog. The export doesn't send unchanged products to Commerce Manager, which helps reduce site-running times.

When this export runs, it creates a Productsup app in the Data sources tab in Commerce Manager that uploads the changed data into your product catalog.

See Add Facebook Dynamic Ads (Delta Upload) export.

Facebook Localized Catalog - Country Feed

Sending additional country-specific data as a supplement to your product catalog in Facebook Commerce Manager. Useful for cases when you sell products across multiple countries that use different currencies or units of measurement.

You can use this export as a flat-file or API-based export. For a detailed breakdown of the differences and advantages of these options, see Difference between flat-file and API destinations for Facebook Dynamic Ads.

This export sends your entire catalog to Commerce Manager. If you have millions of products, exporting the entire catalog may take considerable time.

See Facebook localized ads template.

Facebook Localized Catalog - Language Feed

Sending data in multiple languages as a supplement to your product catalog in Facebook Commerce Manager. Useful for cases when you sell products across multiple countries that use different languages.

You can use this export as a flat-file or API-based export. For a detailed breakdown of the differences and advantages of these options, see Difference between flat-file and API destinations for Facebook Dynamic Ads.

This export sends your entire catalog to Commerce Manager. If you have millions of products, exporting the entire catalog may take considerable time.

See Facebook localized ads template.

Documentation on Facebook Local Product Feed (LIA), Facebook Dynamic Ads Video, Facebook Travel Ads - Flight Feed, Facebook Travel Ads - Destination Feed, Facebook - Automotive Inventory Ads, and Facebook Real Estate is coming soon.

Warning

Although you can find the Instagram export in Productsup, we recommend using Facebook Dynamic Ads or Facebook Dynamic Ads (Delta Upload) to advertise your products on Instagram. The Instagram export doesn't get regular maintenance and updates, unlike the Facebook exports.

Prerequisites

To send your product catalog to Facebook Commerce Manager using the export Facebook Dynamic Ads, you need:

  1. A Facebook business account with at least one product catalog created in it.

  2. Only relevant if you choose to send your product catalog to Facebook Commerce Manager via the Facebook Marketing API:

    1. The ID of the catalog where you want to send your products.

    2. A Facebook authentication in your Productsup organization.

      To add a Facebook authentication:

      1. Go to Authentication from the organization's, project's, or site's menu and select ADD AUTHENTICATION.

      2. In Type, select Facebook, give it a desired name, and select Next.

      3. Select Connect for Productsup to redirect you to a Facebook page where you can give Productsup access to your Facebook business account. Once ready, Facebook redirects you back to Productsup. Close the confirmation window to proceed.

Set up the Facebook Dynamic Ads export

  1. Go to Exports from your site's main menu and select ADD EXPORT.

  2. Search for Facebook Dynamic Ads, hover over it, and select Add.

    facebook_dynamic_ads_export.png

  3. Go to Dataflow from the site's main menu and choose the added export from the drop-down menu in the top ribbon on the left.

  4. Map all relevant attributes from import to export. See Map your product data for more information.

    There are only 9 mandatory attributes for Facebook:

    mandatory_attributes_in_facebook_dynamic_ads.png

  5. Go to Exports and select Facebook Dynamic Ads.

  6. Select Add Destination and choose the needed destination from the Destination drop-down menu:

    Note

    For a detailed breakdown of the differences and advantages of the applicable destination options, see Difference between flat-file and API destinations for Facebook Dynamic Ads.

    1. You can choose any standard flat-file destination option, such as Productsup Server or FTP Server.

    2. You can select the API-based destination Facebook Marketing API: Data Feed.

      Facebook_Marketing_API__Data_Feed_destination.png

  7. Choose Save once you have selected the needed destination option. Set it up and select Save.

  8. Go to Data View. In the top ribbon, select Readiness from the Overview drop-down menu to see what data transformations are necessary to meet Facebook's product data requirements. See Analyze your data in Data View for more information on using the Analyzer feature.

  9. When your export setup and product data are ready, select Run or Export in the top-right corner of the page.

    Tip

    If the run finishes with issues, you can go to Error Log to troubleshoot.

  10. Go to your Facebook business account:

    1. If you are using the destination Facebook Marketing API: Data Feed, check that Facebook has successfully uploaded all your products to the needed catalog.

    2. If you are using any other destination, go to the Data sources tab in your Commerce Manager to upload the generated file as your data feed. You can copy the link to your generated file in Productsup on the export setup page in the section Files or the destination setup page.

Difference between flat-file and API destinations for Facebook Dynamic Ads

When added to the Facebook Dynamic Ads export, flat-file destination options, such as Productsup Server or FTP Server, generate a file and send your entire product catalog to that file. When running your first export with these destinations, you need to manually upload the generated file to Commerce Manager to let Facebook import your data from it. The manual file upload is a one-time action.

The API-based destination Facebook Marketing API: Data Feed generates a file, sends your entire product catalog to that file, and automatically uploads the file to Commerce Manager. This destination also lets you comply with Facebook's file size requirements thanks to compression and automatically splitting your product catalog into multiple files if needed. The destination lets you configure any desired schedule for Facebook to import your product catalog.

Choose a flat-file destination if:

Choose the API destination if:

  • You have a smaller product catalog and/or do less frequent data updates.

  • You have a large product catalog with millions of products and/or do frequent data updates to achieve more real-time data synchronization.

  • You want to receive feedback from Facebook to troubleshoot your data in Productsup.

Tip

If your use case fits both points and you want to speed up your exports to Facebook by sending only changed data to Commerce Manager, you may want to consider the export Facebook Dynamic Ads (Delta Upload) with its own API- and delta-based destination. See Add Facebook Dynamic Ads (Delta Upload) export.

See Find the most suitable export destination to choose your flat-file destination option and find a document covering its setup. See the following section to set up the API-based destination Facebook Marketing API: Data Feed.

Set up the destination Facebook Marketing API: Data Feed

  1. If you have already created an authentication for Facebook in your current site, project, or organization, you can choose it in the Authentication drop-down menu. If not, see Prerequisites.

  2. In Product Catalog ID, enter the ID of the product catalog in Commerce Manager where you want to send your products.

  3. If you don't want to use Productsup Product Feed as the default name of a data feed added in the Data sources tab in Commerce Manager, enter a different name for your data feed in Feed Name.

  4. In Market country, choose the country where you want to advertise and sell your products.

  5. In Default currency, choose the currency of the prices in your product catalog. If you don't choose a currency here, USD is the default option added to your product catalog's metadata in Commerce Manager.

  6. If your product catalog includes millions of products, you may need to compress it and split it into multiple files to meet Facebook's file size requirements and speed up the export.

    See File formats and size limits for data feeds for more information on Facebook's file size limits for data feeds.

    1. Toggle Compression to On to compress your product catalog and send it as a GZIP file to Facebook.

    2. Toggle Multiple feeds to On if your overall export file size exceeds Facebook's requirements and you plan to send your product catalog in multiple files.

      Note

      If you turn this setting on, you need to add another file to your export. Once you finish the destination setup and select Save, the platform takes you to the setup page of your Facebook Dynamic Ads export, where you should select Add File at the bottom of the page. See Overview tab for more information.

      add_file_.png

    3. Toggle Delete other feeds to On if you have enabled the setting Multiple feeds and want Facebook to delete previously added files if a new export has fewer products and doesn't need as many files.

  7. See the following section for setting up Facebook imports in the fields Replace Interval, Update Interval, and Trigger download.

  8. Toggle Active to On to activate the destination.

  9. Select Save.

  10. See Step 8 in the export section to finalize your setup.

Set up a schedule for Facebook to import your export data

Note

Once you set up your Facebook imports, go back to Step 8 in the previous section to finish the destination setup.

There are different ways to set up how often Productsup generates your export file and how often Facebook imports data from it:

  • On the Productsup side, you can generate your export file whenever necessary by running your Facebook Dynamic Ads export manually or setting up automatic site runs in Scheduling. See Set up scheduling and triggering processes in Scheduling.

  • On the Facebook side, you can use different fields in the setup of the Facebook Marketing API: Data Feed destination:

    • Use the setting Trigger download if you want Facebook to import data from your export file based on site runs in Productsup.

    • Set up a desired schedule using the fields Replace Interval and Update Interval if you want to disconnect Facebook imports from site runs in Productsup.

More information on these fields:

Field name

What it does

How to set it up

Trigger download

Lets Facebook import data from your export file as soon as Productsup finishes uploading data to it. Ties Facebook imports to Productsup exports.

Toggle Trigger download to On to let Facebook upload your entire product catalog every time Productsup finishes updating it in the generated export file.

Replace Interval

Uses a defined schedule to let Facebook overwrite your previously imported products with new data from the generated export file. This option updates the data of your previously imported products, creates new products added to the export file, and deletes previously uploaded products that are no longer in the export file.

You must create a site-running schedule in Productsup to let Facebook timely import up-to-date product data. This schedule should run less often than the update interval. Allow for your average site run time between your scheduled Productsup exports and your replace interval on the Facebook side.

Specify how often you want Facebook to overwrite your previously uploaded products with a new batch in Replace Interval.

You can configure this interval only once before sending your product catalog to Commerce Manager for the first time. Use the following templates to define the needed replace interval:

  • Enter h for hourly uploads.

  • Enter d:12 for daily uploads at noon or d:18:30 for daily uploads at 6:30 PM.

  • Enter w:3:20 for weekly uploads on Wednesdays at 8 PM.

  • Enter m:20:1 for uploads on the twentieth of each month at 1 AM.

Update Interval

Uses a defined schedule running more often than the replace interval to let Facebook update your previously imported products with new data from the generated export file. This option updates the data of your previously imported products and creates new products added to the export file. No product deletions occur at this stage.

You must create a site-running schedule in Productsup to let Facebook timely import up-to-date product data. This schedule should run more often than the replace interval. Allow for your average site run time between your scheduled Productsup exports and your update interval on the Facebook side.

Use the same templates as in your replace interval to specify how often Facebook should update your catalog in Update Interval.

You can configure this interval only once before sending your product catalog to Commerce Manager for the first time.

There are three scenarios for using these settings:

  1. Using only replace and update intervals.

    Data updates on Facebook can happen on a fixed schedule of Facebook imports without interference. Real-time data updates aren't possible. All data changes must wait for the next update cycle to appear in Commerce Manager.

    To use this scenario, set Trigger download to Off.

  2. Using only triggered downloads.

    Data updates on Facebook can happen on a fixed schedule created in Productsup or follow manual site runs in Productsup. This lets you change your data in Commerce Manager at any moment, allowing near real-time updates, which is ideal for rapidly changing data like inventory levels or flash sales.

    To use this scenario, remove the default input d:12 from Replace Interval to avoid unnecessary Facebook imports.

  3. Using intervals and triggered downloads together.

    Data updates on Facebook can happen on a fixed schedule of Facebook imports and follow manual site runs or site-running schedules in Productsup. This can help you achieve near real-time updates with a fallback mechanism of scheduled Facebook imports in case of API or system issues causing triggered downloads to fail. However, this scenario requires meticulous timing to prevent intervals and triggered downloads from interfering with each other.

    Tip

    We recommend using the replace and update intervals without triggered downloads if multiple exports in your Productsup organization send data to the same product catalog in Commerce Manager.

In this section: