Show Menu
TÓPICOS×

Configuração do aplicativo móvel no Adobe Campaign

Encontre abaixo a amostra da configuração baseada em uma empresa que vende online pacotes de viagens. Seu aplicativo móvel (Neotrips) está disponível para os clientes em duas versões: Neotrips para Android e Neotrips para iOS. Para configurar o aplicativo móvel no Adobe Campaign, é necessário:
  • Crie um serviço de informação do tipo Mobile application para o aplicativo para dispositivos móveis Neotrips.
  • Adicione as versões iOS e Android do aplicativo a este serviço.
  • Crie um delivery para iOS e Android.
Acesse a guia Subscriptions do serviço para exibir a lista de assinantes do serviço, ou seja, todas as pessoas que instalaram o aplicativo nos próprios celulares e concordaram em receber as notificações.

Configuração do aplicativo para dispositivos móveis com iOS

O aplicativo deve ter sido configurado para ações Push ANTES de qualquer integração ao Adobe Campaign SDK.
Se esse não for o caso, consulte esta página .

Etapa 1: instalação do pacote

  1. Acesse o assistente de importação do pacote do Tools > Advanced > Package import... no console do cliente Adobe Campaign.
  2. Selecione Install a standard package .
  3. Na lista que aparece, marque Mobile App Channel .
  4. Clique em Next e, em seguida, em Start para começar a instalação do pacote.
    Depois que os pacotes forem instalados, a barra de progresso mostrará 100% e você poderá ver a seguinte mensagem nos registros de instalação: Installation of packages successful .
  5. Close a janela de instalação.

Etapa 2: configuração da conta externa d iOS

Para iOS, dois conectores estão disponíveis:
  • O conector binário do iOS envia notificações no servidor binário APNS herdado.
  • O conector HTTP/2 do iOS envia notificações para o HTTP/2 APNS.
Para escolher qual conector deseja usar, siga estas etapas:
  1. Vá para Administration > Platform > External accounts .
  2. Selecione a conta externa iOS routing .
  3. Na guia Connector , preencha o campo Access URL of the connector :
    Para iOS HTTP2: http://localhost:8080/nms/jsp/iosHTTP2.jsp
    Você também pode configurá-lo assim: https://localhost:8080/nms/jsp/ios.jsp, mas recomendamos que você use a versão 2 do conector.
  4. Clique em Save .
O conector iOS está configurado. Você pode começar a criar seu serviço.

Etapa 3: configuração do serviço iOS

  1. Acesse o nó Profiles and Targets > Services and subscriptions e clique em New .
  2. Defina um Label e um Internal name .
  3. Acesse o campo Type e selecione Mobile application .
    O target mapping Subscriber applications (nms:appSubscriptionRcp) padrão é vinculado à tabela de destinatários. Para utilizar um mapeamento de alvo diferente, é necessário criar um novo e inseri-lo no campo Target mapping do serviço. Para obter mais informações sobre como criar o target mapping, consulte o Guia de configuração .
  4. Em seguida, clique no botão Add para selecionar o tipo de aplicativo.
  5. A janela a seguir é exibida. Selecione Create an iOS application e comece inserindo o Label .
  6. Como opção, você pode enriquecer um conteúdo de mensagem de push com alguns Application variables se necessário. Eles são totalmente personalizáveis e uma parte da carga da mensagem é enviada para o dispositivo móvel. No exemplo a seguir, adicionamos mediaURl e mediaExt para criar notificações por push avançadas e, em seguida, fornecemos ao aplicativo a imagem que será exibida na notificação.
  7. A guia Subscription parameters permite definir o mapeamento com uma extensão do schema Subscriber applications (nms:appsubscriptionRcp) .
    Certifique-se de não usar o mesmo certificado para a versão de desenvolvimento (sandbox) e a versão de produção do aplicativo.
  8. A guia Sounds permite que você especifique um som para reproduzir. Clique em Add e preencha o campo Internal name que deve conter o nome do arquivo incorporado no aplicativo ou o nome do som do sistema.
  9. Clique em Next para configurar o aplicativo de desenvolvimento.
  10. Verifique se a mesma Integration key está definida no Adobe Campaign e no código do aplicativo por meio do SDK. Para obter mais informações, consulte: Integração do SDK do Campaign ao aplicativo móvel . Essa chave de integração, específica para cada aplicativo, permite vincular o aplicativo móvel à plataforma do Adobe Campaign.
    O Integration key é totalmente personalizável com o valor da string, mas precisa ser exatamente o mesmo especificado no SDK.
  11. Selecione um dos ícones prontos do campo Application icon para personalizar o aplicativo para dispositivos móveis em seu serviço.
  12. Clique no link Enter the certificate... e, em seguida, selecione o certificado de autenticação e insira a senha fornecida pelo desenvolvedor de aplicativos para dispositivos móveis. Você pode clicar em Test the connection para ter certeza de que ele é bem-sucedido.
    A Apple exige certificados diferentes para versões de Desenvolvimento e Produção de um mesmo aplicativo para dispositivos móveis. Você precisará configurar os dois aplicativos separados no Adobe Campaign.
  13. Clique em Next para configurar o aplicativo de produção e siga as mesmas etapas descritas acima.
  14. Clique em Finish . Seu aplicativo iOS está pronto para ser usado no Campaign Classic.

