A Adobe recomenda o uso do Editor SPA para projetos que exigem renderização no lado do cliente baseada em estrutura de aplicativo de página única (por exemplo, React). Saiba mais.
Ser capaz de alertar instantaneamente seus usuários de aplicativo móvel Adobe Experience Manager (AEM) com notificações importantes é fundamental para o valor de um aplicativo móvel e suas campanhas de marketing. Aqui, as etapas são descritas para permitir que seu aplicativo receba notificações por push. Você também aprenderá a configurar e enviar mensagens de push do AEM Mobile para o aplicativo instalado no telefone. Além disso, esta seção descreve como configurar o Deep Linking recurso para suas notificações por push.
A entrega das notificações por push não é garantida; elas se assemelham mais a anúncios. É feito o melhor esforço para garantir que todos os usuários os recebam, mas eles não sejam um mecanismo de entrega 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ços de notificação por push deve ser usado para gerenciar notificações e dispositivos (o AEM ainda não faz isso). Dois provedores são configurados prontos para uso com AEM: Serviço de notificação simples do Amazon (ou SNS) e Pushwoosh. Em segundo lugar, a tecnologia de push para determinado SO móvel 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 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 junto com as notificações para que esses serviços executem o push.
Depois de instalado e configurado (conforme explicado abaixo), ele funciona assim:
Essa 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 executadas.
Normalmente, um desenvolvedor de Experience Manager faz o seguinte:
Enquanto um Administrador de Experience Manager faz o seguinte:
Vá para a página do Apple aqui para se familiarizar com o Serviço de notificações por push da Apple.
Para usar APNs, você precisa de um Certificado arquivo (um arquivo .cer), uma notificação por push Chave privada (um arquivo .p12) e uma Senha da chave de privacidade do 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 em aqui.
Vá para a página do Google aqui para se familiarizar com o Google Cloud Messaging para Android™.
Siga estas etapas para Criar um projeto da API do Google, Ativar o serviço GCM, e Obter uma chave de API. Você precisa do Chave de API para enviar notificações por push a dispositivos Android™. Além disso, registre seu Número do Projeto, que às vezes também é chamado de ID do remetente do 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. Este valor é inserido no site do seu provedor de push.
O AEM está configurado para usar um dos três serviços para notificações por push:
AMAZON SNS e Pushwoosh As configurações do permitem enviar telas enviadas por AEM.
Adobe Mobile Services a configuração do permite configurar e enviar notificações por push de dentro do Adobe Mobile Services usando uma conta da Adobe Analytics (mas o aplicativo deve 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 conta do 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 e ID de acesso
Uma Chave de Acesso pode ser usada para vários aplicativos.
Para organizações que usam uma conta "AWS Sandbox", as etapas são semelhantes e descritas aqui:
Criar um tópico
Você pode criar vários tópicos para diferentes cenários, como desenvolvimento, teste e demonstração. 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 de Plataforma. Escolha um nome e selecione uma plataforma (APNS para iOS, GCM para Android™). Dependendo da plataforma. outros campos devem ser preenchidos:
Repita a etapa acima uma vez para cada plataforma que você estiver suportando. Para enviar para iOS e Android™, dois aplicativos de plataforma devem ser criados.
Criar um pool de identidade
Configurar acesso
{ "Version": "10-17-2012", "Declaração": [ { "Ação": [ "mobileanalytics:PutEvents", "cognito-sync:*", "SNS:CreatePlatformEndpoint", "SNS:Assinar" ], "Effect": "Allow", "Recurso": [ "*" ] } ] }
|
Se você não quiser usar o Pushwoosh, ignore esta etapa.
Para usar Pushwoosh:
Registrar-se no Pushwoosh
Criar um token de acesso da API
Criar um aplicativo
Se um segundo aplicativo estiver configurado no 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 por meio do segundo aplicativo no AEM irão para qualquer outro aplicativo com essa ID do aplicativo.
Crie dois nós de conteúdo (um no app-config e um no app-config-dev) chamados notificationsConfig:
<your app>
/shell/jcr:content/page-app/app-config-dev/notificationsConfig<your app>
/shell/jcr:content/page-app/app-config/notificationsConfigCom estas propriedades (arquivos .content.xml) :
<jcr:root xmlns:jcr=" <span id=" translate="no" />https://developer.adobe.com/experience-manager/reference-materials/spec/jcr/1.0/index.html" xmlns:nt=" https://developer.adobe.com/experience-manager/reference-materials/spec/jcr/1.0/index.html" 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 gravará o arquivo pge-notifications-config.json.
As bibliotecas de clientes de notificação por push devem ser adicionadas ao aplicativo seguindo estas etapas:
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, você deve testar em um dispositivo real, pois os emuladores não podem receber notificações por push.
Para o iOS, use um computador macOS e participe da Programa para Desenvolvedores iOS. Algumas corporações 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 em seu projeto e ativar ou desativar 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), você primeiro deve colocar o telefone em "modo de desenvolvedor". Consulte Ativação das opções do desenvolvedor no dispositivo para obter detalhes sobre como fazer isso.
Antes de criar e implantar em seu dispositivo móvel configurado, você deve definir as configurações de notificação para o serviço de mensagens que decidiu usar.
Nota: Veja as instruções aqui na criação de aplicativos PhoneGap.
Há duas maneiras de criar e implantar seu aplicativo usando o PhoneGap.
Nota: Para testes de notificação por push, os emuladores não serão suficientes, pois as notificações por push usam um protocolo distinto entre o provedor de push (Apple ou Google) e o dispositivo. Os emuladores e o hardware atuais do Mac/PC não suportam esse recurso.
PhoneGap Build O é um serviço oferecido pelo PhoneGap que criará seu aplicativo nos servidores deles e permitirá que você o baixe diretamente para seu dispositivo. Consulte a documentação de PhoneGap Build em https://build.phonegap.com/
para saber como configurar e usar o PhoneGap Build.
Interface de linha de comando do PhoneGap O (CLI) permite que você use 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 (https://docs.phonegap.com/en/edge/guide_cli_index.md.html#The%20Command-Line%20Interface
) para saber como configurar e usar a CLI do PhoneGap.
Para criar uma notificação e enviá-la, siga estas etapas.
Criar uma 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 de envio, confirmá-la como válida e enviá-la aos provedores nativos (APNS e GCM) com êxito, a caixa de diálogo de envio será fechada sem nenhuma mensagem. Na lista de notificações, o status dessa notificação é 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 é listado como Erro, mas se o problema for retificado, a notificação poderá ser enviada novamente. Se houver um erro, informações adicionais sobre o erro deverão 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 do servidor AMS. O AMS fornece recursos adicionais de notificação por push além daqueles fornecidos por notificações AEM com AWS e Pushwoosh.
A entrega das notificações por push não é garantida; elas se assemelham mais a anúncios. É feito o melhor esforço para garantir que todos ouçam, mas eles não sejam um mecanismo de entrega 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 estiver 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 gostaria de 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 é exibida. Clicar no botão new faz com que o aplicativo vá para a página especificada no aplicativo. Clicar em Dispensar elimina a mensagem.
Se o aplicativo não estiver aberto, a sombra será exibida normalmente. Realizar uma ação na notificação na sombra abre o aplicativo e, em seguida, apresenta 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ções por push no painel, siga as etapas abaixo.
Clique na edição no canto superior direito da Gerenciar Cloud Service bloco.
Selecione o Conexão Pushwoosh. Clique em Avançar.
Insira os detalhes das propriedades e clique em Enviar.
Depois de enviar sua configuração, o Notificações por push o bloco é exibido no painel.
Quando a variável Notificações por push for exibido no 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 da 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 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.
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 na Notificações por push bloco.
Você pode editar propriedades, enviar notificações ou excluir a notificação.
Informações adicionais:
O Pushwoosh e o Amazon SNS não serão compatíveis após a versão 6.4 e estarão disponíveis como um complemento do Compartilhamento de pacotes.
Assim que você entender os detalhes sobre notificações por push para seu aplicativo, consulte Personalização de conteúdo do AEM Mobile.