Show Menu
TÓPICOS×

Notificações push

A Adobe recomenda usar o Editor SPA para projetos que exigem renderização do lado do cliente baseada em estrutura de aplicativo de página única (por exemplo, Reagir). Saiba mais .
A capacidade 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 do 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.
A entrega das notificações por push não é garantida; 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 execução garantido. Além disso, o tempo de envio pode variar de menos de um segundo a até meia hora.
O uso de notificações por push com o 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 prontamente com o AEM: Serviço de notificação simples (ou SNS) da Amazon 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 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 possam executar o push.
Depois de instalado e configurado (conforme explicado abaixo), ele funciona assim:
  1. Uma notificação por push é criada no AEM e enviada ao provedor de serviços (Amazon SNS ou Pushwoosh).
  2. O provedor de serviços o recebe e o envia para o provedor principal (APNS ou GCM).
  3. O provedor principal envia a notificação para todos os dispositivos registrados para esse push. Para cada dispositivo, ele usa a rede de dados celulares ou WiFi, o que estiver disponível no momento no dispositivo.
  4. A notificação é exibida no dispositivo se o aplicativo para o qual está registrado não estiver sendo executado. Um usuário que tocar na notificação iniciará o aplicativo e exibirá a notificação dentro dele. Caso o aplicativo já esteja em execução, somente a notificação no aplicativo será exibida.
Esta versão do AEM é compatível com dispositivos móveis iOS e Android.

Visão geral e procedimento

Para usar notificações por push em um aplicativo do AEM Mobile, as seguintes etapas de alto nível devem ser realizadas.
Normalmente, um desenvolvedor do AEM:
  1. Registrar-se nos serviços de mensagens da Apple e do Google
  2. Registre-se com um serviço de mensagens de push e configure-o
  3. Adicionar suporte por push ao aplicativo
  4. Preparar um telefone para teste
Enquanto um administrador de AEM:
  1. Configurar push em aplicativos AEM
  2. Criar e implantar o aplicativo
  3. Enviar uma notificação por push
  4. Configurar deep linking (opcional)

Etapa 1: Registrar-se nos serviços de mensagens da Apple e do Google

Usando o Serviço de notificação por push da Apple (APNS)

Acesse a página da Apple aqui para se familiarizar com o Serviço de notificação por push da Apple.
Para usar o APNS, você precisará de um arquivo de certificado (um arquivo .cer), uma chave privada de push (um arquivo .p12) e uma senha de chave privada da Apple. Instruções sobre como fazer isso podem ser encontradas aqui .

Usando o serviço Google Cloud Messaging (GCM)

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 .
Acesse a página do Google aqui para se familiarizar com o Google Cloud Messaging for Android.
Você precisará seguir as etapas aqui 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 às vezes também é chamado de Id do remetente GCM.
As etapas a seguir mostram um método diferente de criação de chaves de API GCM:
  1. Entre no google e vá para a página Desenvolvedor do Google.
  2. Escolha seu aplicativo na lista (ou crie um novo).
  3. Em Nome do pacote do Android, insira a ID do aplicativo, ou seja, com.adobe.cq.mobile.weretail.outdoorsapp . (Se isso não funcionar, tente novamente com "test.test".)
  4. Clique em Continuar para escolher e configurar serviços
  5. Selecione Cloud Messaging e clique em Ativar Google Cloud Messaging .
  6. A nova Chave API do servidor e a (nova ou existente) ID do remetente serão exibidas.
Registre a Server API Key. Esse valor é inserido no site do provedor de push.

Etapa 2: Registrar e configurar um serviço de mensagens de push

O AEM está configurado para usar um dos três serviços para notificações por push:
  • Amazon SNS
  • Pushwoosh
  • Adobe Mobile Services
As configurações do Amazon SNS e Pushwoosh permitirão enviar mensagens enviadas por dentro das telas do AEM.
A configuração do Adobe Mobile Services permite que você configure e envie 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 habilitar notificações por push do AMS).

