> ## Documentation Index > Fetch the complete documentation index at: https://moengage-unity-sdk-initialization-split.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Create a Connected App Campaign > Follow step-by-step instructions to create a Connected App campaign in MoEngage with options for one-time, periodic, or event-triggered delivery. * Required Connected App must be added to the MoEngage App marketplace. * A Connector must be configured. * At least one integration for a connector must be added. * Required connection authorization must be completed. To create a Connected App campaign: 1. On the sidebar menu in MoEngage, hover over the **Engage** menu item

. The **Engage** menu appears. 2. Click **+ New Campaign**.

You can also click **All Campaigns** on the **Engage** menu and then click **+ Create campaign** on the All campaigns page. 3. On the **New Campaign** dialog box, under **Connected apps**, click the connected app you want to use. 4. Choose one of the campaign delivery types: * One Time * Periodic * Event Triggered For more information on delivery types, refer to [Delivery Types](/user-guide/campaigns-and-channels/getting-started/introduction/delivery-types-moengage-channels). The following are the steps to create a Connected App campaign: 1. [Target Users](/user-guide/campaigns-and-channels/connected-apps/create/create-a-connected-app-campaign#step-1-target-users): Define the target audience for the campaign. 2. [Content](/user-guide/campaigns-and-channels/connected-apps/create/create-a-connected-app-campaign#step-2-content): Define the content to be sent. 3. [Scheduling and Goals](/user-guide/campaigns-and-channels/connected-apps/create/create-a-connected-app-campaign#step-3-scheduling-and-goals): Define the campaign's delivery schedule and goals. ## Step 1: Target Users The campaign details section has the following fields: * **Campaign name**: Enter the name of the campaign to manage and identify it. The campaign name must have at least five characters, and the limit is 256 characters. * **Campaign tags**: Select campaign tags in the list. You can select a maximum of five tags. For more information, refer to [Campaign Tags](/user-guide/campaigns-and-channels/getting-started/introduction/campaign-tags). Push_CampaignDetails (1).png

Event-triggered campaigns allow you to send personalized notifications triggered by different user action events. For example, you can remind users about the item they added to the cart but have not purchased. For more information on creating such campaigns, refer to Create an Event-Triggered Campaign. ### Target audience This section contains segmentation filters that help you choose the target audience for your campaign. The following options are available: This filter option allows you to send the campaign to all app users. You cannot add multiple filters when you use this option.

This filter option allows you to target the 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 in the drop-down list. This enables filters based on the chosen attributes. For example, attributes that are numbers 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 desired user segment. 3. Click **+ Nested Filter** to add a filter to create nested AND or OR conditions. (This is optional) For more information, refer to [Create Segments](/user-guide/segment/segment-operations/rule-based-filter-segments).

This filter option allows you to target the users based on the user's behavior or event, such as App/Site Opened, Viewed Product, and so on. Click the **User behavior** tab 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 **+ Aggregation** to add the aggregation functionality. For more information, refer to [Aggregation Operations](/user-guide/segment/advanced-concepts/aggregation-operations). 6. Click **+ Nested Filter** to add a filter to create nested AND or OR conditions. (This is optional) For more information, refer to [Create Segments](/user-guide/segment/segment-operations/rule-based-filter-segments).

This filter option allows you to target groups of users created based on the user performing an action with a specific attribute value. For more information, refer to User Affinity. Click the **User affinity** tab and do the following: 1. Select the desired user event or attribute. 2. Select the user affinity parameter from the following: * **Predominantly**: Select an affinity attribute with a filter condition and provide the affinity values. * **For a minimum of**: Select an affinity attribute with a filter condition and provide the affinity values. * **Most no. of times**: Enter a value or use the arrows to provide the top percentage of users. * **Least no. of times**: Enter a value or use the arrows to provide the bottom percentage of users. 3. Enter a value or use the arrows to provide the duration of the event execution. 4. Click **+ Attribute** to add more attributes to the filter. 5. Click **+ Nested Filter** to add a filter to create nested AND or OR conditions. (This is optional) For more information, refer to [Create Segments](/user-guide/segment/segment-operations/rule-based-filter-segments).

This filter option allows you to select a custom segment as the target audience. 1. Select a custom segment as the target audience from the list of custom segments available. 2. Click **+ Nested Filter** to add a filter to create nested AND or OR conditions. (This is optional) For more information, refer to [Custom Segments](/user-guide/segment/segment-operations/custom-segments).

After choosing the filter criteria, you can do the following as well: * Create multiple filters You can create and combine multiple user property rules, user activity rules, and custom Segment rules to create a complex user segment using this option. 1. Click **+ Filter**. 2. Click **AND** or **OR**. 3. Select the attribute or event and define the filter conditions. * **Exclude users**: Select this checkbox to define the filter criteria for users to be excluded from the campaign. * **Send campaign to the users opted-out in preference management**: Select this check box to include users who opted out of preference management in the campaign. For more information, refer to [Preference Management](/user-guide/campaigns-and-channels/mobile-push/getting-started-with-mobile-push/preference-management-for-push-notifications). * **Reset filters**: Click this option to reset the segmentation filters. * **Show count**: Click this button to display the total number of users who are currently in the configured segment.

If you have the [*Portfolio*](/user-guide/settings/account/portfolio/portfolio) feature enabled, you can create user segments by combining user data and behavior from different apps and websites (Projects) within your workspace. For more information, refer to [Segmentation in a Multi-Project Portfolio](/user-guide/segment/advanced-concepts/segmentation-in-a-multi-project-portfolio). ### Control Groups This section contains information about control groups for the campaign. To exclude users in the control groups, do the following: * Turn the **Global control group** toggle on to exclude the users in the control group from the campaign's target segment. * Turn the **Campaign control group** toggle on to exclude a fixed percentage of users in the campaign from the campaign's target segment. Specify the percentage of users to be excluded from the campaign in the box below the toggle. For more information about control groups, refer to [Control Groups](/user-guide/campaigns-and-channels/getting-started/introduction/control-groups).

Click **Next** or use the tabs at the top of the create campaign navigation to move to Step 2. ## Step 2: Content In this step, you can define the content of your campaign based on your connected app. ### Configure 1. **Connector**: Select the connector you want to use for this campaign. The connectors will vary depending on the selected Connected App. For example, Telegram's connectors include *Send a message to user or channel*. 2. **Select connection**: Select a connection you added to the MoEnagage App marketplace for this campaign. ### Content You can configure your campaign with the required information based on your selected Connected App. If you have created a new Connected App, you must enter the information defined by your app's configuration. [Here is a list](/user-guide/settings/account/security/overview) of MoEngage-created Connected Apps. You can learn how to set up each one and run campaigns on it. ### Test campaign Test campaigns enable previewing the campaign on a test device to ensure that your notification is conveyed as desired. You can test the campaign you created 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 * Google Advertising Identifier * iOS Identifier for Advertising TestCampaign (1).png

## Step 3: Scheduling and Goals This section contains the following: * Choose when the campaign should be delivered to your users and the periodicity of delivery. * Choose the conversion goals and revenue metrics to be tracked for the campaign. ### Delivery Schedule Send the campaign immediately to the target users.

Send the campaign at the specified time, time zone, or predicted time. Select one of the following: | Field | Description | | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | At fixed time | This section helps you send the campaign on a specific date and time and contains the following fields: - **Campaign time zone** - the timezone 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 when the time of day at which the campaign should be sent. | | Send in user time zone | This section helps you send the campaign on a specific date and time within the time zone of the user and contains the following fields: - **Campaign time zone** - the timezone 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 when the time of day at which the campaign should be sent. - **Send if the user time zone has passed** - if the campaign's start time has passed in the user's timezone, you have the option to do the following: - - **Yes, send it** - send the campaign to the user even if the specified start time has passed in their timezone. - **No, don't send it** - do not send the campaign to the user as the specified start time has passed in their timezone. | | Best time for user (Merlin AI) | This section helps you send the campaign based on the MoEngage intelligence-determined date and time and contains the following fields: - **Campaign time zone** - the timezone in which the campaign should be sent. - **Start date** - the date on which the campaign should be sent. - **Start time** - the time at which the campaign should be sent. Select am or pm depending on when the time of day at which the campaign should be sent. - **Send messages based on best time only till** - the time until which the campaign should be sent based on the best time to send (BTS). Select am or pm depending on when the time of day at which the campaign should be sent. Click **View best time distribution** to see the best time for sending push notifications represented in a graphical manner. - **If user's best time is outside this time window** - lets you choose when the campaign is to be sent when the user's BTS is outside the time window selected. You can do the following: - - Send the campaign to the user either at the start or end time by selecting **Send message at start time or end time**. - Avoid sending the campaign to the user by selecting **Do not send message**. - **If user's best time is not available** - lets you choose when the campaign is to be sent when the user does not have BTS. You can do the following: - - Send the campaign to the user at the start time by selecting **Yes, send at start time**\*.\* - Send the campaign to the user at the app's best time by selecting **Yes, send at the app's best time**\*.\* - Avoid sending the campaign to the user by selecting **Do not send message**. For more information, refer to the [Best time to send (BTS)](/user-guide/ai-and-intelligence/timing/best-time-to-send). |

Choose this option to send the campaign on a specified date and time. The following fields are available in this section: * **Campaign time zone** - the timezone 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 when the time of day at which the campaign should be sent. * **Periodic** - the periodicity of the campaign. You can choose from three options: Daily, Weekly, and Monthly, from the radio buttons available to the left of the screen. | Periodicity | Description | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Daily | **Repeat every** - This option lets you specify the number of days after which the campaign should be repeated. | | Weekly | **Repeat every** - This option lets you specify the number of weeks for which the campaign should be repeated. **Repeat on** - This option lets you specify the day(s) of the week on which the campaign is to be sent (For example, if you wish to send the campaign every Monday, Wednesday, and Friday, select these days in this option). | | Monthly | **Repeat every** - This option lets you specify the number of months for which the campaign should be repeated. **Repeat on** - This option lets you do the following: - Days of month - Choose this option for repeating campaigns that are date specific. Select the date(s) of the month the campaign is to 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) doesn't exist in the month specified (as it is a shorter month), a campaign will be sent on the last date. (For example, if the 30th and 31st are selected and the month is February, one campaign would be sent on the 28th). - Days of week - Choose this option to specify the day(s) of the week on which the campaign is to be sent (For example, if you wish to send the campaign every Monday, Wednesday, and Friday, select these days in this option). **Note**: In case of a day of the week not existing in a month (for example, fifth Saturday), the campaign would be skipped for that instance. And in case of overlap (for example, 4th Monday and last Monday), only one instance would be sent. | |

