Como Usar a Segmentação em Notificações Push de Aplicativos Usando PushEngage

O PushEngage permite agrupar os seus subscritores de aplicações em segmentos para que possa direcionar públicos específicos com notificações relevantes em vez de transmitir para todos de uma vez. Este guia abrange segmentos estáticos, onde um subscritor permanece no grupo até que o remova, e segmentos dinâmicos, onde o subscritor é removido automaticamente após um número definido de dias. Inclui configuração do painel, métodos SDK iOS e Android, e links para a API REST para gestão do lado do servidor.

Antes de Começar

• A sua aplicação tem de estar integrada com o SDK iOS ou Android do PushEngage. Se ainda não o fez, complete primeiro a configuração:
  • Configuração Push de Aplicação iOS
  • Configuração Push de Aplicação Android
  • Configuração Push de Aplicação React Native
  • Configuração Push de Aplicação Flutter
• Os segmentos têm de ser criados no Painel PushEngage antes que o código do seu SDK possa referenciá-los. O nome do segmento que passa para o SDK tem de corresponder exatamente ao nome no painel (sensível a maiúsculas e minúsculas).
• As referências completas dos métodos SDK estão disponíveis em Referência SDK iOS e Referência SDK Android.

Como Funciona a Segmentação Push de Aplicações

Quando um utilizador abre a sua aplicação e o código do seu SDK chama um método de adição de segmento, o PushEngage regista esse dispositivo no segmento correspondente na sua conta. A partir desse momento, qualquer campanha que direcione para esse segmento incluirá esse subscritor.

Existem dois tipos de segmentos:

Segmentos estáticos persistem até que remova explicitamente o subscritor. Use estes para agrupamentos permanentes que refletem um estado fixo, como o nível do plano de um subscritor, a categoria de conteúdo preferida ou a etapa de integração concluída.

Segmentos dinâmicos têm um limite de tempo que define em dias. O PushEngage remove automaticamente o subscritor do segmento após expirar esse período sem qualquer ação necessária da sua aplicação. Use segmentos dinâmicos para estados temporários, como uma janela de compra recente, um período de teste ativo ou uma espera pós-reserva.

Ambos os tipos são criados da mesma forma no painel. A diferença está no método SDK que chama para adicionar subscritores a eles.

Passo 1: Criar um Segmento no Painel

Antes que o seu SDK possa atribuir um subscritor a um segmento, o segmento tem de existir no PushEngage.

1. Inicie sessão na sua conta PushEngage em app.pushengage.com.
2. Vá para Audiência » Segmentos.
3. Clique em Criar um Novo Segmento.
4. Introduza um nome de segmento. Use um nome que seja descritivo e fácil de referenciar em código, por exemplo "Compradores Recentes" ou "Utilizadores Premium".
5. Clique em Guardar Segmento.

Não precisa de adicionar padrões de URL ou regras ao criar segmentos para push de aplicações. O SDK gere a atribuição programaticamente.

Repita este passo para cada segmento que pretenda usar.

Passo 2: Adicionar um Subscritor de Aplicação a um Segmento (iOS)

Chame os métodos de segmento onde quer que faça sentido na lógica da sua aplicação, como após a confirmação de uma compra, após o utilizador selecionar uma preferência de conteúdo ou quando um ecrã específico é visualizado.

Segmento Estático (iOS)

Use addSegments para adicionar o subscritor atual a um ou mais segmentos permanentemente.

PushEngage.addSegments(["Premium Users", "US Customers"]) { response, error in
    if response {
        print("Segments added successfully.")
    } else {
        if let error = error {
            print("Failed to add segments: \(error.localizedDescription)")
        }
    }
}

Para remover um subscritor de um segmento estático:

PushEngage.removeSegments(["US Customers"]) { response, error in
    if response {
        print("Segments removed successfully.")
    }
}

Segmento Dinâmico (iOS)

Use addDynamicSegments para adicionar o subscritor a um segmento por um número fixo de dias. O PushEngage remove automaticamente o subscritor quando a duração expira.

Cada entrada no array é um dicionário com duas chaves: "name" (o nome do segmento como aparece no painel de controlo) e "duration" (o número de dias para manter o subscritor nesse segmento).

let dynamicSegments: [[String: Any]] = [
    ["name": "Recent Buyers", "duration": 30],
    ["name": "Trial Active", "duration": 14],
]

PushEngage.addDynamicSegments(dynamicSegments) { response, error in
    if response {
        print("Dynamic segments updated successfully.")
    } else {
        if let error = error {
            print("Failed to update dynamic segments: \(error.localizedDescription)")
        }
    }
}

As assinaturas completas dos métodos estão disponíveis na Referência do SDK iOS.

Passo 3: Adicionar um Subscritor de Aplicação a um Segmento (Android)

Segmento Estático (Android)

Use addSegment para adicionar o subscritor atual a um ou mais segmentos permanentemente. Passe uma lista de nomes de segmentos que correspondam exatamente ao que criou no painel de controlo.

Java:

List<String> segmentList = new ArrayList<>();
segmentList.add("Premium Users");

PushEngage.addSegment(segmentList, new PushEngageResponseCallback() {
    @Override
    public void onSuccess(Object responseObject) {
        // Segment added successfully
    }

    @Override
    public void onFailure(Integer errorCode, String errorMessage) {
        // Handle failure
    }
});

