Comece a usar o recurso "Mensagens no app" do Firebase

Veja neste guia de início rápido como configurar o recurso Firebase In-App Messaging e como enviar sua primeira mensagem.


Antes de começar

Antes de começar, certifique-se de adicionar o Firebase ao seu projeto da Apple.

Adicionar o Firebase In-App Messaging SDK ao seu projeto

Use o Swift Package Manager para instalar e gerenciar as dependências do Firebase.

  1. No Xcode, com seu projeto do app aberto, navegue até File > Add Packages.
  2. Quando solicitado, adicione o repositório do SDK do Firebase para as plataformas Apple:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Escolha a biblioteca In-App Messaging.
  5. Adicione a sinalização -ObjC à seção Outras sinalizações do vinculador das configurações de compilação do destino.
  6. Para usar In-App Messaging, é necessário ativar Google Analytics no seu Projeto do Firebase e adicionar o SDK do Firebase para Google Analytics ao app. É possível selecionar a biblioteca com ou sem o recurso de coleta de IDFAs. Consulte nossas perguntas frequentes sobre a organização mais recente dos módulos no Google Analytics para SDK do Firebase.
  7. Quando terminar, o Xcode começará a resolver e fazer o download das dependências em segundo plano automaticamente.

Agora, inicialize o SDK no seu app:

  1. Importe o módulo do Firebase na estrutura App ou UIApplicationDelegate, caso ainda não tenha feito isso:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. Configure também uma instância compartilhada do FirebaseApp, normalmente no inicializador do App ou no método application(_:didFinishLaunchingWithOptions:) do delegado do app, caso ainda não tenha feito isso:
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. Compile e execute seu aplicativo.

Enviar uma mensagem de teste

Receber o ID de instalação do app

Para economizar energia, Firebase In-App Messaging só recupera notificações do servidor uma vez por dia. Isso pode dificultar o teste. Por isso, o Firebase console permite especificar um dispositivo de teste que exibe mensagens sob demanda.

O dispositivo de teste é determinado por um ID de instalação Firebase fornecido pelo serviço de instalações Firebase. Para encontrar o ID de instalação do aplicativo de teste, execute o aplicativo com o argumento de comando de ambiente de execução -FIRDebugEnabled:

  1. Abra seu projeto do Xcode e selecione Produto > Esquema > Editar esquema… na barra de menu superior.
  2. Abra a guia Argumentos da caixa de diálogo mostrada.
  3. Clique em + Adicionar itens em Argumentos transmitidos na inicialização.
  4. Digite "-FIRDebugEnabled" no campo recém-criado.
  5. Clique em Fechar e execute seu aplicativo.

Depois que seu aplicativo começar a ser executado, procure a seguinte linha nos registros do console do Xcode:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID

Enviar uma mensagem para seu dispositivo de teste

Depois de iniciar o app no dispositivo de teste e receber o Firebase ID de instalação (FID), envie uma mensagem para testar a Firebase In-App Messaging configuração:

  1. No console do Firebase, acesse DevOps e engajamento > Mensagens.

  2. Inicie o fluxo de trabalho para configurar uma nova campanha:

    • Se esta for sua primeira campanha:

      1. Clique em Criar sua primeira campanha.
      2. Selecione Mensagens no app do Firebase e clique em Criar.
    • Se você já criou campanhas:

      1. Na guia Campanhas, clique em Nova campanha.
      2. Selecione Mensagens no app.
  3. Digite um Título para sua primeira mensagem.

  4. Clique em Testar no dispositivo.

  5. Digite o ID de instalação do Firebase do seu app no campo **Adicionar um ID de instalação**.Firebase

  6. Clique em Testar para enviar a mensagem. Ela será enviada imediatamente.

  7. Para ver a mensagem no dispositivo de teste, feche e abra novamente o app.

Para confirmar se o dispositivo é de teste, procure a seguinte mensagem de registro:

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.