| | * **Ends** - the date on which the campaign will end. The following options are available: * **Never** - the campaign will be scheduled to run daily. * **On** - the campaign will end on the end date specified in the **End Date** field. * **After** - the campaign will end after the number of occurrences specified in the **occurrences** field. Choose this option to send the campaign on a specified date and time. The following fields are available in this section: * **Campaign time zone** - the timezone 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 when the time of day at which the campaign should be sent. * **Periodic** - the periodicity of the campaign. You can choose from three options: Daily, Weekly, and Monthly, from the radio buttons available to the left of the screen. | Periodicity | Description | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Daily | **Repeat every** - This option lets you specify the number of days after which the campaign should be repeated. | | Weekly | **Repeat every** - This option lets you specify the number of weeks for which the campaign should be repeated. **Repeat on** - This option lets you specify the day(s) of the week on which the campaign is to be sent (For example, if you wish to send the campaign every Monday, Wednesday, and Friday, select these days in this option). | | Monthly | **Repeat every** - This option lets you specify the number of months for which the campaign should be repeated. **Repeat on** - This option lets you do the following: - Days of month - Choose this option for repeating campaigns that are date specific. Select the date(s) of the month the campaign is to 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) doesn't exist in the month specified (as it is a shorter month), a campaign will be sent on the last date. (For example, if the 30th and 31st are selected and the month is February, one campaign would be sent on the 28th). - Days of week - Choose this option to specify the day(s) of the week on which the campaign is to be sent (For example, if you wish to send the campaign every Monday, Wednesday, and Friday, select these days in this option). **Note**: In case of a day of the week not existing in a month (for example, fifth Saturday), the campaign would be skipped for that instance. And in case of overlap (for example, 4th Monday and last Monday), only one instance would be sent. | |

