Criar e enviar notificações por push

No portal do desenvolvedor do Apple, navegue até Chaves.

Para criar uma chave, selecione +.

Forneça um Nome da Chave.

Marque a caixa de seleção Serviço de notificação por push do Apple (APNs).

Selecione Continuar.

Revise a configuração e selecione Registrar.

Baixe a chave privada .p8. Ela é usada na configuração da Superfície do aplicativo posteriormente nesta lição.

Anote a Key ID. É usado na configuração da Superfície do aplicativo.

Anote a ID da Equipe. É usado na configuração da Superfície do aplicativo.

Na interface da Coleção de Dados, selecione Superfícies do Aplicativo no painel esquerdo.

Para criar uma configuração, selecione Criar Superfície do Aplicativo.

Insira um Nome para a configuração, por exemplo Luma App Tutorial.

Em Configuração do Aplicativo Móvel, selecione Apple iOS.

Insira a ID do pacote do aplicativo móvel no campo ID do aplicativo (ID do pacote iOS). Por exemplo, com.adobe.luma.tutorial.swiftui.

Ative a opção Push Credentials para adicionar suas credenciais.

Arraste e solte seu arquivo .p8 Chave de Autenticação de Notificação por Push do Apple.

Forneça a Key ID, uma cadeia de 10 caracteres atribuída durante a criação da chave de autenticação p8. Ele pode ser encontrado na guia Chaves da página Certificados, Identificadores e Perfis das páginas do portal do Desenvolvedor do Apple. Consulte também Criar uma chave privada.

Forneça a ID da Equipe. A ID da equipe é um valor que pode ser encontrado na guia Associação ou na parte superior da página do portal Desenvolvedor do Apple. Consulte também Criar uma chave privada.

Selecione Salvar.

Na interface da Coleção de dados, selecione Datastreams e selecione sua sequência de dados, por exemplo Luma Mobile App.

Selecione para Experience Platform e selecione Editar no menu de contexto.

Na tela Datastreams > > Adobe Experience Platform:

1. Se ainda não estiver selecionado, selecione Conjunto de Dados de Perfis por Push da AJO em Conjunto de Dados de Perfil. Este conjunto de dados de perfil é necessário ao usar a chamada de API MobileCore.setPushIdentifier (consulte Registrar token de dispositivo para notificações por push), que garante que o identificador exclusivo para notificações por push (também conhecido como identificador por push) seja armazenado como parte do perfil do usuário.

2. Adobe Journey Optimizer está selecionado. Consulte configurações do Adobe Experience Platform para obter mais informações.

3. Para salvar a configuração da sequência de dados, selecione Salvar.

Navegue até Marcas > Extensões > Catálogo,

Abra a propriedade, por exemplo Luma Mobile App Tutorial.

Selecione Catálogo.

Pesquise a extensão Adobe Journey Optimizer.

Instale a extensão.

Na caixa de diálogo Instalar Extensão

1. Selecione um ambiente, por exemplo Desenvolvimento.

2. Selecione o conjunto de dados Conjunto de dados do evento de experiência de rastreamento de push do AJO na lista Conjunto de dados do evento.

3. Selecione Salvar na Biblioteca e na Build.

   

Revise a seção instruções de configuração para conectar seu simulador ou dispositivo ao Assurance.

Na interface do Assurance, selecione Configurar.

Selecione ao lado de Depuração de push.

Selecione Salvar.

Selecione Depuração de push na navegação à esquerda.

Selecione a guia Validar Instalação.

Selecione seu dispositivo na lista Cliente.

Confirme se não está recebendo erros.

Selecione a guia Enviar teste por push.

(opcional) Alterar os detalhes padrão para Título e Corpo

Selecione Enviar Notificação Por Push De Teste.

Verifique os Resultados de Teste.

Você deve ver a notificação por push de teste aparecer no aplicativo.

{width="300"}

Acesse seu aplicativo no Xcode.

Selecione Luma no Navegador de projetos.

Selecione o destino Luma.

Selecione a guia Assinatura e Recursos.

