Using components: Facebook Ads Destination

Use the Facebook destination component to store the output of a data flow in Facebook cloud object.

The destination component uses Facebook ads API.


Select an existing Facebook connection or create a new one (for more information, see Allowing ETL access to my data on Facebook.)

Required Permission & Terms of Service 

    • People's Access (link) - Click Users and select people, make sure you have admin access to your business manager (Details about employee and admin access)
      thumbnail image
  • Conversions
    • Make sure you have access to development pixel (link)
      thumbnail image
  • Customers
    • Make sure you have access to ads account (link)
      thumbnail image
    • if your Ads Account is directly associated with your personal Facebook account, follow this link and accept the Terms of Service. Even if your Ads Account is in a Business Manager account you also need to accept the Terms of Service within your business manager account.

Destination Properties

  • Target object - select the name of the target object (Conversions or Customers) in your Facebook ads.

Operation type

  • Insert -  inserts new data into the selected object according to pixel or custom audience id
  • Replace - updates existing data in the selected object according to custom audience id (only Customers object)
  • Delete - deletes data in the destination object according to custom audience id (only Customers object)

Advanced options

    • Batch size - number of records that are inserted to Facebook ads in each batch (Conversions maximum batch size: 1000;  Customers maximum batch size: 10000).
    • Maximum errors - maximum number of errors to tolerate when inserting data into Facebook ads. Note that the actual number of errors may be greater than the maximum due to the parallel nature of the process.

Pixel ID and Customer Audience ID

  • Pixel ID (Conversion Object) -  account id recognition for Facebook Ads
    • Access your Meta Business Settings (link)
    • On Data Sources section click Pixels and find the pixel ID underneath the title
      thumbnail image
  •  Custom Audience ID (Customer Object) - audience id recognition for Facebook Ads
    • Access your Meta Business audiences (link)
    • If you already had an existing Custom Audience, please skip this step. On Create Audience dropdown button, select Custom Audience
      thumbnail image
      And then select Customer list (currently supported for sources in customer audience), download file template and set desire customer list file format on .csv or .txt format
      thumbnail imagethumbnail image
    • On the Columns drop down, make sure the Audience ID checkbox is checked 
      thumbnail image
    • You will find the list of Audience IDs on the most right column 
      thumbnail image
    • Finally, please confirm when your cursor hover around i symbol the audience is ready for use. Make sure that the selected Audience is a Custom Audience type and using "Customer list" as its source. 
      thumbnail image

Schema Mapping

Select the required and optional fields to use in the destination according to the object. (For more details on fields for each object: conversions & customers)