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.

IMPORTANTE

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.

Para começar, acesse o Launch.
Para ver o conteúdo dos repositórios SDK da Experience Platform, acesse Github: SDKs da Adobe Experience Platform.

IMPORTANTE

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.

IMPORTANTE

Para usar mensagens no aplicativo, você deve ter o SDK versão 4.2 ou posterior.

Você pode 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, 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 são entregues de forma dinâmica ao seu aplicativo e exibidas sem uma atualização da loja de aplicativos.

Ativar mensagens no aplicativo

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.

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" />

Importe a biblioteca:
```
import com.adobe.mobile.*;
```
Em cada chamada collectLifecycleData, use this para fornecer uma referência à atividade atual:
```
@Override 
public void onResume() { 
    Config.collectLifecycleData(this); 
}
```

Verifique se o arquivo ADBMobileConfig.json contém as configurações exigidas para mensagens no aplicativo.

IMPORTANTE

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 a mensagem em sua forma original, mesmo se o usuário estiver offline ou se a imagem predeterminada estiver inacessível.

IMPORTANTE

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á utilizado para notificações criadas pelo SDK. Esse ícone aparecerá na barra de status e será a imagem secundária 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 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); 
```