| | * **Ends** - the date on which the campaign will end. The following options are available: * **Never** - the campaign will be scheduled to run daily. * **On** - the campaign will end on the end date specified in the **End Date** field. * **After** - the campaign will end after the number of occurrences specified in the **occurrences** field. * **Send if the user time zone has passed** - if the campaign's start time has passed in the user's timezone, you have the option to do the following: * **Yes, send it** - send the campaign to the user even if the specified start time has passed in their timezone. * **No, don't send it** - do not send the campaign to the user as the specified start time has passed in their timezone. Choose this option to send the campaign on a specified date and time. The following fields are available in this section: * **Campaign time zone** - the timezone in which the campaign should be sent. * **Start date** - the date on which the campaign should be sent. * **Start time** - the time at which the campaign should be sent. Select am or pm depending on when the time of day at which the campaign should be sent. * **Send messages based on best time only till** - the time until which the campaign should be sent based on the best time to send (BTS). Select am or pm depending on when the time of day at which the campaign should be sent. Click **View best time distribution** to see the best time for sending push notifications represented in a graphical manner. * **If user's best time is outside this time window** - lets you choose when the campaign is to be sent when the user's BTS is outside the time window selected. You can do the following: * Send the campaign to the user either at the start or end time by selecting **Send message at start time or end time**. * Avoid sending the campaign to the user by selecting **Do not send message**. * **If user's best time is not available** - lets you choose when the campaign is to be sent when the user does not have BTS. You can do the following: * Send the campaign to the user at the start time by selecting **Yes, send at start time**\*.\* * Send the campaign to the user at the app's best time by selecting **Yes, send at the app's best time**\*.\* * Avoid sending the campaign to the user by selecting **Do not send message**.\ For more information, refer to the [Best time to send (BTS)](/user-guide/ai-and-intelligence/timing/best-time-to-send). * **Periodic** - the periodicity of the campaign. You can choose from three options: Daily, Weekly, and Monthly, from the radio buttons available to the left of the screen. | Periodicity | Description | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Daily | **Repeat every** - This option lets you specify the number of days after which the campaign should be repeated. | | Weekly | **Repeat every** - This option lets you specify the number of weeks for which the campaign should be repeated. **Repeat on** - This option lets you specify the day(s) of the week on which the campaign is to be sent (For example, if you wish to send the campaign every Monday, Wednesday, and Friday, select these days in this option). | | Monthly | **Repeat every** - This option lets you specify the number of months for which the campaign should be repeated. **Repeat on** - This option lets you do the following: - Days of month - Choose this option for repeating campaigns that are date specific. Select the date(s) of the month the campaign is to 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) doesn't exist in the month specified (as it is a shorter month), a campaign will be sent on the last date. (For example, if the 30th and 31st are selected and the month is February, one campaign would be sent on the 28th). - Days of week - Choose this option to specify the day(s) of the week on which the campaign is to be sent (For example, if you wish to send the campaign every Monday, Wednesday, and Friday, select these days in this option). **Note**: In case of a day of the week not existing in a month (for example, fifth Saturday), the campaign would be skipped for that instance. And in case of overlap (for example, 4th Monday and last Monday), only one instance would be sent. | |

