ePrivacy and GPDR Cookie Consent by Cookie Consent Skip to main content

Loader Facebook Audience

Facebook loader component is used for setting Facebook as a destination within Meiro Integrations. 


To use the Facebook loader, one needs to authorize the Facebook account. Authorization can be done in 2 ways:

  1. The user who has access to an Ad account in Facebook Business Manager and has access to Audiences clicks on the “Authorize” button in the same browser where one logged in to his Facebook Ad account.
  2. The authorization link can be copied by an analyst working in Meiro Integrations and sent for authorization to a person who has the required level of access and should open the link in the same browser where one logged in in his Facebook Ad account.

Learn more: about Ad account permissions here 

Data In/ Data Out

Data In

It is required to have data in the bucket Data In in CSV format in /data/in/tables,  the name of the file should be “imports.csv”: /data/in/tables/imports.csv

In order for loading data properly make sure that column names are in the right format.

All column names must be present (even if left empty)  in this order:


At least one of the identifier columns should be filled in: email, phone_number, mobile_advertiser_id

External_id can not be empty, to fill in this column you can use customer_entity_id, which will be available after exporting a segment from CDP. 

Customer Audience has 2 steps: create the audience itself, then fill it with the right data.

When it fails on step 2 as for example data was structured in an invalid way (with other order of columns), the audience is still created but without the data. 

Data Out  N/A

Learn more: about column formatting please refer to the Facebook help website. 

Learn more: about the folder structure here.


Ad Account ID (required) Refers to the ID of the ad account. It is possible to add only one ID within one component. Ad account ID should start with “act_XXXX”.

Warning: It is essential to accept the terms of service to be able to export the custom audience for the ad account. You can accept the terms of service at https://business.facebook.com/ads/manage/customaudiences/tos/?act=<AD_ACCOUNT_ID>  
Replace <AD_ACCOUNT_ID> with the ID of the ad account. 

Remember: In the case where multiple ad accounts are present for a business account, you only need to accept the terms of service once for the business account for the export to work across all ad accounts that belong to that business account.

Learn more: You can learn more about custom audience terms of service here.

Learn more: about how to find an ad account ID please refer to this article.

Audience Params 

Name (optional)

Name of the newly formed audience in Facebook Ad. As input should be used as a reference to a workspace variable. The name of the workspace variable you choose should be the same value as the Meiro Integrations key when setting up parameters in Business Explorer for the Facebook destination.

Workspace variable name:


Meiro Integration Key in Business Explorer for Facebook Destination:


Description (optional)

Description of the newly formed audience will be shown as additional information in the description of the Audience in the Facebook Ads account.


Audience ID (optional)

Audience ID number in Facebook Ad account, unique for each Audience. If filled in, then the Facebook loader will update the existing Audience with this ID.

If one leaves this field empty, the component will create a new Audience.

Retention Days(optional)

The number of days to retain before the audience expires and is removed. It can be set up to 180 days. If left blank, the audience does not have an expiry date. It is usable only when a new audience is created.

Screenshot 2021-10-21 at 2.09.15 PM.png

Screenshot 2021-10-21 at 2.09.28 PM.png



Threads_count (optional)

This parameter defines the number of threads processing the input (one thread processes 10,000 records). The value must be >=1. By default is 1. 

Warning: It is advised to leave the default value for threads_count, unless it is needed for a particular use case to set it higher. This parameter is for bigger data execution optimization. The memory limit for threads is 2GB.