Etapas de configuração para Android

Depois que o pacote for instalado, você poderá definir as configurações do aplicativo Android no Adobe Campaign Classic.

OBSERVAÇÃO

Para saber como configurar seu aplicativo para iOS e como criar um delivery para iOS, consulte esta seção.

As principais etapas são:

  1. Configuração da conta externa do Android
  2. Configuração do serviço Android
  3. Criação do aplicativo móvel no Campaign
  4. Extensão do esquema do aplicativo com dados adicionais

Você poderá criar uma notificação avançada do Android.

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

    OBSERVAÇÃO

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

Configuração do serviço Android

Saiba como configurar um serviço Android em vídeo

  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.

    OBSERVAÇÃO

    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. Crie seu aplicativo Android. Para obter mais informações, consulte esta seção.

Criar aplicativo Android para dispositivos móveis

Depois de criar o serviço, é necessário criar o aplicativo Android:

  1. Em seu serviço recém-criado, clique no botão Add para selecionar o tipo de aplicativo.

  2. Selecione Create an Android application e insira um Label.

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

    OBSERVAÇÃO

    O Integration key é totalmente personalizável com o valor da string, mas precisa ser exatamente o mesmo especificado no SDK.

  4. Selecione o API version: HTTP v1 ou HTTP (legado). Essas configurações são detalhadas nesta seção

  5. Preencha o campo Firebase Cloud Messaging the Android connection settings.

  6. 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:

Selecione a versão da API

Depois de criar um serviço e um novo aplicativo móvel, é necessário configurar seu aplicativo móvel dependendo da versão da API escolhida.

  • A configuração HTTP v1 está detalhada nesta seção.
  • A configuração HTTP (legada) está detalhada nesta seção.

Configurar API HTTP v1

Para configurar a versão da API HTTP v1, siga as etapas abaixo:

  1. Na janela Mobile application creation wizard selecione HTTPV1 no menu suspenso API version.

  2. Clique em Load project json file to extract projet details… para carregar diretamente o arquivo de chave JSON. Para obter mais informações sobre como extrair o arquivo JSON, consulte esta página.

    Você também pode inserir manualmente os seguintes detalhes:

    • Project Id
    • Private Key
    • Client Email

  3. Clique em Test the connection para verificar se a configuração está correta e se o servidor de marketing tem acesso ao FCM.

    CUIDADO

    Para implantação de mid-sourcing, o botão Test connection não verificará se o servidor MID tem acesso ao servidor FCM.

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

  5. Clique em Finish e em Save. Seu aplicativo Android agora está pronto para ser usado no Campaign Classic.

Abaixo estão os nomes de payload do FCM para personalizar ainda mais sua notificação por push:

Tipo de mensagem Elemento de mensagem configurável (nome da carga FCM) Opções configuráveis (nome da carga do FCM)
mensagem de dados N/D validate_only
mensagem de notificação title, body, android_channel_id, icon, sound, tag, color, click_action, image, ticker, sticky, visibility, notification_priority, notification_count
validate_only


Configurar API HTTP (legada)

Para configurar a versão da API HTTP (herdada), siga as etapas abaixo:

  1. Na janela Mobile application creation wizard selecione HTTP (legacy) no menu suspenso API version.

  2. Digite o Project key que foi fornecido pelo desenvolvedor do aplicativo móvel.

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

  4. Clique em Finish e em Save. Seu aplicativo Android agora está pronto para ser usado no Campaign Classic.

Abaixo estão os nomes de payload do FCM para personalizar ainda mais sua notificação por push:

Tipo de mensagem Elemento de mensagem configurável (nome da carga FCM) Opções configuráveis (nome da carga do FCM)
mensagem de dados N/D dryRun
mensagem de notificação title, body, android_channel_id, icon, sound, tag, color, click_action
dryRun

Estender o esquema appsubscriptionRcp

Saiba como estender o esquema appsubscriptionRcp em vídeo

É necessário estender o appsubscriptionRcp para definir novos campos adicionais para armazenar parâmetros do aplicativo no banco de dados do Campaign. Esses campos serão usados para personalização, por exemplo. Para fazer isso:

  1. Crie uma extensão do esquema Subscriber applications (nms:appsubscriptionRcp) e defina os novos campos. Saiba mais sobre extensão de esquema nesta página

  2. Defina o mapeamento na guia Subscription parameters.

    CUIDADO

    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.

