Compose a campaign

Before you begin

Make sure you complete the steps in Get Started to ensure you have an app with Firebase enabled and have added the latest Firebase In-App Messaging SDK.

Create a new campaign

Set up your new campaign in the Firebase console's Messaging page .

• If you are a first time user, click Create your first campaign.
• If not, click New campaign.

Step 1: Style and content

In the console, use Firebase In-App Messaging message templates to incorporate different features to serve different purposes with your in-app messages.

Explore use cases to see examples for stylizing the messages templates.

1. In Firebase console's Compose campaignwindow, customize your message to your liking with the features available to each template.

2. On the right-hand side of the Compose campaignwindow, preview your message in landscape or portrait orientation for a phone or tablet device.

   The in-console preview provides a general idea of how your message appears on a mobile device. Actual message rendering varies depending on the device. Test with a real device to see the exact rendering .

3. If desired, define custom metadata for your campaign. This metadata will be available on the client side using SDK callbacks when a campaign is displayed to a user. For example, you might want to tag the campaign with a promo code that you can use on the client.

Step 2: Target your users

1. Enter a name for your campaign.

   This name is used for campaign reporting and is not part of the visible message.

2. (Optional) Provide a campaign description.

   This description is used for campaign reporting and is not part of the visible message.

3. Click on the Select appdropdown and identify which app you want to associate with this campaign.

4. (Optional) Click the andbutton to further narrow down your target users.

   Use the Selectdropdown to choose additional specifications.

5. View the percentage of potential users that are eligible for this campaign.

   This number is estimated based on active users who contacted the service in the last 7 days. Eligible users only see this message if a trigger condition occurs.

6. (Optional) If your app targets users in multiple languages, you will be prompted to localize the campaign in those languages. Use the dialog to either add your own translations or use Google Translate to localize the campaign easily.

Step 3: Scheduling your message

1. Describe a start date and time for your campaign.

   Your campaign can start when you publish the campaign or have a scheduled start.

2. Describe an end date and time for your campaign.

   Your campaign can run indefinitely or have a scheduled endpoint.

3. Click Event + to add at least one trigger event.

   • You can enter default events or events logged through Firebase Analytics to trigger your in-app message. These events can be user actions, system events, or errors.
   • Your in-app message is triggered when any of your events occur.

4. Specify your per-device frequency limit. The limit allows you to control how often your users see your message.

   • By default, a campaign is not shown after it has been viewed by (that is, impressed on) the user once.
   • Or, you can set the frequency of messages in days.

Step 4: Conversion events (optional)

Firebase tracks the number of impressions that result in a completed conversion event.

1. In the Compose campaignwindow, use the Select conversion eventdropdown to choose from:

   • The default conversion events.
   • Any events you enabled as conversions .

2. After you publish the campaign, go to the Messaging page and click on the campaign's name to see data related to the campaign's conversion history.

Publishing your campaign

After modifying your campaign, you can click Save as draftfor the option to return and edit the campaign in draft status.

Or, you can click Publishto release your message to targeted users on the scheduled date. You can edit your campaign after it has been published.

Once you stop a published campaign, you will not be able to publish it again. However, you may stop or edit a running campaign at any time. You can also duplicate an existing one to make slight variations and avoid creating a completely new campaigns.