Para remover um subscritor de um segmento estático:

List<String> segmentList = new ArrayList<>();
segmentList.add("Premium Users");

PushEngage.removeSegment(segmentList, new PushEngageResponseCallback() {
    @Override
    public void onSuccess(Object responseObject) {
        // Segment removed successfully
    }

    @Override
    public void onFailure(Integer errorCode, String errorMessage) {
        // Handle failure
    }
});

Segmento Dinâmico (Android)

Use addDynamicSegment para adicionar o subscritor a um segmento por um número definido de dias. Crie um objeto Segment com um nome e duração, e depois passe-o numa lista.

Java:

AddDynamicSegmentRequest addDynamicSegmentRequest = new AddDynamicSegmentRequest();
List<AddDynamicSegmentRequest.Segment> segments = new ArrayList<>();
AddDynamicSegmentRequest.Segment segment = addDynamicSegmentRequest.new Segment("Recent Buyers", 30);
segments.add(segment);

PushEngage.addDynamicSegment(segments, new PushEngageResponseCallback() {
    @Override
    public void onSuccess(Object responseObject) {
        // Dynamic segment added successfully
    }

    @Override
    public void onFailure(Integer errorCode, String errorMessage) {
        // Handle failure
    }
});

As assinaturas completas dos métodos e equivalentes Kotlin estão disponíveis na Referência do SDK Android.

Passo 4: Segmentar um Segmento numa Campanha

Uma vez que os subscritores são atribuídos a segmentos, pode segmentar esses segmentos ao criar qualquer campanha de notificação push.

1. Vá a Campanha » Transmissões Push (para envios únicos) ou abra uma campanha de gatilho que pretenda configurar.
2. Clique em Criar Nova Transmissão Push ou abra uma campanha existente.
3. Preencha o título da notificação, a mensagem e o URL.
4. Na secção Público, selecione Enviar para um Segmento.
5. Escolha o nome do segmento na lista pendente.
6. Complete o resto das definições da campanha e agende ou envie.

[Screenshot: A página de criação de campanha com a secção Público expandida, mostrando "Enviar para um Segmento" selecionado e um segmento escolhido na lista pendente]

Também pode segmentar múltiplos segmentos de uma vez ou combinar a segmentação de segmentos com outros filtros de público usando Grupos de Público. Veja a documentação Grupos de Público para mais detalhes.

Passo 5: Gerir Segmentos através da API REST (Opcional)

Se o servidor da sua aplicação lida com a gestão de subscritores, pode usar a API REST do PushEngage para criar segmentos e atribuir subscritores sem passar pelo SDK móvel.

Os endpoints de segmento da API REST são:

Todas as chamadas da API REST requerem a sua chave de API no cabeçalho Api-Key. Os IDs de perfil são um identificador flexível que atribui aos subscritores (por exemplo, um endereço de e-mail ou ID de utilizador) que lhe permitem gerir o mesmo subscritor em vários dispositivos.

Exemplo: Adicionar um subscritor a um segmento usando um ID de perfil:

curl -X POST \
  -H "Api-Key: <your_pushengage_api_key>" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d 'segment_name=Recent+Buyers&profile_id=user123&operation=add' \
  "https://api.pushengage.com/apiv1/profile"

Para remover o mesmo subscritor do segmento, altere operation=add para operation=delete.

Consulte a Referência da API REST de Segmentos completa para obter documentação detalhada.

Perguntas Frequentes

Qual é a diferença entre um segmento estático e um segmento dinâmico? Um segmento estático mantém um subscritor no grupo até que chame um método de remoção. Um segmento dinâmico expira automaticamente após o número de dias que especificar ao adicionar o subscritor. Utilize segmentos estáticos para estados permanentes como o tipo de conta. Utilize segmentos dinâmicos para janelas de tempo limitadas como um período pós-compra ou um teste gratuito.

Preciso de criar um segmento separado no painel para uso dinâmico? Não. Os segmentos são criados da mesma forma no painel, independentemente de como adiciona subscritores. A diferença está apenas no método SDK que chama: addSegments adiciona permanentemente e addDynamicSegments adiciona com uma expiração.

O nome do segmento que passo para o SDK não está a corresponder. O que devo verificar? Os nomes dos segmentos diferenciam maiúsculas de minúsculas e devem corresponder exatamente ao nome no Painel PushEngage, incluindo espaços e capitalização. Vá a Público » Segmentos para verificar o nome exato.

Um subscritor pode pertencer a vários segmentos ao mesmo tempo? Sim. Pode adicionar um subscritor a quantos segmentos precisar. Quando envia uma campanha para um segmento, todos os subscritores atualmente atribuídos a esse segmento recebem-na.

Posso usar segmentos com Campanhas de Gatilho, não apenas com Transmissões Push? Sim. O direcionamento por segmento está disponível em Transmissões Push, Respondedores Automáticos de Gotejamento e Campanhas de Gatilho. A secção Público em cada tipo de campanha inclui a opção de direcionar por segmento.

Onde posso ver quais subscritores estão num segmento? Vá a Público » Segmentos no painel e clique no nome do segmento para ver os detalhes e contagens dos subscritores.

Se encontrar algum problema, n0o hesite em contactar-nos clicando aqui. A nossa equipa de suporte poder0 ajud0-lo.