Criação de uma notificação avançada de Android

Com o Firebase Cloud Messaging, você pode escolher entre dois tipos de mensagens:

  • Data message, manipulada pelo aplicativo do cliente.

    As mensagens são enviadas diretamente para o aplicativo móvel que gerará e exibirá a notificação do Android para o dispositivo. As mensagens de dados contêm somente as variáveis personalizadas do aplicativo.

  • Notification message, manipulada automaticamente pelo SDK do FCM.

    O FCM exibe automaticamente a mensagem nos dispositivos dos usuários em nome do aplicativo do cliente. As mensagens de notificação contêm um conjunto predefinido de parâmetros e opções, mas ainda podem ser personalizadas com variáveis de aplicativo personalizadas.

Para obter mais informações sobre os tipos de mensagens da Firebase Cloud Messaging, consulte a documentação do FCM.

Criação de uma mensagem de dados

  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 seu serviço.

  5. Na janela Target type, selecione Subscribers of an Android mobile application 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. Selecione data message como Message Type.

  8. Edite a notificação avançada.

  9. Você pode adicionar informações em sua Application variables configurada anteriormente, caso necessário. Application variables precisa ser configurado no serviço Android e faz parte do payload da mensagem enviada para o dispositivo móvel.

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

Criar uma mensagem de notificação

OBSERVAÇÃO

Opções adicionais para mensagem de notificação estão disponíveis somente com a configuração da API HTTP v1. Para obter mais informações, consulte esta seção.

Saiba como criar uma notificação por push para Android em vídeo

  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 seu serviço.

  5. Na janela Target type, selecione Subscribers of an Android mobile application e clique em Next.

  6. Na lista suspensa Service, selecione o serviço criado anteriormente, depois o aplicativo e clique em Finish.

  7. Selecione notification message como Message Type.

  8. Adicione um título e edite sua mensagem. Personalize sua notificação por push com o Notification options:

    • Channel ID: Defina a ID do canal da sua notificação. O aplicativo deve criar um canal com essa ID de canal antes que qualquer notificação com essa ID de canal seja recebida.
    • Sound: Defina o som que será reproduzido quando o dispositivo receber sua notificação.
    • Color: Defina a cor do ícone da sua notificação.
    • Icon: Defina o ícone da notificação que será exibido em seus dispositivos de perfis.
    • Tag: Defina o identificador usado para substituir notificações existentes na gaveta de notificações.
    • Click action: Defina a ação associada a um clique do usuário em sua notificação.

    Para obter mais informações sobre Notification options e como preencher esses campos, consulte a documentação do FCM.

  9. Se seu aplicativo estiver configurado com protocolo HTTP v1 API, você poderá personalizar ainda mais sua notificação por push com o seguinte HTTPV1 additional options:

    • Ticker: Defina o texto do ticker da sua notificação. Disponível somente para dispositivos definidos como Android 5.0 Lollipop.
    • Image: Defina o URL da imagem que será exibido na sua notificação.
    • Notification Count: Defina o número de novas informações não lidas para serem exibidas diretamente no ícone do aplicativo.
    • Sticky: Defina como verdadeiro ou falso. Se definido como falso, a notificação será automaticamente fechada quando o usuário clicar nela. Se definida como verdadeiro, a notificação ainda será exibida mesmo quando o usuário clicar nela.
    • Notification Priority: Defina os níveis de prioridade da sua notificação como padrão, mínimo, baixo ou alto. Para obter mais informações, consulte a documentação do FCM.
    • Visibility: Defina os níveis de visibilidade de sua notificação como público, privado ou secreto. Para obter mais informações, consulte a documentação do FCM.

    Para obter mais informações sobre HTTP v1 additional options e como preencher esses campos, consulte a documentação do FCM.

  10. Você pode adicionar informações em sua Application variables configurada anteriormente, caso necessário. Application variables precisa ser configurado no serviço Android e faz parte do payload da mensagem enviada para o dispositivo móvel.

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

Nesta página