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

Neste guia de início rápido, mostramos como configurar o Firebase In-App Messaging e enviar sua primeira mensagem.


Antes de começar

Antes de começar, adicione o Firebase ao seu projeto da Apple.

Adicionar o SDK do Firebase In-App Messaging ao 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
  3. Escolha a biblioteca In-App Messaging.
  4. Adicione a sinalização -ObjC à seção Outras sinalizações do vinculador das configurações de compilação do destino.
  5. 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. Você pode selecionar a biblioteca com ou sem o recurso de coleta de IDFAs.
  6. 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, o Firebase In-App Messaging só recupera mensagens do servidor uma vez por dia. Isso pode dificultar o teste. Por isso, o console do Firebase 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 app de teste, execute o app 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 ID de instalação do Firebase (FID, na sigla em inglês), envie uma mensagem de teste para testar a configuração do Firebase In-App Messaging:

  1. No console do Firebase, abra a página Mensagens.
  2. Se esta for sua primeira campanha, clique em Criar sua primeira campanha.
    1. Selecione Mensagens no app do Firebase e clique em Criar.
  3. Caso contrário, na guia Campanhas, clique em Nova campanha.
    1. Selecione Mensagens no app.
  4. Digite um Título para sua primeira mensagem.
  5. Clique em Testar no dispositivo.
  6. Insira o ID de instalação Firebase do seu app no campo Adicionar um ID de instalação.
  7. Clique em Testar para enviar a mensagem.

O Firebase In-App Messaging envia sua mensagem de teste assim que você clica em Testar. Para ver a mensagem, feche e abra novamente o app no dispositivo de teste.

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.