Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Antes de começar
Conclua as etapas em Para começar para garantir que você tenha um app com o Firebase ativado e que tenha adicionado o SDK Firebase In-App Messaging mais recente.
Criar uma nova campanha
Configure sua nova campanha na página Mensagens do console do Firebase.
Se você for um usuário iniciante, clique em Criar sua primeira campanha.
Caso contrário, clique em Nova campanha.
Etapa 1: estilo e conteúdo
No console, use os modelos de mensagens Firebase In-App Messaging para incorporar recursos
diferentes e atender a diferentes finalidades com suas mensagens no app.
Forneça um URL de imagem HTTPS. Você pode usar o
Firebase Hosting para hospedar suas imagens.
lens
lens
lens
lens
Ação
Use links da Web ou links diretos para direcionar os usuários a páginas externas ou páginas específicas do seu aplicativo. Use o Firebase Dynamic Links para criar e gerenciar links diretos. Os modelos Modal e Somente imagem incluem um botão X, permitindo que os usuários dispensem a mensagem.
lens
lens
lens
Cor do fundo/texto
Personalize o visual da mensagem inserindo o código de cor hexadecimal ou usando o gradiente de cor para encontrar a tonalidade específica que corresponde à sua marca.
lens
lens
lens
Título/corpo da mensagem
Chame a atenção do usuário com um cabeçalho relevante e uma descrição concisa. O Firebase traduz e dimensiona automaticamente o texto para acomodar os usuários.
lens
lens
Botão principal
A ação do botão padrão é definida para dispensar a mensagem. Forneça um URL para redirecionar os usuários como a ação.
lens
Botão secundário
A ação do botão padrão é definida para dispensar a mensagem. Forneça um URL para redirecionar os usuários como a ação.
Na janela Escrever campanha do console Firebase, personalize sua mensagem como quiser com os recursos disponíveis para cada modelo.
No lado direito da janela Escrever campanha, visualize sua mensagem
na orientação paisagem ou retrato para um smartphone ou tablet.
Se desejar, defina metadados personalizados para sua campanha. Esses metadados estarão disponíveis no lado do cliente usando callbacks do SDK quando uma campanha for exibida para um usuário.
Por exemplo, é possível marcar a campanha com um código promocional que você pode usar no cliente.
Etapa 2: segmentar os usuários
Insira um nome para sua campanha.
Esse nome é usado para relatórios de campanha e não faz parte da mensagem visível.
(Opcional) Forneça uma descrição da campanha.
Essa descrição é usada para relatórios de campanha e não faz parte da mensagem visível.
Clique na lista suspensa Selecionar aplicativo e identifique qual aplicativo você quer associar a essa campanha.
(Opcional) Clique no botão e para restringir ainda mais seus usuários-alvo.
Use a lista suspensa Selecionar para escolher especificações adicionais.
Veja a porcentagem de usuários em potencial qualificados para esta campanha.
Esse número é estimado com base nos usuários ativos que entraram em contato com o serviço nos últimos sete dias. Os usuários qualificados só verão essa mensagem se ocorrer uma condição de acionamento.
(Opcional) Se seu aplicativo segmentar usuários em vários idiomas, você será solicitado a localizar a campanha nesses idiomas. Use a caixa de diálogo para adicionar suas próprias traduções ou use o Google Tradutor para localizar a campanha facilmente.
Etapa 3: programar sua mensagem
Descreva uma data e hora de início para sua campanha.
Sua campanha pode começar quando você publica a campanha ou ter um início programado.
Descreva uma data e hora de término para sua campanha.
Sua campanha pode ser exibida indefinidamente ou ter um fim programado.
Clique em Evento + para adicionar pelo menos um evento de acionamento.
É possível inserir eventos padrão ou
eventos registrados com o Firebase Analytics
para acionar sua mensagem no app. Esses eventos podem ser ações do usuário, eventos do sistema ou erros.
Sua mensagem no aplicativo é acionada quando ocorre um desses eventos.
Especifique o limite de frequência por dispositivo. O limite permite que você controle a frequência com que os usuários veem sua mensagem.
Por padrão, uma campanha não é exibida depois de ter sido visualizada (ou seja, impressa) pelo usuário uma vez.
Ou você pode definir a frequência das mensagens em dias.
Etapa 4: eventos de conversão (opcional)
O Firebase rastreia o número de impressões que resultam em um evento de conversão
concluído.
Na janela Escrever campanha, use o menu suspenso Selecionar evento de conversão para escolher:
Depois de publicar a campanha, acesse a
página Mensagens
e clique no nome da campanha para ver os dados relacionados ao
histórico de conversões da campanha.
Como publicar sua campanha
Depois de modificar sua campanha, clique em Salvar como rascunho para retornar e editar a campanha com status de rascunho.
Também é possível clicar em Publicar para liberar sua mensagem para os usuários segmentados na data programada. Você pode editar sua campanha depois que ela for publicada.
Depois de interromper uma campanha publicada, você não poderá publicá-la novamente.
No entanto, você pode interromper ou editar uma campanha em execução a qualquer momento. Você também pode duplicar uma existente para fazer pequenas variações e evitar a criação de campanhas completamente novas.
Receber insights de IA para campanhas de mensagens com o Gemini no Firebase
O Gemini no Firebase oferece resumos, insights
e orientações sobre campanhas de mensagens para melhorar a performance das campanhas
Firebase Cloud Messaging e In-App Messaging. Ao analisar os dados das campanhas,
o Gemini no Firebase ajuda a entender o alcance e o impacto das campanhas
e sugere estratégias para melhorar o engajamento e o crescimento dos usuários.
Acessar insights de IA para campanhas de mensagens
Para usar os insights de IA da campanha de mensagens, seu projeto precisa ter:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-05 UTC."],[],[],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."]]
