Criar e enviar notificações por push

As etapas a seguir não são específicas do Adobe Experience Cloud e foram projetadas para orientá-lo pela configuração de APNs.

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

2. Para criar uma chave, selecione +.

   {modal="regular"}

3. Forneça um Nome da Chave.

4. Selecione o Serviço de notificação por push do Apple (APNs) e selecione Configurar.

   1. Na tela Configurar Chave, selecione Sandbox e Produção no menu suspenso Ambiente.
   2. Selecione Salvar.

5. Selecione Continuar.

   {modal="regular"}

6. Revise a configuração e selecione Registrar.

7. Baixe a chave privada .p8. Ele é usado no próximo exercício, quando você configura a credencial de push do Journey Optimizer.

8. Anote a Key ID. Ele é usado no próximo exercício, quando você configura a credencial de push do Journey Optimizer.

9. Anote a ID da Equipe. Ele é usado no próximo exercício, quando você configura a credencial de push do Journey Optimizer. A ID da equipe pode ser encontrada no canto superior direito da tela, próximo ao seu nome de logon.
   {modal="regular"}

A documentação adicional pode ser encontrada aqui.

As etapas a seguir não são específicas do Adobe Experience Cloud e foram projetadas para orientá-lo pela configuração do Firebase.

1. Acesse o console Firebase.

2. Selecione Criar um projeto Firebase.

   1. Insira um Nome do projeto.
   2. Selecione Continuar em Criar um projeto - Vamos começar com um nome para o seu projeto. Por exemplo, Luma Android App.
   3. Desative o Gemini no Firebase e selecione Continuar em Criar um projeto - Assistência de IA para seu projeto do Firebase.
   4. Desative o Google Analytics para este projeto e selecione Continuar em Criar um projeto - Google Analytics para seu projeto Firebase.
   5. Selecione Criar Projeto.
   6. Depois que o projeto estiver pronto, selecione Continuar.

3. De volta ao console do Firebase, verifique se o projeto está selecionado na parte superior. Por exemplo, Aplicativo Luma Android.

   {modal="regular"}

4. Selecione > Configurações do Projeto.

5. Em Configurações do projeto, selecione Adicionar aplicativo.

   1. Em Adicionar Firebase ao seu aplicativo, selecione Android como plataforma.

   2. No Adicionar o Firebase ao aplicativo do Android:

      1. Na etapa 1, Registrar aplicativo:

         1. Insira um nome de pacote do Android, semelhante ao identificador do aplicativo. Por exemplo, com.adobe.luma.tutorial.android.
         2. Digite um apelido de aplicativo opcional.
         3. Selecione Registrar aplicativo.

      2. Na etapa 2, Baixe e adicione o arquivo de configuração.

         1. Selecione Baixar google-services.json. Ao criar sua própria versão do aplicativo Android, você deve substituir o arquivo google-services.json atual no projeto de amostra do Android Studio pela versão do arquivo gerada por essa nova configuração de aplicativo.
            As outras etapas já estão disponíveis no aplicativo de amostra.

   Sua tela deve ter a aparência abaixo:

   {modal="regular"}

6. Em Configurações do Projeto, selecione Contas de serviço.

7. Selecione Gerar nova chave privada. Um arquivo luma-android-app-firebase-adminsdk-xxxx-xxxxxxxx.json é gerado. Armazene esse arquivo em um local seguro, conforme necessário, em um estágio posterior.

Para obter mais informações, consulte a documentação para desenvolvedor do Firebase.

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

2. 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.

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

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

Agora você deve ter uma extensão de notificação por push adicionada ao seu aplicativo, semelhante à tela abaixo.

{modal="regular"}

O projeto do Android Studio já está configurado para notificações por push. Não é necessário executar etapas adicionais para habilitar a versão para Android do aplicativo Luma para notificações por push. Consulte Sobre notificações para obter mais informações.

As notificações por push do Android exigem a definição de uma ID de canal de notificação, tanto no aplicativo quanto ao envio de uma notificação por push. A ID de notificação do canal usada no aplicativo Android Luma é LUMA_CHANNEL ID.

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

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

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

   import AEPMessaging

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

   code language-swift
   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 ]

1. No Android Studio, verifique se aepsdk-messing-android faz parte das dependências no build.gradle.kts (Módulo :app) no Android Gradle Scripts. Consulte Gradle.

2. Navegue até Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication no navegador de projetos do Android Studio.

3. Certifique-se de que com.adobe.marketing.mobile.Messaging faça parte da sua lista de importações.

   import import com.adobe.marketing.mobile.Messaging

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

   code language-kotlin
   val extensions = listOf( Identity.EXTENSION, Lifecycle.EXTENSION, Signal.EXTENSION, Edge.EXTENSION, Consent.EXTENSION, UserProfile.EXTENSION, Places.EXTENSION, Messaging.EXTENSION, Optimize.EXTENSION, Assurance.EXTENSION )

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

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

   code language-swift
   // 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.

1. Navegue até Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication no navegador de projetos do Android Studio.

2. Adicione a API MobileCore.setPushIdentifier à função override fun onCreate() em class LumaAplication : Application, em FirebaseMessaging.getInstance().token.addOnCompleteListener.

   code language-kotlin
   // Send push token to Mobile SDK MobileCore.setPushIdentifier(token)

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

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

   code language-swift
   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.

   code language-json
   { "eventType": string, "application" : [ "id": string ] }

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

   code language-swift
   // 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 também leva em conta os aspectos assíncronos de chamar a SDK do Adobe Experience Platform por meio do uso do modelo de simultaneidade do Swift, com base em await e async.

3. 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.

   code language-swift
   // 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) }

1. Navegue até Android > app > kotlin+java > com.adobe.luma.tutorial.android > xdm > TestPushPayload.kt no navegador do Android Studio e inspecione o código.

   code language-kotlin

   import com.google.gson.annotations.SerializedName data class TestPushPayload( @SerializedName("application") val application: Application, @SerializedName("eventType") val eventType: String ) { fun asMap(): Map<String, Any> { return mapOf( "application" to application.asMap(), "eventType" to eventType ) } } data class Application( @SerializedName("id") val id: String ) { fun asMap(): Map<String, Any> { return mapOf( "id" to id ) } }

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

   code language-json
   { "eventType": string, "application" : [ "id": string ] }

2. Navegue até Android > app > kotlin+java > com.adobe.luma.tutorial.android > templates > MobileSDK no navegador do Android Studio e adicione o seguinte código a func sendTestPushEvent(applicationId: String, eventType: String):

   code language-kotlin
   // Create payload and send experience event val testPushPayload = TestPushPayload( Application(applicationId), eventType ) sendExperienceEvent(testPushPayload.asMap())

   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 mapa.

3. Navegue até Android > app > kotlin+java > com.adobe.luma.android.tutorial > views > ConfigView.kt no navegador do Android Studio. 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.

   code language-kotlin
   // Setting parameters and calling function to send push notification val eventType = testPushEventType val applicationId = context.packageName scope.launch { MobileSDK.shared.sendTestPushEvent( applicationId, eventType ) }

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

2. Vá para a guia Configurações.

3. Toque em Notificação por push.

   Você verá a notificação por push aparecer na parte superior do aplicativo.

   {width="300"}

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

2. Vá para a guia Configurações.

3. Toque em Notificação por push.

   Você verá a notificação por push aparecer na parte superior do aplicativo.

   {width="300"}