[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-08-29。"],[],[],null,["\u003cbr /\u003e\n\nBefore you begin\n\nMake sure you complete the steps in [Get\nStarted](/docs/in-app-messaging/get-started) to\nensure you have an app with Firebase enabled and have added the latest Firebase In-App Messaging\nSDK.\n\nCreate a new campaign\n\nSet up your new campaign in the Firebase console's\n[Messaging page](https://console.firebase.google.com/project/_/messaging).\n\n- If you are a first time user, click **Create your first campaign**.\n- If not, click **New campaign**.\n\nStep 1: Style and content\n\nIn the console, use Firebase In-App Messaging message templates to incorporate different\nfeatures to serve different purposes with your in-app messages.\n\n[Explore use cases](/docs/in-app-messaging/explore-use-cases) to see\nexamples for stylizing the messages templates.\n\n\n| Message Template Type |||| Feature | Feature Description |\n| Feature | Feature Description |\n|---------|---------------------|------------|--------|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Card | Modal | Image only | Banner |\n| lens | lens | lens | lens | Image | Provide an HTTPS Image URL. You can use [Firebase Hosting](/docs/hosting) to host your images. |\n| lens | lens | lens | lens | Action | Use weblinks or deep links to send your users to external pages or specific pages in your app. You can use [Firebase Dynamic Links](/docs/dynamic-links) to create and manage deep links. Templates **Modal** and **Image only** include an X button, allowing users to dismiss the message. |\n| lens | lens | | lens | Text/background color | Customize the message visuals by entering the Hex Color Code or using the color gradient to find the specific hue that matches your brand. |\n| lens | lens | | lens | Message title/body | Catch your user's attention with a relevant header and a concise description. Firebase automatically translates and scales your text to accommodate your users. |\n| lens | lens | | | Primary button | The default button action is set to dismiss the message. Provide a URL to redirect users as the action. |\n| lens | | | | Secondary button | The default button action is set to dismiss the message. Provide a URL to redirect users as the action. |\n\n\u003cbr /\u003e\n\n1. In Firebase console's **Compose campaign** window, customize your\n message to your liking with the features available to each template.\n\n2. On the right-hand side of the **Compose campaign** window, preview your message\n in landscape or portrait orientation for a phone or tablet device.\n\n The in-console preview provides a general idea of how your message appears\n on a mobile device. Actual message rendering varies depending on the device.\n [Test with a real device to see the exact rendering](/docs/in-app-messaging/get-started#send_a_test_message).\n3. If desired, define custom metadata for your campaign. This metadata will be available\n on the client side using SDK callbacks when a campaign is displayed to a user.\n For example, you might want to tag the campaign with a promo code that\n you can use on the client.\n\nStep 2: Target your users\n\n1. Enter a name for your campaign.\n\n This name is used for campaign reporting and is not part of the visible\n message.\n2. (Optional) Provide a campaign description.\n\n This description is used for campaign reporting and is not part of the visible\n message.\n3. Click on the **Select app** dropdown and identify which\n app you want to associate with this campaign.\n\n4. (Optional) Click the **and** button to further narrow down your\n target users.\n\n Use the **Select** dropdown to choose additional specifications.\n5. View the percentage of potential users that are eligible for this\n campaign.\n\n This number is estimated based on active users who contacted the service\n in the last 7 days. Eligible users only see this message if a trigger\n condition occurs.\n6. (Optional) If your app targets users in multiple languages, you will be\n prompted to localize the campaign in those languages. Use the dialog to\n either add your own translations or use Google Translate to localize the\n campaign easily.\n\nStep 3: Scheduling your message\n\n1. Describe a start date and time for your campaign.\n\n Your campaign can start when you publish the campaign or have a scheduled\n start.\n2. Describe an end date and time for your campaign.\n\n Your campaign can run indefinitely or have a scheduled endpoint.\n3. Click Event + to add at least one trigger event.\n\n - You can enter default events or [events logged through Firebase Analytics](/docs/analytics/android/events) to trigger your in-app message. These events can be user actions, system events, or errors.\n - Your in-app message is triggered when any of your events occur.\n4. Specify your per-device frequency limit. The limit allows you to\n control how often your users see your message.\n\n - By default, a campaign is not shown after it has been viewed by (that is, impressed on) the user once.\n - Or, you can set the frequency of messages in days.\n\nStep 4: Conversion events (optional)\n\nFirebase tracks the number of impressions that result in a completed conversion\nevent.\n\n1. In the **Compose campaign** window, use the **Select conversion event**\n dropdown to choose from:\n\n - The default conversion events.\n - Any [events you enabled as conversions](https://support.google.com/firebase/answer/6317522#enable).\n2. After you publish the campaign, go to the\n [Messaging page](https://console.firebase.google.com/project/_/messaging)\n and click on the campaign's name to see data related to the\n campaign's conversion history.\n\nPublishing your campaign\n\nAfter modifying your campaign, you can click **Save as draft** for the option to\nreturn and edit the campaign in draft status.\n\nOr, you can click **Publish** to release your message to targeted users on the\nscheduled date. You can edit your campaign after it has been published.\n\nOnce you stop a published campaign, you will not be able to publish it again.\nHowever, you may stop or edit a running campaign at any time. You can also\nduplicate an existing one to make slight variations and avoid creating a\ncompletely new campaigns.\n\nGet AI insights for messaging campaigns with Gemini in Firebase\n\nGemini in Firebase\nprovides messaging campaign summarization, insights,\nand guidance to improve your Firebase Cloud Messaging and In-App Messaging\ncampaign performance. By analyzing campaign data,\nGemini in Firebase can help you understand your campaigns' reach and impact\nand suggests strategies to improve user engagement and growth.\n\nAccess AI insights for messaging campaigns\n\nTo use messaging campaign AI insights, make sure that your project has the\nfollowing:\n\n- Gemini in Firebase is enabled for your project. Learn more at\n [Set up Gemini in Firebase](/docs/gemini-in-firebase/set-up-gemini).\n\n- Firebase Cloud Messaging or In-App Messaging is enabled in your Firebase\n project.\n\n- At least one campaign exists and appears in the Firebase console.\n\nAfter ensuring these requirements are met:\n\n1. Open [**Messaging**](//console.firebase.google.com/project/_/messaging) in the\n Firebase console to access campaign data.\n\n2. After your campaign data loads, click **Generate AI insights**.\n\n A summary and analysis of your messaging campaigns appears.\n\nPricing\n\nSee\n[Gemini in Firebase pricing](/docs/gemini-in-firebase#pricing) for more\ninformation."]]