Pular para o conteúdo principal
As mensagens in-app (IAMs) são uma ferramenta poderosa para notificar usuários em versões mais antigas do seu aplicativo de que uma versão mais recente está disponível e incentivá-los a atualizar.

​
Requisitos

  • Seu aplicativo deve estar usando a versão mais recente v5 do SDK do OneSignal

​
Configuração

Cenário de exemplo: A versão mais recente do nosso aplicativo é 1.0.1. Queremos direcionar usuários na versão 1.0.0 e anteriores com uma mensagem in-app solicitando que eles atualizem.

​
1. Obter a versão mais recente do seu aplicativo

O OneSignal detecta App Version com base no seguinte: iOS: A Version encontrada no Xcode your main app Target > General > Identity
Android: O versionCode encontrado no arquivo build.gradle do seu aplicativo
Se você não tiver acesso ao Xcode e/ou Android Studio, peça esses valores ao seu desenvolvedor.
Observe que as versões do app para iOS e Android são diferentes! Este é um motivo pelo qual precisamos criar dois segmentos separados e mensagens in-app.O 2º motivo pelo qual devemos usar dois segmentos separados é porque a mensagem in-app pode conter links diferentes para iOS e Android, como veremos a seguir.

​
2. Configurar os segmentos

Você precisará criar dois segmentos, um para iOS e um para Android. iOS:
  • Nome do segmento: iOS App version less than 1.0.1
  • Filtros: App Version is less than 1.0.1 AND Device Type is iOS.
Android:
  • Nome do segmento: Android App version less than 10001
  • Filtros: App Version is less than 10001 AND Device Type is Android.

​
3. Configurar as mensagens in-app

Navegue até Messages > In-App > New Message > New In-App. Comece a partir do design pré-construído New Feature Announcement ou crie o seu próprio do zero.
Nomeie a mensagem com algo que reflita que é para usuários iOS.

​
Adicionar seu público

Selecione o segmento específico iOS App version less than 1.0.1.

​
Atualizar a mensagem

Atualize a mensagem como achar melhor. Para navegar o usuário até sua listagem na app store, adicione uma ação de clique de URL a um botão ou vários elementos
Você pode inserir o link da loja como URL. Detalhes sobre como obter o link correto da loja para seu aplicativo podem ser encontrados nos seguintes links:

​
3. Gatilhos

Recomendamos usar o gatilho On app open para garantir que a mensagem seja exibida quando o usuário abrir o aplicativo.

​
4. Agendamento e frequência

Se você agendou a atualização do aplicativo para algum momento no futuro, você pode agendar a mensagem para começar a ser exibida naquele momento. Dependendo de quão agressivo você deseja ser com seus prompts de atualização, você pode definir a frequência “How often do you want to show this message?” para:
  • Every time trigger conditions are satisfied - o que significa toda vez que eles abrem o aplicativo neste exemplo.
  • Multiple times - defina o número total de vezes para mostrar a mensagem e qual atraso entre elas. Por exemplo, 100 vezes com um intervalo de 3 dias entre elas. Mostrará a mensagem a cada 3 dias por até 100 vezes.

​
5. Salvar como rascunho e duplicar para Android

Clique no botão Save as Draft para salvar a mensagem. Na página In-App Messages, clique em Options > Duplicate ao lado da mensagem que você acabou de salvar. Atualize o seguinte para seus usuários Android:
  • O nome do IAM para refletir que é para usuários Android
  • Defina o segmento como Android App version less than 10001
  • Atualize a URL para o link da loja Android
  • Adicione quaisquer alterações adicionais à mensagem para torná-la única para usuários Android
Clique em Save as Draft para salvar a mensagem.

​
Testando

Antes de publicar suas mensagens, sugerimos testá-las com as seguintes etapas:
1

Encontre seu dispositivo de teste e defina como uma Assinatura de Teste

  • Encontre seu dispositivo de teste e defina-o como uma Assinatura de Teste.
  • Certifique-se de que o dispositivo de teste está na versão inferior do seu aplicativo.
2

Atualize o segmento para incluir Test Users

  • Abra a mensagem in-app que você deseja testar.
  • Clique no Segmento e adicione um filtro And para Test Users.
    • Isso garantirá que a mensagem seja exibida apenas para seus dispositivos de teste
  • Por exemplo, se o seu dispositivo de teste estiver no iOS, o segmento ficará assim:
  • Clique em Update Segment para salvar as alterações.
3

Publique a mensagem

  • Clique em Update Message para atualizar a mensagem in-app.
  • Clique em Options > Resume ao lado da mensagem para ativá-la.
4

Verifique se a mensagem é exibida

  • Feche o aplicativo no dispositivo de teste.
  • Aguarde 1 minuto.
  • Abra o aplicativo no seu dispositivo de teste.
  • Você deve ver a mensagem se:
    • O dispositivo é uma Assinatura de Teste
    • O dispositivo está na versão inferior do seu aplicativo.
    • O segmento está definido como Test Users.

​
Checklist para entrar em produção

Quando estiver pronto para entrar em produção:
  • Atualize os Segmentos para remover o filtro Test Users.
  • Verifique o Schedule para garantir que está definido para a data e hora corretas.
  • Clique em Update Message para atualizar a mensagem in-app.
Você terminou! Quaisquer usuários que abrirem seu aplicativo em uma versão mais antiga serão notificados sobre a atualização do seu aplicativo.Retorne à mensagem in-app após algum tempo para verificar o progresso. Você também pode obter análises de mensagens in-app com Event Streams ou Integrações de terceiros.
Need help?Chat with our Support team or email [email protected]Please include:
  • Details of the issue you’re experiencing and steps to reproduce if available
  • Your OneSignal App ID
  • The External ID or Subscription ID if applicable
  • The URL to the message you tested in the OneSignal Dashboard if applicable
  • Any relevant logs or error messages
We’re happy to help!