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 do 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 de um 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 esta seçã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 o 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 esta seção.

    OBSERVAÇÃO

    A Integration key é totalmente personalizável com o valor da sequência de caracteres, mas precisa ser exatamente a mesma especificada 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:

Selecionar a versão da API

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

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

    ATENÇÃO

    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 (herdada)

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.

    ATENÇÃO

    Verifique se os nomes da configuração da guia Subscription parameters são iguais aos do código do aplicativo móvel. Consulte esta seção.

Nesta página