Mobile Platform as a Service:Criar uma mensagem - Push múltiplo

O push múltiplo é um método para enviar mensagens a vários destinos, frequentemente utilizado para necessidades operacionais.

Existem dois tipos de push múltiplo:

• Broadcast push: Envia a mesma mensagem de modelo para todos os dispositivos Android, iOS ou HarmonyOS do seu aplicativo. Este método suporta apenas o envio de mensagens por dispositivo. Ao transmitir uma mensagem, todos os dispositivos que atenderem às seguintes condições dentro do período de validade da mensagem a receberão: dispositivos Android conectados e dispositivos iOS ou HarmonyOS vinculados.

• Broadcast push: Envia a mesma mensagem de modelo para todos os dispositivos Android ou iOS do seu aplicativo. Este método suporta apenas o envio de mensagens por dispositivo. Ao transmitir uma mensagem, todos os dispositivos que atenderem às seguintes condições dentro do período de validade da mensagem a receberão: dispositivos Android conectados e dispositivos iOS vinculados.

• Push direcionado: Envia a mesma mensagem de modelo para um grupo de público específico. Carregue manualmente um arquivo de público, defina um público personalizado ou use diretamente um grupo de público do Mobile Analysis.

Este tópico descreve como criar uma mensagem de push múltiplo no console.

Pré-requisitos

• Antes de enviar mensagens para dispositivos iOS, integre o Message Push iOS SDK. Configure também o certificado de push para dispositivos Apple na página Channel Configuration no console. Para mais informações, consulte Channel Configuration.

• Antes de enviar mensagens para dispositivos HarmonyOS, integre o Message Push HarmonyOS SDK. Configure também o certificado de push para dispositivos HarmonyOS na página Channel Configuration no console. Para mais informações, consulte Channel Configuration.

• Antes de usar um canal de fornecedor Android para enviar mensagens, integre o Message Push Android SDK e o canal de fornecedor correspondente. Conclua também a configuração do canal de push na página Channel Configuration no console. Para mais informações, consulte Configure Android push channels.

• Antes de criar uma mensagem de push múltiplo, crie um modelo. Para mais informações, consulte Create a template.

• Se você estiver criando uma mensagem de push múltiplo e desejar segmentar um grupo de público do Mobile Analysis, crie primeiro o grupo de público. Para mais informações, consulte Create an audience group. Caso queira segmentar um grupo de tags de usuário, crie primeiro o grupo de tags. Para mais informações, consulte Create a user tag.

Procedimento

1. Faça login no console do mPaaS e selecione o aplicativo alvo. No painel de navegação à esquerda, escolha Message Push Service > Message management.

2. Clique em Create message push task. Na caixa de diálogo exibida, selecione a aba Multiple Push.