Configure o Gerenciamento automático de assinatura, a Equipe e o Identificador do Pacote ou use seus detalhes específicos de provisionamento de desenvolvimento do Apple.

{modal="regular"}

No Xcode, selecione Luma na lista TARGETS, selecione a guia Assinatura e Recursos, selecione o botão + Recurso e selecione Notificações por push. Isso permite que seu aplicativo receba notificações por push.

Em seguida, adicione uma Extensão de notificação ao aplicativo. Volte para a guia General e selecione o ícone + na parte inferior da seção TARGETS.

Será solicitado que você selecione o modelo para seu novo alvo. Selecione Extensão de Serviço de Notificação e Avançar.

Na próxima janela, use NotificationExtension como o nome da extensão e clique no botão Concluir.

No Xcode, verifique se Mensagens AEP foram adicionadas à lista de pacotes nas dependências de pacote. Consulte Gerenciador de pacotes do Swift.

Navegue até Luma > Luma > AppDelegate no navegador de projetos Xcode.

Certifique-se de que AEPMessaging faça parte da sua lista de importações.

import AEPMessaging

Verifique se Messaging.self faz parte da matriz de extensões que você está registrando.

let extensions = [
    AEPIdentity.Identity.self,
    Lifecycle.self,
    Signal.self,
    Edge.self,
    AEPEdgeIdentity.Identity.self,
    Consent.self,
    UserProfile.self,
    Places.self,
    Messaging.self,
    Optimize.self,
    Assurance.self
]

Adicione a API MobileCore.setPushIdentifier à função func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data).

// Send push token to Mobile SDK
MobileCore.setPushIdentifier(deviceToken)

Essa função recupera o token do dispositivo exclusivo para o dispositivo no qual o aplicativo está instalado. Em seguida, define o token para delivery de notificação por push usando a configuração definida e que depende do Serviço de notificação por push (APNs) da Apple.

Na interface do usuário do Journey Optimizer, selecione Esquemas no painel esquerdo.

Selecione Procurar na barra de guias.

Selecione seu esquema, por exemplo Luma Mobile App Event Schema para abri-lo.

No Editor de esquemas:

1. Selecione o campo eventType.

2. No painel Propriedades do campo, role para baixo para ver a lista de valores possíveis para o tipo de evento. Selecione Adicionar linha e adicione application.test como VALUE e Test event for push notification como DISPLAY NAME.

3. Selecione Aplicar.

4. Selecione Salvar.

   

Na interface do usuário do Journey Optimizer, selecione Configurações no painel esquerdo.

Na tela Painel, selecione o botão Gerenciar no bloco Eventos.

Na tela Eventos, selecione Criar Evento.

No painel Editar evento1:

1. Digite LumaTestEvent como Nome do evento.

2. Forneça uma Descrição, por exemplo Test event to trigger push notifications in Luma app.

3. Selecione o esquema de evento de experiência de aplicativo móvel criado anteriormente em Criar um esquema XDM da lista Esquema, por exemplo Luma Mobile App Event Schema v.1.

4. Selecione ao lado da lista Campos.

   

   Na caixa de diálogo Campos, verifique se os campos a seguir estão selecionados (na parte superior dos campos padrão que estão sempre selecionados (_id, id e carimbo de data/hora)). Você pode alternar, usando a lista suspensa, entre Selecionado, Todos e Primário ou usar o campo .

   • Aplicativo Identificado (id),
   • Tipo de Evento (eventType),
   • Principal (principal).

   

   Em seguida, selecione Ok.

5. Selecione ao lado do campo Condição de ID de evento.

   1. Na caixa de diálogo Adicionar uma condição de ID de evento, arraste e solte o Tipo de Evento (eventType) em Arraste e solte um elemento aqui.

   2. No popover, role até a parte inferior e selecione application.test (que é o tipo de evento adicionado anteriormente à lista de tipos de evento como parte de Atualizar seu esquema). Em seguida, role para cima e selecione Ok.

   3. Selecione Ok para salvar a condição.

      

