Show Menu
TÓPICOS×

Mensagens no aplicativo

Você pode fornecer mensagens no aplicativo que são acionadas a partir de qualquer evento ou dado de análise. Após a implementação, as mensagens são entregues dinamicamente ao aplicativo e não exigem uma atualização de código.

Nova versão do SDK da Adobe Experience Cloud

Procurando informações e documentação relacionadas ao Adobe Experience Platform Mobile SDK? Clique aqui para obter a documentação mais recente.
Em setembro de 2018, lançamos uma nova versão principal do SDK. Esses novos Adobe Experience Platform Mobile SDKs podem ser configurados por meio do Experience Platform Launch .
Se você estiver usando os SDKs para dispositivos móveis da Adobe Experience Platform com o Adobe Launch, também deve instalar a extensão Adobe Analytics Mobile Services para usar os recursos do Adobe Mobile Services, como mensagens no aplicativo e notificações por push. Para obter mais informações, consulte Adobe Analytics - Mobile Services . Para obter mais informações sobre como usar mensagens por push e mensagens no aplicativo com os SDKs da Experience Cloud, consulte Configurar mensagens por push e Configurar mensagens no aplicativo .
To use in-app messaging, you must have SDK version 4.2 or later.
Você pode criar mensagens e regras nos Adobe Mobile Services que definem quando as mensagens são exibidas. For more information, see Create an in-app message . Para exibir mensagens no aplicativo, as atualizações devem ser feitas no SDK. Você pode concluir essas etapas mesmo que ainda não tenha definido nenhuma mensagem. Depois de definir as mensagens, elas serão entregues dinamicamente ao seu aplicativo e exibidas sem uma atualização da app store.

Ativar mensagens no aplicativo

  1. Adicione a biblioteca ao projeto e implemente o ciclo de vida.
    Para obter mais informações, consulte Adicionar o SDK e o arquivo de configuração ao projeto IntelliJ IDEA ou Eclipse na Implementação principal e ciclo de vida .
  2. Atualize o arquivo AndroidManifest.xml para declarar a atividade de tela cheia e ativar o Manipulador de notificação de mensagem:
    <activity  
    android:name="com.adobe.mobile.MessageFullScreenActivity"  
    android:theme="@android:style/Theme.Translucent.NoTitleBar" /> 
    <receiver android:name="com.adobe.mobile.MessageNotificationHandler" />
    
    
    Se selecionar um layout modal (centro da página), selecione um dos temas a seguir para as mensagens:
    • Theme.Translucent.NoTitleBar.Fullscreen
    • Theme.Translucent.NoTitleBar
    • Theme.Translucent
    Por exemplo:
    <activity 
    android:name="com.adobe.mobile.MessageFullScreenActivity" 
    android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" 
    android:windowSoftInputMode="adjustUnspecified|stateHidden" /> 
    <receiver android:name="com.adobe.mobile.MessageNotificationHandler" />
    
    
  3. Importe a biblioteca:
    import com.adobe.mobile.*;
    
    
  4. Em cada chamada collectLifecycleData , use this para fornecer uma referência à atividade atual:
    @Override 
    public void onResume() { 
        Config.collectLifecycleData(this); 
    }
    
    
  5. Verifique se o arquivo ADBMobileConfig.json contém as configurações exigidas para mensagens no aplicativo.
    messages ou remotes são obrigatórios.
    Para que as mensagens no aplicativo sejam atualizadas dinamicamente, o objeto remotes deve ser apresentado e devidamente configurado:
    “messages”: [ 
        { 
            “messageId”: “de45c43c-37bf-441f-8cbd-cc3ba3469ebe”, 
            “template”: “fullscreen”, 
            “showOffline”: false, 
            “showRule”: “always”, 
            “endDate”: 2524730400, 
            “startDate”: 0, 
            “audiences”: [], 
            “triggers”: [], 
            “payload”: { // contents change depending on template 
                “html”: “<html>html code goes here</html>” 
            }, 
        }, 
        … 
    ] 
    “remotes” : { 
        “analytics.poi”: “https://assets.adobedtm.com/…/yourfile.json”, 
        “messages”: “https://assets.adobedtm.com/…/yourfile.json” 
    }
    
    
    Se esse objeto não estiver configurado, baixe um arquivo ADBMobileConfig.json atualizado do Adobe Mobile Services. Para obter mais informações, consulte Antes de começar .

Rastreamento de mensagens no aplicativo

Os SDKs móveis do Android rastreiam as seguintes métricas para as mensagens no aplicativo:
  • Para mensagens no aplicativo com estilo de tela cheia e de alerta:
    • Impressões : quando o usuário aciona uma mensagem no aplicativo.
    • Click-throughs : quando o usuário pressiona o botão Click-through .
    • Cancelamentos : quando o usuário pressiona Cancelar .
  • Para mensagens no aplicativo personalizadas em tela inteira, o conteúdo HTML na mensagem precisa incluir o código correto para notificar ao rastreamento de SDK sobre os seguintes botões:
    • Exemplo de rastreamento de click-through (redirecionamento):
      adbinapp://confirm/?url=https://www.yoursite.com
    • Exemplo de rastreamento de cancelamento (fechar):
      adbinapp://cancel

Imagem de fallback local

Ao criar uma mensagem em tela cheia, você pode especificar uma imagem de fallback. Se a mensagem não puder recuperar a imagem desejada da Web, o SDK tentará carregar a imagem com o mesmo nome da pasta de ativos do aplicativo. Isso permite que você mostre sua mensagem em sua forma original, mesmo se o usuário estiver offline ou se a imagem predeterminada for inacessível.
O nome do ativo de imagem de fallback é especificado ao configurar a mensagem no Adobe Mobile Services e é necessário assegurar que o recurso especificado esteja disponível.

Configuração de ícones de notificação

Os métodos a seguir permitem configurar os ícones pequeno e grande que aparecem na área de notificações e o ícone grande exibido quando as notificações aparecem na gaveta de notificações.
  • Config.setSmallIconResourceId(int resourceId)
    Defina o ícone pequeno que será usado para notificações criadas pelo SDK. Esse ícone é exibido na barra de status e é a imagem secundária que é exibida quando o usuário visualiza a notificação completa na central de notificações.
    • Esta é a sintaxe para este método:
      public static void setSmallIconResourceId(final int resourceId); 
      
      
    • Este é um exemplo de código para este método:
      Config.setSmallIconResourceId(R.drawable.appIcon);
      
      
  • Config.setLargeIconResourceId(int resourceId)
    Define o ícone grande que será utilizado para notificações criadas pelo SDK. Este ícone é a principal imagem exibida quando o usuário visualizar a notificação completa na central de notificações.
    • Esta é a sintaxe para este método:
      public static void setLargeIconResourceId(final int resourceId); 
      
      
    • Esta é a amostra de código para este método:
      Config.setLargeIconResourceId(R.drawable.appIcon);