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.
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.
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.
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.
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.
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:
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
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.
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.
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);