### Conversion Goals You can add conversion goals to track the business metrics for your campaigns. You can track a maximum of five conversion goals. You can choose any app event as a conversion goal activity and set more than one conversion goal. The first goal will be treated as a primary goal. For example, if you want to track the number of customers who have purchased an iPhone after your campaign was sent. (Event: Purchase event, Product: iPhone). Your conversion goal setup might be similar to the following image:

With multiple conversion goals, you can track more than one business metric or visualize a funnel for your user actions. For example, if you want to check the following, you can do so with multiple conversion goals. * How many users have 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 the revenue generated by your product after sending a communication. To track revenue performance, enable the **Revenue performance** toggle for the conversion goal for which you want to track the revenue. In the example here, to track revenue for *orderSuccessful* events, you must enable the **Revenue performance** toggle.

After choosing the goal, you can select the numeric attribute that captures the order's total monetary value. In this example, *cartValue* contains the total order value. You can choose the currency in which your monetary value is being reported.

**Set Attribution window**: You can set an attribution window (a time period or window that is calculated since the user has received/clicked the campaign, for which you want to attribute the conversion goals to a specific campaign.) By default, it is set for 36 hours while the maximum attribution window can be set up to 10 days. In the example below, the attribution window is set to 10 days. attribution window.png

### Remove Duplicate Users Applicable to One Time and Periodic campaigns only. In the **Remove duplicate users** list, select the user attributes that you can use to delete the duplicate customers.

Your campaign is now ready to be sent. 1. Click **Publish**. The Publish campaign dialog box appears, prompting for confirmation. 2. Click **Publish**. After the campaign is created successfully, the Campaign Info page is displayed. # Next Steps * [Campaign Analytics for Connected Apps](/user-guide/campaigns-and-channels/connected-apps/analyze/connected-apps-campaign-analytics). All MoEngage AI products, which were previously referred to as *Sherpa AI*, are now known as *Merlin AI*.