Etapa 4: criação de uma notificação avançada do iOS

Com o iOS 10 ou superior, é possível gerar notificações ricas. O Adobe Campaign pode enviar notificações usando variáveis que permitirão ao dispositivo exibir uma notificação rica.
Em seguida, é necessário criar um novo delivery e vinculá-lo ao aplicativo para dispositivos móveis criado.
  1. Vá até Campaign management > Deliveries .
  2. Clique em New .
  3. Selecione Deliver on iOS (ios) na lista suspensa Delivery template . Adicione um Label ao delivery.
  4. Clique em To para definir a população como target. Por padrão, o target mapping Subscriber application é aplicado. Clique em Add para selecionar o serviço criado anteriormente.
  5. Na janela Target type , selecione Subscribers of an iOS mobile application (iPhone, iPad) e clique em Next .
  6. Na lista suspensa Service , selecione o serviço criado anteriormente e, em seguida, o aplicativo que deseja direcionar e clique em Finish . Os Application variables são adicionados automaticamente, dependendo do que foi adicionado durante as etapas de configuração.
  7. Edite a notificação avançada.
  8. Marque a caixa Mutable content na janela de notificação de edição para permitir que o aplicativo para dispositivos móveis baixe o conteúdo de mídia.
  9. Clique em Save e envie o delivery.
A imagem e a página da Web devem ser exibidas na notificação por push quando recebida nos dispositivos iOS móveis dos inscritos.

Configuração do aplicativo para dispositivos móveis com Android

Etapa 1: instalação do pacote

  1. Acesse o assistente de importação do pacote do Tools > Advanced > Package import... no console do cliente Adobe Campaign.
  2. Selecione Install a standard package .
  3. Na lista que aparece, marque Mobile App Channel .
  4. Clique em Next e, em seguida, em Start para começar a instalação do pacote.
    Depois que os pacotes forem instalados, a barra de progresso mostrará 100% e você poderá ver a seguinte mensagem nos registros de instalação: Installation of packages successful .
  5. Close a janela de instalação.

Etapa 2: configuração da conta externa Android

Para Android, dois conectores estão disponíveis:
  • O conector V1 que permite uma conexão por MTA filho.
  • O conector V2 que permite conexões simultâneas com o servidor FCM para melhorar o throughput.
