A Adobe recomenda usar o Editor de SPA para projetos que exigem renderização do lado do cliente com base em estrutura de aplicativo de página única (por exemplo, React). 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 de 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 push do AEM Mobile para o aplicativo instalado no telefone. Além disso, esta seção descreve como configurar a variável Deep Linking recurso para suas notificações por push.
A entrega das notificações por push não é garantida; são mais como anúncios. É feito um melhor esforço para garantir que todos os recebam, mas não sejam um mecanismo de entrega garantido. Além disso, o tempo para enviar uma notificação por 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 notificações e 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 de push para o SO móvel em questão deve passar pelo serviço apropriado — Apple Push Notification Service (ou APNS) para dispositivos iOS; e Google Cloud Messaging (ou GCM) para dispositivos Android. Embora o AEM não se comunique diretamente com esses serviços específicos da plataforma, algumas informações de configuração relacionadas devem ser fornecidas pelo 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 de AEM irá:
Enquanto um Administrador AEM irá:
Vá para a página do Apple here para se familiarizar com o serviço de notificação por push da Apple.
Para usar o APNS, você precisará de um Certificado arquivo (um arquivo .cer), um push Chave de privacidade (um arquivo .p12) e um Senha da chave privada do Apple. Instruções sobre como fazer isso podem ser encontradas here.
A Google está substituindo o GCM por um serviço semelhante chamado Firebase Cloud Messaging (FCM). Para obter mais informações sobre o FCM, clique em here.
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á do Chave da API para enviar notificações por push para dispositivos Android. Além disso, registre seu Número do projeto, que por vezes também é chamada de Id do Remetente GCM.
As etapas a seguir mostram um método diferente de criação de chaves de API do GCM:
com.adobe.cq.mobile.weretail.outdoorsapp
. (Se isso não funcionar, tente novamente com "test.test".)Registre a chave da API do servidor. 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:
Amazon SNS e Pushwoosh As configurações permitirão enviar empacotado de dentro AEM telas.
Adobe Mobile Services A configuração do permite configurar e enviar notificações por push do Adobe Mobile Services usando uma conta do Adobe Analytics (mas o aplicativo precisa ser criado com esse conjunto de configurações para ativar as notificações por push do AMS).
É possível encontrar informações sobre o Amazon SNS e um link para criar uma nova conta do AWS here. 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 de "sandbox da AWS", as etapas são muito semelhantes e descritas abaixo:
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 do 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 que você vai suportar. Para enviar para o iOS e Android, dois aplicativos da 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:Subscribe" ], "Efeito": "Permitir", "Recurso": [ "*" ] } ] }
|
Se não quiser usar o Pushwoosh, ignore esta etapa.
Para utilizar Pushwoosh:
Inscreva-se no Pushwoosh
Criar um token de acesso à API
Criar um novo aplicativo
Se um segundo aplicativo for configurado no AEM com a mesma ID de aplicativo (e outros valores relacionados): Token de acesso à API e ID do GCM), todas as notificações por push enviadas por meio do 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 um em app-config-dev) chamados de notificationsConfig:
<your app>
/shell/jcr:content/page-app/app-config-dev/notificationsConfig<your app>
/shell/jcr:content/page-app/app-config/notificationsConfigCom essas propriedades (arquivos .content.xml) :
<jcr:root xmlns:jcr=" <span id=" translate="no" />https://www.jcp.org/jcr/1.0" xmlns:nt=" https://www.jcp.org/jcr/nt/1.0" jcr:primaryType="nt:unstructured" excludeProperties="[appAPIAccessToken]" path="…/…/…/…"
🔗
targetRootDirectory="www" type="notificationsconfig"/>
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 page-notifications-config.json.
As bibliotecas de clientes 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 consideraçõ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, já que os emuladores não podem receber notificações por push.
Para o iOS, você precisará usar um computador Mac OS e será necessário associar-se à Programa para desenvolvedores do iOS. Algumas empresas têm licenças corporativas que podem estar disponíveis para todos os desenvolvedores.
Com o XCode 8.1, antes de usar notificações por push, você deve ir para a guia Recursos no seu projeto e ativar as notificações por push.
Para instalar o aplicativo em um telefone Android usando a CLI (veja abaixo: Etapa 6 - Criar e implantar o aplicativo), primeiro você deve colocar o telefone no "modo desenvolvedor". Consulte Ativação das opções do desenvolvedor no dispositivo para obter detalhes sobre como fazer isso.
Antes de criar e implantar no dispositivo móvel configurado, é necessário definir as configurações de notificação do serviço de mensagens que você decidiu usar.
Observação: Consulte também as nossas instruções here 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 distinto entre o provedor por push (Apple ou Google) e o dispositivo. O hardware e emuladores atuais de Mac/PC não suportam isso.
PhoneGap Build O é um serviço oferecido pelo PhoneGap que criará seu aplicativo para você em seus servidores e permitirá que você o baixe diretamente no dispositivo. Consulte a Documentação do PhoneGap Build para saber como configurar e usar o PhoneGap Build.
Interface da Linha de Comando PhoneGap (CLI) permite usar um conjunto avançado de comandos do 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
Lidar com os resultados
Se o serviço de notificação por push (Amazon SNS ou Pushwoosh) receber a solicitação Send , confirmá-la como válida e enviá-la aos provedores nativos (APNS e GCM) com êxito, a caixa de diálogo Send será fechada sem mensagem. Na lista de notificações, 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ções, o status dessa notificação será listado como Erro, mas se o problema for corrigido, a notificação poderá ser enviada novamente. No caso de um erro, informações adicionais sobre o 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 pelas notificações de AEM com o AWS e o Pushwoosh.
A entrega das notificações por push não é garantida; são mais como anúncios. É feito um melhor esforço para garantir que todos ouçam, mas não são um mecanismo de entrega garantido. Além disso, o tempo para enviar uma notificação por 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 (ou seja, "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 "Dispensar" e o novo botão é especificado ("Mostrar-me!") também é exibido. Clicar no novo botão fará com que o aplicativo vá para a página especificada no aplicativo. Clicar em Dispensar apenas ignorará a mensagem.
Se o aplicativo não estiver aberto, a sombra aparecerá normalmente. Realizar 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 painel, siga as etapas abaixo.
Clique na edição no canto superior direito do Gerenciar Cloud Services mosaico.
Selecione o Conexão Pushwoosh. Clique em Avançar.
Insira os detalhes das propriedades e clique em Enviar.
Depois de enviar sua configuração, a variável Notificações por push é exibido no painel.
Uma vez Notificações por push bloco exibido no painel, use o assistente criar notificação para adicionar o conteúdo:
Clique no símbolo de adição no canto superior direito do Notificações por push bloco para abrir o Criar Assistente de Notificação.
Clicar no ícone de navegação no caminho do link apresenta ao usuário a estrutura de conteúdo do aplicativo.
Depois de selecionar o caminho, clique no ícone de verificação.
O Texto do botão de 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 trará o usuário para a página principal do aplicativo.
Insira o Detalhes do texto no Criar Assistente de Notificação e clique em Criar.
Abra os detalhes clicando na notificação por push criada no Notificações por push mosaico.
É 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 pacotes.
Assim que entender os detalhes sobre notificações por push para seu aplicativo, consulte Personalização de conteúdo do AEM Mobile.