A Adobe recomenda o uso do Editor de SPA para projetos que exigem renderização do cliente baseada em estrutura de aplicativo de página única (por exemplo, Reagir). Saiba mais.
Ser capaz de alertar instantaneamente os usuários do aplicativo AEM Mobile com notificações importantes é fundamental para o valor de um aplicativo móvel e suas campanhas de marketing. Aqui, descrevemos as etapas que precisam ser seguidas para permitir que seu aplicativo receba notificações por push e como configurar e enviar permissões da AEM Mobile para o aplicativo instalado no telefone. Além disso, esta seção descreve como configurar o recurso Deep Linking para suas notificações por push.
As notificações por push não garantem o delivery; eles são mais como anúncios. É feito o melhor para garantir que todos os cidadãos os recebam, mas não se trata de um mecanismo de delivery garantido. Além disso, o tempo para enviar um push pode variar de menos de um segundo a até meia hora.
O uso de notificações por push com AEM requer algumas tecnologias diferentes. Primeiro, um provedor de serviço de notificação por push deve ser usado para gerenciar as notificações e os dispositivos (AEM ainda não faz isso). Dois provedores são configurados prontos para uso com AEM: Serviço de Notificação Simples da Amazon (ou SNS) e Pushwoosh. Em segundo lugar, a tecnologia push para o SO móvel em questão deve passar pelo serviço apropriado. Serviço de notificação por push (ou APNS) da Apple para dispositivos iOS; e Google Cloud Messaging (ou GCM) para dispositivos Android. Embora AEM não se comunique diretamente com esses serviços específicos da plataforma, algumas informações de configuração relacionadas devem ser fornecidas por AEM juntamente com as notificações para que esses serviços executem o push.
Depois de instalado e configurado (conforme explicado abaixo), ele funciona assim:
Esta versão do AEM é compatível com dispositivos móveis iOS e Android.
Para usar notificações por push em um aplicativo AEM Mobile, as seguintes etapas de alto nível devem ser realizadas.
Normalmente, um desenvolvedor AEM:
Enquanto um administrador AEM:
Vá para a página da Apple here para se familiarizar com o Serviço de notificação por push da Apple.
Para usar o APNS, você precisará de um arquivo Certificate (um arquivo .cer), uma Chave privada (um arquivo .p12) e uma Senha da chave privada da Apple. As instruções sobre como fazer isso podem ser encontradas aqui.
O Google está substituindo o GCM por um serviço semelhante chamado Firebase Cloud Messaging (FCM). Para obter mais informações sobre o FCM, clique aqui.
Vá para a página do Google here para se familiarizar com o Google Cloud Messaging for Android.
Você precisará seguir as etapas here para Criar um projeto de API do Google, Ativar o Serviço GCM e Obter uma chave de API. Você precisará da chave da API para enviar notificações por push para dispositivos Android. Além disso, registre seu Número do projeto, que também é chamado às vezes de Id do remetente do GCM.
As etapas a seguir mostram um método diferente de criação de chaves de API GCM:
com.adobe.cq.mobile.weretail.outdoorsapp
. (Se isso não funcionar, tente novamente com "test.test".)Registre a Server API Key. Esse valor é inserido no site do provedor de push.
AEM está configurado para usar um dos três serviços para notificações por push:
As configurações Amazon SNSe ** Pushwooshirão permitir que você envie mensagens enviadas de dentro AEM telas.
A configuração do Adobe Mobile Services permite configurar e enviar notificações por push do Adobe Mobile Services usando uma conta Adobe Analytics (mas o aplicativo precisa ser criado com esse conjunto de configurações para habilitar notificações por push do AMS).
Informações sobre o Amazon SNS e um link para criar uma nova conta AWS podem ser encontradas aqui. Você pode obter uma conta gratuita por um ano.
Se você não quiser usar o Amazon SNS, ignore essas etapas.
Siga estas etapas para configurar o Amazon SNS para notificações por push:
Registrar-se no Amazon SNS
Criar chave de acesso e ID
Uma Chave de acesso pode ser usada para vários aplicativos.
Para organizações que usam uma conta "AWS Sandbox", as etapas são muito semelhantes e descritas aqui:
Criar um tópico
Você pode criar vários tópicos para diferentes cenários, como desenvolvimento, teste, demonstração e assim por diante. O restante da configuração SNS pode permanecer o mesmo. Crie o aplicativo com um tópico diferente; as notificações por push enviadas para esse tópico serão recebidas somente pelo aplicativo criado com esse tópico.
Criar aplicativos da plataforma
Clique em Aplicativos e, em seguida, em Criar aplicativo da plataforma. Escolha um nome e selecione uma plataforma (APNS para iOS, GCM para Android). Dependendo da plataforma, outros campos precisarão ser preenchidos:
Repita a etapa acima uma vez para cada plataforma compatível. Para poder enviar para iOS e Android, dois aplicativos de plataforma devem ser criados.
Criar um pool de identidade
Configurar acesso
{ "Versão": "2012-10-17", "Declaração": [ { "Ação": [ "mobileanalytics:PutEvents", "cognito-sync:*", "SNS:CreatePlatformEndpoint", "SNS:Assinar" ], "Efeito": "Permitir", "Recurso": [ "*" ] } ] }
|
Se não quiser usar o Pushwoosh, ignore esta etapa.
Para utilizar Pushwoosh:
Registrar-se em Pushwoosh
Criar um Token de acesso de API
Criar um novo aplicativo
Se um segundo aplicativo estiver configurado em AEM com a mesma ID do aplicativo (e outros valores relacionados): TOKEN DE ACESSO da API e ID do GCM), todas as notificações por push enviadas pelo segundo aplicativo no AEM serão enviadas para qualquer outro aplicativo com essa ID do aplicativo.
Crie dois nós de conteúdo (um em app-config e outro em app-config-dev) chamados notificationsConfig:
<your app>
/shell/jcr:content/pge-app/app-config-dev/notificationsConfig<your app>
/shell/jcr:content/pge-app/app-config/notificationsConfigCom essas propriedades (arquivos .content.xml):
<jcr:root xmlns:jcr=" https://www.jcp.org/jcr/1.0" xmlns:nt=" https://www.jcp.org/jcr/nt/1.0">
jcr:PrimaryType="nt:unstructure"
excludeProperties="[appAPIAccessToken]"
path="…/…/…/…"
targetRootDirectory="www"
type="notificationssconfig"/>
O manipulador de sincronização de conteúdo procura esses nós e, se eles não estiverem lá, ele não grava o arquivo pge-notifications-config.json.
As bibliotecas de cliente de notificação por push devem ser adicionadas ao aplicativo seguindo estas etapas:
No CRXDE Lite:
Se as notificações por push forem removidas ou não forem usadas, por questões de espaço no aplicativo e para evitar mensagens de erro do console, remova essas clientlibs do aplicativo.
Para notificações por push, é necessário testar em um dispositivo real, pois os emuladores não podem receber notificações por push.
Para iOS, você precisará usar um computador Mac OS e precisará ingressar no Programa de desenvolvedor iOS. Algumas empresas possuem licenças corporativas que podem estar disponíveis para todos os desenvolvedores.
Com o XCode 8.1, antes de usar as Notificações por push, você deve ir para a guia Recursos do projeto e ativar as Notificações por push.
Para instalar o aplicativo em um telefone Android usando a CLI (consulte abaixo: Etapa 6 - Crie e implante o aplicativo), primeiro coloque o telefone em "modo desenvolvedor". Consulte Ativando as opções de desenvolvedor no dispositivo para obter detalhes sobre como fazer isso.
Antes de criar e implantar em seu dispositivo móvel configurado, é necessário definir as configurações de notificação para o serviço de mensagens que você decidiu usar.
Observação: consulte também nossas instruções aqui sobre como criar aplicativos PhoneGap.
Há duas maneiras de criar e implantar seu aplicativo usando o PhoneGap.
Observação: para testes de notificação por push, os emuladores não serão suficientes porque as notificações por push usam um protocolo diferente entre o provedor de push (Apple ou Google) e o dispositivo. O hardware e os emuladores atuais do Mac/PC não suportam isso.
O PhoneGap Builder é um serviço oferecido pelo PhoneGap que criará seu aplicativo para você em seus servidores e permitirá que você baixe-o diretamente no seu dispositivo. Consulte a documentação do PhoneGap Build para saber como configurar e usar o PhoneGap Build.
A CLI (Command Line Interface ) do PhoneGap permite que você use um conjunto avançado de comandos PhoneGap na linha de comando para criar, depurar e implantar seu aplicativo. Consulte a documentação do desenvolvedor do PhoneGap para saber como configurar e usar a CLI do PhoneGap.
Para criar uma nova notificação e enviá-la, siga estas etapas.
Criar uma nova notificação
Enviar a notificação
Tratamento dos resultados
Se o serviço de notificação por push (Amazon SNS ou Pushwoosh) receber a solicitação Enviar, confirmá-la como válida e enviá-la aos provedores nativos (APNS e GCM) com êxito, a caixa de diálogo Enviar será fechada sem nenhuma mensagem. Na lista de notificação, o status dessa notificação será listado como Enviado.
Se o envio por push falhar, a caixa de diálogo mostrará uma mensagem indicando o problema. Na lista de notificação, o status dessa notificação será listado como Erro, mas se o problema for corrigido, a notificação poderá ser enviada novamente. No evento de um erro, informações adicionais de erro devem aparecer no log de erros do servidor.
Observe que há algumas diferenças de plataforma entre as notificações por push do iOS e do Android. Entre eles:
Para notificações por push do AMS, as notificações devem ser compostas e enviadas pelo servidor AMS. O AMS fornece recursos adicionais de notificação por push além daqueles fornecidos por notificações AEM com AWS e Pushwoosh.
As notificações por push não garantem o delivery; eles são mais como anúncios. É feito um melhor esforço para assegurar que todos ouçam, mas não se trata de um mecanismo de delivery garantido. Além disso, o tempo para enviar um push pode variar de menos de um segundo a até meia hora.
O que é Deep Linking? No contexto de uma notificação por push, é um meio de permitir que um aplicativo seja aberto ou direcionado (se aberto) para um local especificado dentro do aplicativo.
Como funciona? O autor de uma notificação por push adiciona opcionalmente um rótulo de botão (isto é, "Mostre-me!") à notificação e escolhe a página que deseja vincular na notificação, por meio de um navegador de caminho visual. Quando enviado, o push ocorre normalmente, exceto que na mensagem no aplicativo, o botão OK é substituído por um botão "Dismiss" e o novo botão especificado ("Show me!") também é exibido. Clicar no novo botão fará com que o aplicativo vá para a página especificada dentro do aplicativo. Clicar em Dismiss o apenas ignorará a mensagem.
Se o aplicativo não estiver aberto, a sombra aparecerá normalmente. Tomar uma ação na notificação à sombra abrirá o aplicativo e apresentará ao usuário os botões de deep link com base no que foi configurado na notificação por push.
Crie a notificação, adicione um texto de botão e um caminho de link para o deep link opcional:
.Para acessar o bloco Notificação por push no seu painel, siga as etapas abaixo.
Clique na edição no canto superior direito do bloco Gerenciar Cloud Services.
Selecione Ligação Pushwoosh. Clique em Avançar.
Insira os detalhes das propriedades e clique em Enviar.
Quando você enviar sua configuração, o bloco Notificações por push será exibido no painel.
Quando o bloco Notificações por push for exibido no seu painel, use o assistente de criação de notificação para adicionar o conteúdo:
Clique no símbolo de adição no canto superior direito do bloco Notificações por push para abrir o Assistente de criação de notificação.
Clicar no ícone Procurar no caminho do link apresenta ao usuário a estrutura de conteúdo do aplicativo.
Depois de selecionar o caminho, clique no ícone de seleção.
O Texto do botão Link é limitado a 20 caracteres.
Se o usuário final não tiver a versão mais recente do aplicativo e o caminho vinculado não estiver disponível, confirmar a ação do deep link levará o usuário para a página principal do aplicativo.
Digite Detalhes do Texto no Assistente para Criar Notificação e clique em Criar.
Abra os detalhes clicando na notificação por push que você criou no bloco Notificações por push.
É possível editar propriedades, enviar notificações ou excluir a notificação.
Informações adicionais:
O Pushwoosh e o Amazon SNS não serão suportados após a versão 6.4 e estarão disponíveis como um complemento do compartilhamento de pacote.
Depois de compreender os detalhes das notificações por push do aplicativo, consulte AEM Mobile Content Personalization.