3. Na aba Multiple Push, configure as informações básicas da mensagem de push. Os itens de configuração estão descritos abaixo:

   Parâmetro	Obrigatório	Descrição
   Tipo de mensagem: mensagem silenciosa	Sim	Define se a mensagem deve ser exibida: Sim: A mensagem é silenciosa. O usuário não percebe a mensagem e ela não é exibida no dispositivo alvo. Não: A mensagem é exibida na barra de notificações. Para a plataforma Android, execute diferentes operações subsequentes com base no canal de push: Canal MPS: Este parâmetro é enviado ao cliente como um campo de referência. Analise o corpo da mensagem e use este campo para controlar como a mensagem é exibida. Canal de fornecedor: Este parâmetro é enviado ao dispositivo alvo. O sistema do fornecedor analisa o campo e controla a exibição da mensagem. Nenhuma outra ação é necessária. Para a plataforma iOS, o sistema do fornecedor gerencia a exibição da mensagem. Nenhuma outra ação é necessária.
   Dimensão do push	Sim	Selecione o modo de entrega da mensagem. As opções incluem: Users: Envia mensagens com base em IDs de usuário. Chame a API attach para vincular IDs de usuário a IDs de dispositivo. Para mais informações sobre a API attach, consulte Client API. Devices: Envia mensagens com base em IDs de dispositivo.
   Plataforma de push	Sim	Ao enviar mensagens por dispositivo, selecione uma plataforma de push para especificar o tipo de dispositivo. Android: Oferece canais de fornecedores Android e o canal próprio do MPS. Envia mensagens para todos os dispositivos Android online na rede (dentro do período de validade da mensagem) ou para dispositivos Android específicos. Cada dispositivo recebe a mensagem apenas uma vez. iOS: Utiliza o canal do fornecedor para enviar mensagens a todos ou a usuários específicos do cliente iOS. Cada usuário recebe a mensagem apenas uma vez.
   Selecionar alvos do push	Sim	Ao enviar mensagens por dimensão de usuários, as seguintes opções estão disponíveis: Upload a group: Carregue manualmente um arquivo de usuários alvo. O arquivo deve conter os IDs alvo e configurações personalizadas para cada alvo com base no modelo selecionado. Cada linha no arquivo representa uma mensagem, identificada por um ID de mensagem de negócio. Os requisitos de formato do arquivo são: Cada linha deve estar no formato: User ID,Business Message ID,placeholder1=XXX;placeholder2=XXX.... O ID da mensagem de negócio é definido pelo usuário. O arquivo deve ter codificação UTF-8. O tamanho máximo é de 200 MB. Use quebras de linha para separar múltiplas entradas de dados. Cada entrada não pode exceder 250 caracteres. É possível carregar no máximo um arquivo por tarefa de push. Após o carregamento, um ícone referente ao arquivo aparece abaixo do botão Upload. Clique no ícone para visualizar o conteúdo do arquivo. É possível visualizar até 10 entradas de dados. MAS group: Utiliza um grupo de público do Mobile Analysis para enviar a mesma mensagem a todos os membros. Crie primeiro um grupo de público no Mobile Analysis. Para mais informações, consulte Create an audience group. Esta opção não estará disponível se o modelo de push selecionado contiver placeholders. User tags: Seleciona um grupo de público com base em tags de usuário. Antes de selecionar um público tagueado, crie as tags de usuário. Se o envio for por dispositivo, selecione: All devices: Envia a mensagem para todos os dispositivos na plataforma selecionada. Partial devices: Carregue manualmente um arquivo de dispositivos alvo. O arquivo deve conter os IDs alvo e configurações personalizadas para cada alvo com base no modelo selecionado. Cada linha no arquivo representa uma mensagem, identificada por um ID de mensagem de negócio. Os requisitos de formato do arquivo são: Cada linha deve estar no formato: Device ID,Business Message ID,placeholder1=XXX,placeholder2=XXX.... O ID da mensagem de negócio é definido pelo usuário. O arquivo deve ter codificação UTF-8. O tamanho máximo é de 200 MB. Use quebras de linha para separar múltiplas entradas de dados. Cada entrada não pode exceder 250 caracteres. É possível carregar no máximo um arquivo por tarefa de push. Exemplo: mpaas_push_demo,123456,title=111,content=222. Após o carregamento, um ícone referente ao arquivo aparece abaixo do botão Upload. Clique no ícone para visualizar o conteúdo do arquivo. É possível visualizar até 10 entradas de dados. MAS group: Utiliza um grupo de público do Mobile Analysis para enviar a mesma mensagem a todos os membros. Crie primeiro um grupo de público no Mobile Analysis. Para mais informações, consulte Create an audience group. Esta opção não estará disponível se o modelo de push selecionado contiver placeholders.
   Modelo de push	Sim	Selecione um modelo de mensagem. Escolha qualquer modelo na página Message Template do aplicativo atual.
   Placeholder do modelo	Sim	Insira os valores para as variáveis no modelo. O sistema fornece campos de configuração com base nos placeholders do modelo selecionado.
   Prioridade de push dos canais de mensagem Android	Sim	Aplica-se apenas à plataforma Android. As opções incluem: Vendor channels preferred: Envia mensagens primeiramente pelos canais de fornecedores. Para canais integrados, a mensagem é enviada pelo serviço do canal correspondente. Para canais não integrados, a mensagem é enviada pelo canal próprio do MPS. MPS channel: Envia mensagens pelo canal próprio do MPS. Na plataforma Android, este parâmetro permite escolher entre o canal próprio e os canais de fornecedores. Não é necessário configurar este parâmetro para a plataforma iOS, pois o push para iOS utiliza o canal do fornecedor.
   Modo de push	Sim	Selecione quando enviar a mensagem: Now: A mensagem é enviada assim que a tarefa de push é criada. Scheduled: Envia a mensagem em um horário especificado. Por exemplo, agende uma mensagem para ser enviada às 08:00 do dia 19 de junho. Cyclic: Envia a mensagem repetidamente dentro de um intervalo de tempo especificado. Por exemplo, agende uma mensagem para ser enviada toda sexta-feira às 08:00, de 1º de junho a 30 de setembro. Importante Envios agendados e recorrentes não são suportados quando o alvo do push é um público do Mobile Analysis ou um público de tag personalizada.

   No lado direito da caixa de diálogo encontra-se a área Push Preview. Clique em Notification, Apple Message Body, Android Message Body e HarmonyOS Message Body para visualizar a aparência da mensagem e o corpo da mensagem para cada plataforma.

   No lado direito da caixa de diálogo encontra-se a área Push Preview. Clique em Notification, Apple Message Body e Android Message Body para visualizar a aparência da mensagem e o corpo da mensagem para cada plataforma.