Uso do serviço de mensagens SNS da Amazon

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:
  1. Registrar-se no Amazon SNS
    1. Registre sua ID de conta. O formato deve ter doze dígitos sem espaços ou traços, ou seja, "123456789012".
    2. Certifique-se de estar na região "us-East" ou "eu", como uma etapa posterior (Criação de pool de identidade) requer uma dessas.
    3. Depois de se registrar, faça logon no console de gerenciamento e selecione SNS (Push Notification Service). Clique em "Introdução" se for exibido.
  2. Criar chave de acesso e ID
    1. Clique no nome de logon no canto superior direito da tela e escolha Credenciais de segurança no menu.
    2. Clique em Teclas de acesso e, no espaço abaixo, clique em Criar nova chave de acesso.
    3. Clique em Mostrar chave de acesso e copie e salve a ID da chave de acesso e a chave de acesso secreta mostradas. Se você escolher a opção para baixar as teclas, você obterá um arquivo csv que contém esses mesmos valores.
    4. Outros certificados relacionados à segurança, entre outros, podem ser gerenciados nesta página.
    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:
    1. Clique no nome de logon no canto superior direito da tela e escolha Minhas credenciais de segurança no menu.
    2. Clique em Usuários na lista esquerda de ações e escolha seu nome de usuário.
    3. Clique na guia Credenciais de segurança.
    4. Aqui você vê suas chaves e cria novas chaves. Salve as teclas para uso posterior.
  3. Criar um tópico
    1. Clique em Criar tópico e escolha um nome de tópico. Registre todos os campos como Topic ARN (Tópico ARN), Topic Owner (Proprietário do tópico), Region (Região) e Display name (Nome de exibição).
    2. Clique em Outras ações de tópico > Editar política de tópicos. Em Permitir que esses usuários assinem este tópico , selecione Todos.
    3. Clique em Atualizar política .
    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.
  4. Criar aplicativos da plataforma
    1. 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:
      1. Para o APNS, um arquivo P12, uma senha, um certificado e uma chave privada devem ser inseridos. Eles devem ter sido obtidos na etapa Usando o Apple Push Notification Service (APNS) acima.
      2. Para o GCM, uma chave de API deve ser inserida. Isso deve ter sido obtido na etapa Usar o serviço GCM (Google Cloud Messaging) acima.
    2. 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.
  5. Criar um pool de identidade
    1. Use o Cognito para criar um Pool de identidade, que armazenará dados básicos de usuários não autenticados. Note-se que, neste momento, apenas as regiões "us-East" e "eu" são apoiadas pelo Amazon Cognito.
    2. Dê um nome a ele e marque a caixa "Ativar acesso a identidades não autenticadas".
    3. Na próxima página (" Suas identidades Cognito requerem acesso aos seus recursos "), clique em Permitir.
    4. Na parte superior direita da página, clique no link " Editar pool de identidade" . A ID do pool de identidade é exibida. Salve este texto para mais tarde.
    5. Na mesma página, escolha a lista suspensa ao lado de "Função não autenticada" e verifique se ela tem a função Cognito_<nome do pool>UnauthRole selecionada. Salve as alterações.
  6. Configurar acesso
    1. Logon no Gerenciamento de identidade e acesso (IAM)
    2. Selecionar funções
    3. Clique na função criada na etapa anterior, chamada Cognito_<yourIdentityPoolName>Unauth_Role. Registre a mensagem "Role ARN" exibida.
    4. Abra "Políticas embutidas" se ainda não estiver aberto. Você deve ver uma política com um nome como oneClick_Cognito_<yourIdentityPoolName>Unauth_Role_1234567890123.
    5. Clique em "Editar política". Substitua o conteúdo do Documento de política por este snippet do JSON:
    {
    "Versão": "2012-10-17",
    "Declaração": [
    {
    "Ação": [
    "mobileanalytics:PutEvents",
    "cognito-sync:*",
    "SNS:CreatePlatformEndpoint",
    "SNS:Assinar"
    ],
    "Efeito": "Permitir",
    "Recurso": [
    "*"
    ]
    }
    ]
    }
    1. Clique em Aplicar política

Usando o serviço de mensagens Pushwoosh

Se não quiser usar o Pushwoosh, ignore esta etapa.
Para utilizar Pushwoosh:
  1. Registrar-se em Pushwoosh
    1. Vá para pushwoosh.com e crie uma nova conta.
  2. Criar um token de acesso de API
    1. No site Pushwoosh, vá para o item de menu Acesso à API para gerar um token de acesso à API. Você precisará gravar isso com segurança.
  3. Criar um novo aplicativo
    1. Para suporte ao Android, é necessário fornecer sua chave de API do GCM.
    2. Ao configurar o aplicativo, escolha Cordova como a estrutura.
    3. Para suporte ao iOS, é necessário fornecer o arquivo de Certificado (.cer), o Certificado de push (.p12) e a senha da chave privada; eles devem ter sido obtidos no site APNS da Apple. Para Framework, escolha Cordova.
    4. O Pushwoosh gerará uma ID de aplicativo para esse aplicativo, no formato "XXXXX-XXXXX", onde cada X é um valor hexadecimal (0 a F).
Se um segundo aplicativo estiver configurado no AEM com a mesma ID do 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 de aplicativo.

Etapa 3: Adicionar suporte por push ao aplicativo

Adicionar configuração do ContentSync

Crie dois nós de conteúdo (um em app-config e outro em app-config-dev) chamados notificationsConfig:
  • /content/ <your app> /shell/jcr:content/pge-app/app-config-dev/notificationsConfig
  • /content/ <your app> /shell/jcr:content/pge-app/app-config/notificationsConfig
Com 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=" #"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.

Adicionar bibliotecas de clientes

As bibliotecas de cliente de notificação por push devem ser adicionadas ao aplicativo seguindo estas etapas:
No CRXDE Lite:
  1. Navegue até /etc/designs/phonegap/<nome do aplicativo>/clientlibsall.
  2. Clique duas vezes na seção incorporada no painel de propriedades.
  3. Na caixa de diálogo exibida, adicione uma nova biblioteca de cliente clicando no botão +.
  4. No novo campo de texto, adicione "cq.mobile.push" e clique em OK.
  5. Adicione mais um chamado cq.mobile.push.amazon e clique em OK.
  6. Salve as alterações.
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.

