Show Menu
TÓPICOS×

Mensagens no aplicativo

É possível fornecer mensagens no aplicativo disparadas dos dados do Analytics ou de eventos. Depois da implementação, as mensagens são fornecidas dinamicamente ao aplicativo e não necessitam 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 acessar 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 .
Para usar as mensagens no aplicativo, você deve ter a versão 4.2 ou posterior do SDK.
É possível criar mensagens e regras no Adobe Mobile Services que definem quando as mensagens são exibidas. Para obter mais informações, consulte Criar uma mensagem no aplicativo . Para exibir mensagens no aplicativo, devem ser feitas atualizações no SDK. É possível completar essas etapas mesmo que 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 do Android Mobile rastreiam as seguintes métricas de suas mensagens no aplicativo:
  • Para mensagens no aplicativo em tela inteira ou no estilo 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 de tela cheia, é possível especificar uma imagem de fallback. Se a mensagem não consegue recuperar a imagem desejada da Web, o SDK tenta carregar a imagem com o mesmo nome da pasta de ativos do aplicativo. Essa ação permite exibir a mensagem na forma original, mesmo que o usuário esteja offline, ou que a imagem predeterminada não possa ser alcançada.
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)
    Define o ícone pequeno que será utilizado para notificações criadas pelo SDK. Este ícone é exibido na barra de status, e é a imagem secundária exibida quando o usuário visualiza a notificação por completo 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);