> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Create a Facebook Audience Campaign
> Step-by-step instructions to create a Facebook Audience campaign in MoEngage with audience targeting, sync configuration, and scheduling options.
To create a Facebook Audience campaign:
1. Go to the MoEngage Dashboard.
2. From the left navigation, use one of the following options:
* On the **Engage** menu, click **Campaigns**. The All Campaigns page appears. In the upper-right corner, click **+ Create Campaign**. The Create Campaign page appears. 
* Click **Create New**, and then click **Campaign**. The Campaign page appears. 
3. In the **Audience** section, click **Facebook**. The Facebook Audience creation page appears.
# Create a Facebook Audience Campaign
Use the following steps to create a Facebook Audience campaign:
1. [Target users](#step-1-target-users): Define the target audience for the campaign.
2. [Audience detail](#step-2-audience-detail): Define the audience to add or remove from the Facebook Account.
3. [Schedule and goals](#step-3-schedule-and-goals): Define the campaign's delivery schedule and goals.
## Step 1: Target Users
This section includes:
### Campaign Details
The Campaign Details section contains the following fields:
* **Teams**: If your organization uses teams, select a team from the drop-down list. For more information, see [Teams in MoEngage](https://moengage.com/docs/user-guide/settings/account/team-management/teams-in-moengage).
* **Campaign name**: Enter a name for the campaign to help manage and identify it. The campaign name must contain at least five characters, with a maximum of 256 characters.
* **Campaign tags**: Select campaign tags from the drop-down list. You can select a maximum of five tags. For more information, see [Campaign Tags](https://moengage.com/docs/user-guide/campaigns-and-channels/getting-started/introduction/campaign-tags).
### User Qualification Criteria
This section helps define the users you want to add to or remove from the custom Facebook Audience. You can define two types of user segments here:
This option selects all users who meet the filter criteria. Select the **All Users in Segment** option to create a custom segment of all users who satisfy the filter criteria defined in the **Target Users** section. You can create one-time or periodic campaigns by using this option.
Use this option to synchronize users to Facebook based on specific user properties. Go to the **Target Users** section, and select either **All Users** or create a segment based on specific rules.
Example: You can create a segment of users who have not received a Push notification on Android and iOS. MoEngage sends all users in this segment to Facebook to add or remove them from a specific custom audience (as described in Step 2).
Event-triggered campaigns enable you to synchronize audiences based on different user action events. For example, you can remind users about an item they added to their cart but have not purchased. For more information about creating such campaigns, see [Create an Event-Triggered Campaign](/docs/user-guide/campaigns-and-channels/getting-started/triggers/event/create-an-event-triggered-campaign).
Select the **Based on Trigger Event** option to create a custom segment of all users who meet the filter criteria defined in the **Target Users** section.
After you configure the trigger conditions, create your segment filter in the **All Users in Segment** section as described previously.
### Target Users
This section provides segmentation filters to select your campaign's target users. The following options are available:
This option sends the campaign to all app users. You cannot add multiple filters when you use this option. 
This option targets users based on user properties such as first seen, last seen, city, and so on. Click the **User Property** tab, and do the following:
1. Select the desired attribute from the drop-down list. This enables filters based on the selected attributes. For example, number attributes can have filter conditions such as 'is equal to', 'is not equal to', 'is between', and so on, while string attributes have different filters.
2. Enter the filter value(s) to create the user segment.
3. Click **+ Nested Filter** to add a filter for nested AND or OR conditions. (This step is optional). For more information, see [Create Segments](https://moengage.com/docs/user-guide/segment/new-ui-experience/create-segments).
This option targets users based on user behavior or events, such as app/site opened, viewed product, and so on. Click **User Behavior**, and do the following:
1. Select the execution condition and the desired user activity (event).
2. Enter the event frequency and time duration for the event execution.
3. Click **+ Attributes** and add an event attribute with a filter condition.
4. Enter the filter value(s) to create a rule.
5. Use the **+ Aggregation** button to add aggregation functionality. For more information, see [Aggregation Operations](https://moengage.com/docs/user-guide/segment/advanced-concepts/aggregation-operations).
6. Click **+ Nested Filter** to add a filter for nested AND or OR conditions. (This step is optional). For more information, see [Create Segments](https://moengage.com/docs/user-guide/segment/segment-operations/rule-based-filter-segments).
This option targets groups of users based on a user performing an action with a specific attribute value. For more information, see [User Affinity](https://moengage.com/docs/user-guide/segment/segment-operations/rule-based-filter-segments). Click **User Affinity**, and do the following:
1. Select the desired user event or attribute.
2. Select the user affinity parameter from the following:
* **Predominantly**: Select the affinity attribute with a filter condition, and then provide the affinity values.
* **For a minimum of**: Select the affinity attribute with a filter condition, and then provide the affinity values.
* **Most no. of times**: Enter a value or use the arrows to define the top percentage of users.
* **Least no. of times**: Enter a value or use the arrows to define the bottom percentage of users.
3. Enter a value or use the arrows to define the time duration for the event execution.
4. Click **+ Attribute** to add more attributes to the filter.
5. Click **+ Nested Filter** to add a filter for nested AND or OR conditions. (This step is optional). 
This option selects a custom segment as the target audience.
1. Select a custom segment as the target audience from the list of available custom segments.
2. Click **+ Nested Filter** to add a filter for nested AND or OR conditions. (This step is optional). For more information, see [Custom Segments](https://moengage.com/docs/user-guide/segment/segment-operations/custom-segments).
After selecting the filter criteria, you can also perform the following actions:
* **Create Multiple Filters**: You can combine multiple user property rules, user activity rules, and custom segment rules to create complex user segments.
1. Click **+ Filter**.
2. Click **AND** or **OR**.
3. Select the attribute or event, and then define the filter conditions.
* **Exclude Users**: Select this check box to define the filter criteria for users to exclude from the campaign.
* **Reset Filters**: Click this option to reset the segmentation filters.
* **Show Count**: Click this button to display the total number of users currently in the configured segment.
### Control Group
This section provides information about control groups for the campaign. To exclude users from control groups, do the following:
In the **Enable Control Group** section, turn on the **Global Control Group** toggle to exclude users from the campaign's target segment. For more information, see [Control Group](https://moengage.com/docs/user-guide/campaigns-and-channels/getting-started/introduction/control-groups)
Click **Next**, or use the tabs at the top of the campaign creation wizard to go to Step 2.
## Step 2: Audience Detail
### Ad Account ID
Select the **Ad Account ID** that contains a custom audience. Ensure you select the correct ID from the drop-down list.
The default **Ad Account ID**, configured in the Facebook Audience settings page, is automatically selected. You can change this selection at any time.
### Add or Delete Facebook Audience
Select the operation (add or delete users) you want to perform through this campaign.
With this option, you can add users from MoEngage to an existing audience or create a new list by specifying match criteria.
### Select or Create a Custom Audience
You can either select an existing custom audience or create a new one.
#### Use an Existing Custom Audience
MoEngage retrieves and displays a list of existing custom audiences for the selected **Ad Account ID**. You can view the name and description of each custom audience. Select the audience you want to use. If you cannot find the custom audience you are looking for, ensure you selected the correct **Ad Account ID**.
#### Create a New Custom Audience
You can also create a new custom audience, and then add users to Facebook by using this audience.
To create a new audience:
1. In the **Select/Create Custom Audience** drop-down list, click **+ Add Audience**. 
The **Create New Audience** window appears. 
2. In the **Audience Name** field, enter a name.
3. In the **Audience Description** field, enter a description.
4. Click **+ Add Key Value Pairs** to add more parameters as key-value pairs for this new custom audience. Ensure that the fields you add are supported by Facebook. For a list of supported fields, visit the [Facebook Custom Audience Creation](https://developers.facebook.com/docs/marketing-api/reference/custom-audience/#parameters-2) page.
5. Click **Create**. You immediately see a success message that displays the custom audience ID. 
6. Click **Done**. You are redirected to the main screen, where the newly created audience is automatically selected in the **Custom Audience** drop-down list. Users are now added to this new custom audience.
* You can create a custom audience from multiple sources.
* Facebook might not allow external access to custom audiences created directly in the Facebook dashboard. If you select such an audience, MoEngage Add/Delete calls will fail.
* We recommend you run a test campaign to ensure programmatic access to the selected custom audience (via MoEngage). If an error occurs, select another custom audience or create a new one.
* Facebook does not allow deleting users from a custom audience if the audience size is too low. Facebook has not provided a minimum count for this. Therefore, run a test campaign to ensure the delete operation is permitted for the selected custom audience.
* According to [Facebook](https://developers.facebook.com/docs/marketing-api/audiences/guides/custom-audiences "https://developers.facebook.com/docs/marketing-api/audiences/guides/custom-audiences"): You can add an unlimited number of records to an audience, but only up to 10,000 at a time. Changes to your Custom Audiences are not immediate and usually take up to 24 hours.
* To create or edit a Custom Audience, your ad account must be associated with a business (mapped to a Business ID).
This option enables you to delete users from the audience by specifying match criteria.
### Remove Users From
This option enables you to remove users from the audience.
### Match Identifiers
You can select one or more of the following identifiers for Facebook to match users:
* Device identifier \[Google Advertising ID (Android), Advertising Identifier (iOS)]
* Email ID
* Mobile Number
By default, all three options are selected. However, you can select one or two of these identifiers. The default values for Email and Mobile Number are automatically populated with the attribute values saved in the [Email Settings](https://app.moengage.com/v3/#/settings/email/general) page and [SMS Settings](https://app.moengage.com/v3/#/settings/sms/sms-general) page, respectively.
If you select all three identifiers, MoEngage makes three separate calls to Facebook for each user—one for each identifier. This approach maximizes the match rate with Facebook.
To understand this better, consider a scenario where a campaign targets three users:
* User U1: Only advertising identifier exists in the system
* User U2: Advertising identifier and email ID exist in the system
* User U3: All three identifiers exist in the system
#### Case 1: Single Identifier Selected
If you select only one identifier (for example, Mobile Number) for matching users to Facebook, only User U3 is sent for the add or delete operation. This occurs because User U1 and User U2 do not have a mobile number.
#### Case 2: Two Identifiers Selected
If you select two identifiers (for example, Mobile Number and Email ID) for matching users to Facebook, Users U2 and U3 are sent for the add or delete operation. This occurs because User U1 does not have both a mobile number and an email ID.
#### Case 3: All Three Identifiers Selected
If you select all three identifiers, MoEngage sends all three users (U1, U2, and U3) for the add or delete operation. This occurs because at least one identifier exists for all users.
* An additional benefit of Case 3 is that for User U3, MoEngage makes three calls to Facebook, one for each identifier. This means that if one or two identifiers fail to match at the Facebook level, the user is still added as long as at least one identifier matches successfully.
* This approach contrasts with Facebook's [multi-key matching](https://developers.facebook.com/docs/marketing-api/audiences/guides/custom-audiences/#multikey), where a user is added to Facebook only if all identifiers or keys passed in the multi-key array match, which results in a lower match rate.
Test campaigns enable you to preview a campaign on a test device, ensuring that your notification is conveyed as intended. A successful test campaign results in the actual addition or deletion of the user in the Facebook Audience (based on your selection in the previous step).
You can test the campaign by selecting any of the following options and providing the value for the attribute chosen for your test user:
* Unique ID
* Email ID
* Mobile Number (Registered with MoEngage)
* Google Advertising Identifier
* iOS Identifier for Advertising
* Device Push Token
* Custom Segment
Click **Next**, or use the tabs at the top of the campaign creation wizard to go to Step 3, **Schedule** **and Goals**.
## Step 3: Schedule and Goals
This section includes:
* [Delivery Schedule](#delivery-schedule): Choose when the campaign should be delivered to your users and the periodicity of delivery.
* [Conversion Goals](#conversion-goals): Choose the conversion goals and revenue metrics to track for the campaign.
### Delivery Schedule
This option sends the campaign immediately to target users.
This option sends the campaign at a specified time, time zone, or predicted time.
This section includes the following fields:
* **Campaign time zone**: The time zone in which the campaign should be sent.
* **Start date**: The date on which the campaign should be sent.
* **Send time**: The time at which the campaign should be sent. Select AM or PM, depending on the time of day the campaign should be sent.
This option sends the campaign periodically on a specified date and time. The following fields are available in this section:
* **Campaign time zone**: The time zone in which the campaign should be sent.
* **Start date**: The date on which the campaign should be sent.
* **Send time**: The time at which the campaign should be sent. Select AM or PM, depending on the time of day the campaign should be sent.
* **Periodicity**: The frequency of the campaign. You can select from the following options:
| Periodicity | Description |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Daily | **Repeat every**: This option enables you to specify the number of days after which the campaign should repeat. |
| Weekly | **Repeat every**: This option enables you to specify the number of weeks for which the campaign should repeat.
**Repeat on**: This option enables you to specify the day(s) of the week on which the campaign should be sent (For example, to send the campaign every Monday, Wednesday, and Friday, select these days). |
| Monthly | **Repeat every**: This option enables you to specify the number of months for which the campaign should repeat.
**Repeat on**: This option enables you to: - **Days of month**: Select this option for repeating campaigns that are date-specific. Select the date(s) of the month the campaign should be sent (For example, to send the campaign on the 5th and the 25th of a month, select the 5th and 25th in the calendar widget.). **Note**: If the selected date(s) do not exist in the specified month (for example, in a shorter month), the campaign is sent on the last day of the month. For example, if you select the 30th and 31st for February, the campaign sends on the 28th or 29th.
- **Days of week**: Select this option to specify the day(s) of the week on which the campaign should be sent (For example, to send the campaign every Monday, Wednesday, and Friday, select these days). **Note**: If a selected day of the week does not exist in a month (for example, the fifth Saturday), the campaign is skipped for that instance. If overlaps occur (for example, the fourth Monday and the last Monday), only one instance is sent.
|
* **Ends:** The date on which the campaign should end. The following options are available:
* **On**: The campaign ends on the end date specified in the **End Date** field.
* **After**: The campaign ends after the number of occurrences specified in the **Occurrences** field.
### Conversion Goals
Conversion goals are optional. To add a conversion goal, click **+ New Goal**.
You can add conversion goals to track the business metrics for your campaigns. You can track a maximum of five conversion goals. You can select any app event as a conversion goal activity and set multiple conversion goals. The first goal is treated as the primary goal.
For example, to track the number of customers who purchased an iPhone after your campaign was sent (Event: Purchase event, Product: iPhone), your conversion goal setup might resemble the following image:
Multiple conversion goals enable you to track more than one business metric or visualize a funnel for user actions. For example, you can use multiple conversion goals to check the following:
* How many users viewed the product page?
* How many of them added that product to the cart?
* How many of them made a successful order?
| | |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| With MoEngage, you can track the revenue generated by your campaigns. For example, you can track revenue generated by your product after sending a communication. To track revenue performance, turn on the **Revenue Performance** toggle for the desired conversion goal. In this example, to track revenue for the `orderSuccessful` event, you must turn on the **Revenue Performance** toggle. | 
|
| | |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| After selecting the goal, select the numeric attribute that captures the total monetary value of the order. For example, `cartValue` contains the total order value. You can select the currency in which your monetary value is reported. | 
|
| | |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Set Attribution Window**: You can set an attribution window, which defines the time period (since a user received or clicked the campaign) for attributing conversion goals to a specific campaign. By default, it is 36 hours, with a maximum of 10 days. For example, the attribution window is set to 5 hours. | 
|
Your campaign is ready. Click **Publish**, and then confirm in the dialog box to create your campaign.
* For Facebook Audience campaigns, MoEngage tracks conversions for a user after successfully sending the user's details to Facebook for matching.
* Because Facebook does not provide status updates on whether a user was synced successfully (added or deleted), MoEngage assumes a successful response from Facebook as a proxy for successful syncing.