Para escolher qual conector deseja usar, siga estas etapas:
  1. Vá para Administration > Platform > External accounts .
  2. Selecione a conta externa Android routing .
  3. Na guia Connector , preencha o campo JavaScript used in the connector :
    Para Android V2: https://localhost:8080/nms/jsp/androidPushConnectorV2.js
    Você também pode configurá-lo assim: https://localhost:8080/nms/jsp/androidPushConnector.js, mas recomendamos que você use a versão 2 do conector.
  4. Para Android V2, um parâmetro adicional está disponível no arquivo de configuração do Adobe Server (serverConf.xml):
    • maxGCMConnectPerChild : Limite máximo de solicitações HTTP paralelas para o FCM iniciado por cada servidor filho (8 por padrão).

Etapa 3: configuração do serviço Android

  1. Acesse o nó Profiles and Targets > Services and subscriptions e clique em New .
  2. Defina um Label e um Internal name .
  3. Acesse o campo Type e selecione Mobile application .
    O target mapping Subscriber applications (nms:appSubscriptionRcp) padrão é vinculado à tabela de destinatários. Para utilizar um mapeamento de alvo diferente, é necessário criar um novo e inseri-lo no campo Target mapping do serviço. Para obter mais informações sobre como criar o target mapping, consulte o Guia de configuração .
  4. Em seguida, clique no botão Add para selecionar o tipo de aplicativo.
  5. Selecione Create an Android application .
  6. Insira um Label .
  7. Verifique se a mesma Integration key está definida no Adobe Campaign e no código do aplicativo por meio do SDK. Para obter mais informações, consulte: Integração do SDK do Campaign ao aplicativo móvel .
    O Integration key é totalmente personalizável com o valor da string, mas precisa ser exatamente o mesmo especificado no SDK.
  8. Selecione um dos ícones prontos do campo Application icon para personalizar o aplicativo para dispositivos móveis em seu serviço.
  9. Inserir as configurações de conexão do aplicativo: insira a chave do projeto fornecida pelo desenvolvedor do aplicativo para dispositivos móveis.
  10. Como opção, você pode enriquecer um conteúdo de mensagem de push com alguns Application variables se necessário. Eles são totalmente personalizáveis e uma parte da carga da mensagem é enviada para o dispositivo móvel.
    No exemplo a seguir, adicionamos title , imageURL e iconURL para criar notificações por push avançadas e, em seguida, fornecemos ao aplicativo a imagem, o título e o ícone que serão exibidos na notificação.
  11. Clique em Finish e em Save . Seu aplicativo Android agora está pronto para ser usado no Campaign Classic.
Por padrão, o Adobe Campaign salva uma chave no campo User identifier (@userKey) da tabela Subscriber applications (nms:appSubscriptionRcp) . Essa chave permite vincular uma subscrição a um recipient. Para coletar dados adicionais (como uma chave de reconciliação complexa), é necessário aplicar a seguinte configuração:
  1. Crie uma extensão do schema Subscriber applications (nms:appsubscriptionRcp) e defina os novos campos.
  2. Defina o mapeamento na guia Subscription parameters .
    Verifique se os nomes da configuração da guia Subscription parameters são iguais aos do código do aplicativo móvel. Consulte a seção Integrating Campaign SDK into the mobile application .

Etapa 4: criar uma notificação avançada do Android

Em seguida, é necessário criar um novo delivery e vinculá-lo ao aplicativo para dispositivos móveis criado.
  1. Vá até Campaign management > Deliveries .
  2. Clique em New .
  3. Selecione Deliver on Android (android) na lista suspensa Delivery template . Adicione um Label ao delivery.
  4. Clique em To para definir a população como target. Por padrão, o target mapping Subscriber application é aplicado. Clique em Add para selecionar o serviço criado anteriormente.
  5. Na janela Target type , selecione Assinantes de um aplicativo Android para dispositivos móveis e clique em Next .
  6. Na lista suspensa Service , selecione o serviço criado anteriormente, depois o aplicativo e clique em Finish . Os Application variables são adicionados automaticamente, dependendo do que foi adicionado durante as etapas de configuração.
  7. Edite a notificação avançada.
  8. Clique em Save e envie o delivery.
A imagem e a página da web devem ser exibidas na notificação por push quando recebida nos dispositivos Android móveis dos subscritos.