4. (Opcional) Configure as seguintes configurações avançadas:

   • Redirect upon click: Especifique a operação a ser executada após o usuário tocar na mensagem no telefone. Este parâmetro é enviado ao cliente como um campo de referência. Implemente as operações subsequentes consultando esse campo.

     • Web page: Os usuários serão redirecionados para uma página da web.

     • Custom page: Os usuários serão redirecionados para uma página nativa.

   • Redirection address: A página a ser acessada após o usuário tocar na mensagem no celular. Insira o endereço de acordo com a opção escolhida.

     • Para Web page, insira a URL da página da web a ser visitada.

     • Para custom page, insira o endereço da página nativa a ser visitada (Android: ActivityName; iOS: VCName).

   • Login status: Especifique os usuários alvo conforme o status de login. Ao selecionar o período de login/logout, Permanent significa sem limite de tempo, ou seja, o envio de mensagens para todos os usuários logados/deslogados.

   • Importante

     A configuração de push por status de login só é possível quando o envio for por dispositivo.

     • Se selecionar Login users, o MPS enviará mensagens aos usuários que fizeram login no App no período especificado. Por exemplo, se o período de login for de 15 dias, as mensagens serão enviadas aos usuários que fizeram login no App nos últimos 15 dias.

     • Se selecionar Logout users, o MPS enviará mensagens aos usuários que saíram do App no período especificado. Por exemplo, se o período de logout for de 15 dias, as mensagens serão enviadas aos usuários que saíram nos últimos 15 dias.

     • Se selecionar tanto Login users quanto Logout users, o MPS enviará mensagens aos usuários que fizeram login no App e também aos que saíram no período especificado. Por exemplo, se o período de login for permanente e o de logout for de 7 dias, as mensagens serão enviadas a todos os usuários logados e àqueles que saíram nos últimos 7 dias.

   • Custom message ID: O sistema gera automaticamente um ID para identificar exclusivamente a mensagem em sua lógica de negócios. Personalize este ID com até 64 caracteres.

   • Valid period: O período de validade da mensagem em segundos. Se a entrega falhar porque o dispositivo está offline ou o usuário deslogado, o MPS reenvia a mensagem após o dispositivo se conectar ou após uma solicitação de vínculo de usuário dentro deste período. Isso melhora a taxa de entrega. Se não definir este parâmetro, o período de validade padrão é de 180 segundos.

     Nota

     O período de validade da mensagem deve ser de no mínimo 180 segundos e no máximo 72 horas.

   • Extension parameters: Para adicionar parâmetros estendidos, ative a chave Extended parameters, clique em Add Parameter e configure o par chave-valor. Clique em qualquer lugar da página para concluir a configuração. Parâmetros estendidos são enviados junto com o corpo da mensagem ao cliente para processamento personalizado. Existem três tipos de parâmetros estendidos:

     • Parâmetros estendidos do sistema

       Estes parâmetros são reservados pelo sistema e seus valores não podem ser modificados. Incluem notifyType, action, silent, pushType, templateCode, channel e taskId.

     • Parâmetros estendidos do sistema com significados especiais

       Estes parâmetros são reservados pelo sistema e possuem significados especiais. Configure os valores para estes parâmetros. A tabela a seguir descreve esses parâmetros.

       Parâmetro	Descrição
       sound	Um toque personalizado. Defina o valor como o caminho do arquivo de toque. Este parâmetro é efetivo apenas para telefones Xiaomi e Apple.
       badge	O número do emblema no ícone do aplicativo. Defina o valor como um número específico. Este parâmetro é enviado com o corpo da mensagem ao cliente. Para telefones Android, implemente a lógica do emblema. Para telefones Apple, o sistema gerencia o emblema automaticamente. Após o envio da mensagem ao telefone alvo, o emblema do ícone do aplicativo exibe o valor configurado.
       mutable-content	O identificador de push personalizado do APNs. Incluir este parâmetro indica suporte ao UNNotificationServiceExtension do iOS10. Se não incluído, trata-se de um push normal. Defina o valor como 1.
       badge_add_num	O número a ser adicionado ao emblema para envios através do canal Huawei.
       badge_class	A classe Activity de entrada do aplicativo correspondente ao ícone da área de trabalho para o canal Huawei.
       big_text	O estilo de texto grande. O valor deve ser 1. Outros valores são inválidos. Este parâmetro é efetivo apenas para telefones Xiaomi e Huawei.

     • Parâmetros estendidos definidos pelo usuário

     Qualquer parâmetro (chave) que não seja um parâmetro estendido do sistema ou um parâmetro estendido do sistema com significado especial é considerado um parâmetro estendido definido pelo usuário. Esses parâmetros são enviados junto com o corpo da mensagem ao cliente para processamento personalizado.

5. Clique em Submit. A mensagem criada aparecerá na lista de registros de mensagens em lote.

Além de enviar mensagens pelo console, utilize uma API para realizar o envio. Para mais informações, consulte Server-side API reference.

Operações relacionadas

• Create a simple push message

• Manage Multiple Push messages

• Manage scheduled push task