Etapa 4: Preparar um telefone para teste

Para notificações por push, é necessário testar em um dispositivo real, pois os emuladores não podem receber notificações por push.

IOS

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.

Android

Para instalar o aplicativo em um telefone Android usando a CLI (consulte abaixo: Etapa 6 - Crie e implante o aplicativo ). Primeiro, você deve colocar o telefone no "modo desenvolvedor". Consulte Ativação das opções de desenvolvedor no dispositivo para obter detalhes sobre como fazer isso.

Etapa 5: Configurar push em aplicativos AEM

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.
  1. Crie os grupos de autorização apropriados para notificações por push.
  2. Faça logon no AEM como o usuário apropriado e clique na guia Aplicativos.
  3. Clique no aplicativo.
  4. Localize o bloco Gerenciar serviços em nuvem e clique no lápis para modificar as configurações da nuvem.
  5. Selecione Amazon SNS Connection, Pushwoosh Connection ou Adobe Mobile Services como a configuração de notificação.
  6. Insira as propriedades do provedor e clique em Enviar para salvá-las e em Concluído. Não são verificados remotamente nesta fase, exceto no caso do AMS.
  7. Agora você deve ver a configuração que acabou de inserir no bloco Gerenciar serviços da nuvem.

Etapa 6: Criar e implantar o aplicativo

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 distinto entre o provedor de push (Apple ou Google) e o dispositivo. O hardware e os emuladores atuais do Mac/PC não suportam isso.
  1. O PhoneGap Build é um serviço oferecido pelo PhoneGap que criará seu aplicativo para você em seus servidores e permitirá que você baixe-o diretamente em seu dispositivo. Consulte a documentação do PhoneGap Build para saber como configurar e usar o PhoneGap Build.
  2. 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.

Etapa 7: Enviar uma notificação por push

Para criar uma nova notificação e enviá-la, siga estas etapas.
  1. Criar uma nova notificação
    • No painel do aplicativo do AEM Mobile, localize o bloco Notificações por push.
    • No menu no canto superior direito, escolha "Criar". Observe que esse botão não estará disponível até que a configuração da nuvem seja definida pela primeira vez.
    • No Assistente para criação de notificações, insira um título e uma mensagem e clique no botão "Criar". Sua notificação agora está pronta para ser enviada imediatamente ou posteriormente. Pode ser editado e a mensagem e/ou o título podem ser alterados e salvos.
  2. Enviar a notificação
    • No painel Aplicativos, localize o bloco Notificações por push.
    • Selecione a notificação ou clique no botão de detalhes na parte inferior direita (. . .), para mostrar a lista de notificações. Essa lista também indica se uma notificação está pronta para ser enviada, já foi enviada ou se ocorreu um erro durante o envio.
    • Marque a caixa de seleção de uma notificação (somente) e clique no botão "Enviar notificação" acima da lista. Você terá uma chance de "Cancelar" ou "Enviar" a notificação na caixa de diálogo exibida.
  3. Tratamento dos resultados
    • Se o serviço de notificação por push (Amazon SNS ou Pushwoosh) receber a solicitação de envio, a confirmar como válida e a enviar aos provedores nativos (APNS e GCM) com êxito, a caixa de diálogo Enviar será fechada sem nenhuma 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. Em caso de 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:
      • Construir com a CLI iniciará o aplicativo depois que ele for implantado no Android. No iOS, é necessário iniciá-lo manualmente. Como a etapa de registro por push acontece na inicialização, os aplicativos Android podem receber notificações por push imediatamente (já que ela será iniciada e registrada) enquanto os aplicativos iOS não receberão.
      • No Android, o texto do botão OK está em todas as letras maiúsculas (e em qualquer outro botão adicionado na notificação no aplicativo), enquanto no iOS não está.
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 do AEM com AWS e Pushwoosh.
A entrega das notificações por push não é garantida; 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 execução garantido. Além disso, o tempo de envio pode variar de menos de um segundo a até meia hora.

Configuração de deep links com notificações por push

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 painel, siga as etapas abaixo.
  1. Clique na edição no canto superior direito do bloco Gerenciar serviços em nuvem.
  2. Selecione a Conexão Pushwoosh . Clique em Avançar .
  3. 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.

Criar assistente de notificação

Depois que o bloco Notificações por push for exibido no painel, use o assistente de criação de notificação para adicionar o conteúdo:
  1. Clique no símbolo add (adicionar) no canto superior direito do bloco Push Notifications (Notificações por push) para abrir o Create Notification Wizard (Assistente de criação de notificação).
  2. 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.
  3. Digite os detalhes do texto no Assistente para criação de notificações 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.

Próximas etapas

Depois de compreender os detalhes das notificações por push do aplicativo, consulte Personalização de conteúdo do AEM Mobile.