Loader Facebook Audience (Facebook Custom Audience)

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

Requirements

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

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.
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: `extern_id,first_name,last_name,phone_number,email,mobile_advertiser_id` 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.

Parameters

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.
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.
Prehashed keys (optional)	If the checkbox is enabled, the loader will expect hashed values in the input CSV file. If there are unhashed values and the checkbox is checked, the loader will fail.

Channel Activations

This comprehensive integration provides a centralized platform for managing and optimizing your audience engagement across various channels within the Facebook/ Meta ecosystem.

Instagram Ads: effortlessly extend your marketing reach to Instagram through this integration, enabling you to create, monitor, and optimize ad campaigns seamlessly.
Messenger Ads: connect with your audience on a more personalized level through Messenger Ads, managing conversations and interactions efficiently within the Facebook Audience framework.
WhatsApp Business: Seamlessly integrate WhatsApp Business to enhance customer communication, providing a direct channel for engagement and support.

Learn more: Explore additional integrations within the Facebook/ Meta.