DocumentaçãoCampaignDocumentação do Campaign Classic v7

Etapas de configuração para Android

Last update: Wed Sep 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Usuário
  • Desenvolvedor

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

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.

IMPORTANT
Algumas alterações importantes no serviço Firebase Cloud Messaging (FCM) para Android serão lançadas em 2024 e poderão afetar sua implementação do Adobe Campaign. A configuração dos serviços de assinatura para mensagens por push no Android pode precisar ser atualizada para oferecer suporte a essa alteração. É recomendado verificar isso antecipadamente e tomar as devidas ações. Saiba mais nesta nota técnica do Adobe Campaign v8.

Configuração da conta externa do Android configuring-external-account-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

    note note
    NOTE
    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 configuring-android-service

 Saiba como configurar um serviço do Android no 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.

    note note
    NOTE
    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 creating-android-app

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.

    note note
    NOTE
    A Integration key é totalmente personalizável com o valor da string, 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 destinatário. Para coletar dados adicionais (como uma chave de reconciliação complexa), é necessário aplicar a seguinte configuração:

Configurar a versão da API select-api-version

IMPORTANT
Algumas alterações importantes no serviço Firebase Cloud Messaging (FCM) para Android serão lançadas em 2024 e poderão afetar sua implementação do Adobe Campaign. Como parte do esforço contínuo do Google para melhorar seus serviços, as APIs herdadas do FCM serão descontinuadas em 20 de junho de 2024. Saiba mais nesta nota técnica do Adobe Campaign v8.

Depois de criar um serviço e um novo aplicativo para dispositivos móveis, é necessário configurar esse aplicativo. A API HTTP (herdada) não deve ser selecionada, pois foi descontinuada pelo Google.

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.

    note caution
    CAUTION
    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

Estender o esquema appsubscriptionRcp extend-subscription-schema

Saiba como estender o esquema appsubscriptionRcp no vídeo

É necessário estender o appsubscriptionRcp para definir 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.

    note caution
    CAUTION
    Verifique se os nomes da configuração da guia Subscription parameters são iguais aos do código do aplicativo móvel.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1