6. Selecione ECID (ECID) na lista Namespace. Automaticamente, o campo Identificador de perfil é preenchido com A ID do primeiro elemento da chave ECID para o mapa identityMap.

7. Selecione Salvar.

   

Na interface do usuário do Journey Optimizer, selecione Jornadas no painel esquerdo.

Selecione Criar Jornada.

No painel Propriedades da Jornada:

1. Digite um Nome para a jornada, por exemplo Luma - Test Push Notification Journey.

2. Insira uma Descrição para a jornada, por exemplo Journey for test push notifications in Luma mobile app.

3. Verifique se Permitir reentrada está selecionado e defina Período de espera de reentrada como 30 Segundos.

4. Selecione Ok.

   

De volta à tela de jornada, a partir de EVENTS, arraste e solte seu LumaTestEvent na tela, onde ele mostra Selecione um evento de entrada ou uma atividade de leitura de público.

• No painel Events: LumaTestEvent, digite um Label, por exemplo Luma Test Event.

Na lista suspensa AÇÕES, arraste e solte Push em que aparece à direita da atividade LumaTestEvent. No painel Ações: push:

1. Forneça um Rótulo, por exemplo Luma Test Push Notification, forneça uma Descrição, por exemplo Test push notification for Luma mobile app, selecione Transacional da lista Categoria e selecione Luma da Superfície de push.

2. Selecione Editar conteúdo para começar a editar a notificação por push real.

   

   No editor de Notificação por push:

   1. Insira um Título, por exemplo Luma Test Push Notification, e insira um Corpo, por exemplo Test push notification for Luma mobile app.

   2. Opcionalmente, você pode inserir um link para uma imagem (.png ou .jpg) em Adicionar mídia. Se você fizer isso, a imagem fará parte da notificação por push.

   3. Para salvar e sair do editor, selecione .

      

3. Para salvar e concluir a definição de notificação por push, selecione Ok.

Sua jornada deve ser parecida com a exibida abaixo. Selecione Publish para publicar e ativar sua jornada.

Navegue até Luma > Luma > Modelo > XDM > TestPushPayload no navegador do Projeto Xcode e inspecione o código.

import Foundation

// MARK: - TestPush
struct TestPushPayload: Codable {
   let application: Application
   let eventType: String
}

// MARK: - Application
struct Application: Codable {
   let id: String
}

O código é uma representação da seguinte carga simples que você enviará para acionar a jornada de notificação por push de teste

{
   "eventType": string,
   "application" : [
       "id": string
   ]
}

Navegue até Luma > Luma > Utils > MobileSDK no navegador do Projeto Xcode e adicione o seguinte código a func sendTestPushEvent(applicationId: String, eventType: String):

// Create payload and send experience event
Task {
    let testPushPayload = TestPushPayload(
        application: Application(
            id: applicationId
        ),
        eventType: eventType
    )
    // send the final experience event
    await sendExperienceEvent(
        xdm: testPushPayload.asDictionary() ?? [:]
    )
}

Este código cria uma instância testPushPayload usando os parâmetros fornecidos para a função (applicationId e eventType) e, em seguida, chama sendExperienceEvent ao converter a carga em um dicionário. Esse código, desta vez, também leva em conta os aspectos assíncronos de chamar o SDK do Adobe Experience Platform usando o modelo de simultaneidade do Swift com base em await e async.

Navegue até Luma > Luma > Views > General > ConfigView no navegador de projetos Xcode. Na definição do Botão de notificação por push, adicione o seguinte código para enviar a carga do evento de experiência de notificação por push de teste para acionar a jornada sempre que esse botão for tocado.

// Setting parameters and calling function to send push notification
Task {
    let eventType = testPushEventType
    let applicationId = Bundle.main.bundleIdentifier ?? "No bundle id found"
    await MobileSDK.shared.sendTestPushEvent(applicationId: applicationId, eventType: eventType)
}

Recrie e execute o aplicativo no simulador ou em um dispositivo físico do Xcode, usando .

Vá para a guia Configurações.

Toque em Notificação por push. Você vê a notificação por push aparecer em seu aplicativo.

{width="300"}