Segmentos externos

Os segmentos externos permitem que você direcione pessoas já armazenadas em seu próprio banco de dados, como seu CRM ou data warehouse, em vez de exportá-las para um CSV e reenviá-lo toda vez que a lista mudar. Você fornece ao Pushwoosh uma consulta SQL que retorna os IDs de usuário corretos, e o Pushwoosh continua executando essa consulta para manter o segmento atualizado. Uma vez configurado, você pode usar esses usuários da mesma forma que qualquer outro segmento.

Assistência de desenvolvedor necessária

Você precisará da ajuda de seu desenvolvedor ou administrador de banco de dados para configurar a conexão. Compartilhe este guia com eles para começar.

A configuração de uma conexão afeta seu banco de dados de produção. Antes de começar, peça ao seu desenvolvedor ou administrador de banco de dados para:

• Preparar um usuário de somente leitura (ou, para o BigQuery, uma conta de serviço de somente leitura)
• Confirmar a consulta que você planeja usar
• Se o banco de dados estiver protegido por um firewall, pergunte ao suporte do Pushwoosh quais endereços IP permitir

Criar um segmento externo

Nomeie o segmento e escolha o banco de dados

1. Vá para Público → Segmentos Externos.
2. Clique em Criar segmento externo.

3. Insira um Nome para o segmento (até 100 caracteres).
4. Escolha o Tipo de banco de dados: PostgreSQL, MySQL, Google BigQuery ou Microsoft SQL Server / Fabric.

Preencha os campos de conexão

PostgreSQL e MySQL

Para PostgreSQL e MySQL, preencha:

• Host e Porta: o endereço do seu servidor de banco de dados. O Pushwoosh requer um host publicamente acessível e rejeita endereços privados, internos ou de loopback quando você verifica a conexão ou salva o segmento.
• Banco de dados: o nome do banco de dados.
• Usuário e Senha: credenciais para uma conta de somente leitura.
• Modo SSL (apenas PostgreSQL, já que as conexões MySQL não usam TLS) define como o SSL/TLS, o protocolo que criptografa a conexão, se aplica à sua conexão de banco de dados. Pergunte ao seu administrador de banco de dados qual modo usar:
  • Desativar: sem criptografia.
  • Exigir: criptografa a conexão, mas não verifica a identidade do servidor de banco de dados.
  • Verificar CA: criptografa a conexão e verifica se o certificado do servidor foi emitido por uma autoridade de certificação (CA) confiável.
  • Verificação completa: o mesmo que Verificar CA, e também verifica se o certificado corresponde ao nome do host do seu banco de dados. A opção mais forte.
• Para qualquer modo diferente de Desativar, forneça o certificado CA em Fonte do certificado (Carregar arquivos ou Colar PEM), além de um Certificado do cliente e Chave do cliente se o seu banco de dados os exigir.

BigQuery

Para Google BigQuery, preencha:

• ID do Projeto: o projeto GCP que contém seu conjunto de dados.
• JSON da conta de serviço: a chave para uma conta de serviço com acesso de leitura ao BigQuery.
• Localização: a região do conjunto de dados (por exemplo, EU, US ou europe-west3). Deixe em branco para resolver a localização automaticamente a partir do conjunto de dados.

SQL Server / Fabric

Para Microsoft SQL Server / Fabric, preencha:

• Host e Porta: o endereço do seu servidor de banco de dados ou seu endpoint de análise SQL do Fabric. O Pushwoosh requer um host publicamente acessível e rejeita endereços privados, internos ou de loopback quando você verifica a conexão ou salva o segmento.
• Banco de dados: o nome do banco de dados.
• Usuário e Senha: credenciais para uma conta de somente leitura.
• ID do locatário do Microsoft Entra: opcional. Deixe em branco para um login do SQL Server. Para o Microsoft Fabric, cujo endpoint de análise SQL não tem logins SQL, defina-o para fazer login como uma entidade de serviço. Insira seu ID de aplicativo (cliente) como Usuário e seu segredo de cliente como Senha.

Insira a consulta

1. Insira a Consulta. Ela deve retornar uma única coluna chamada user_id, com uma linha por usuário que você deseja no segmento. Por exemplo:

SELECT user_id FROM loyalty_members WHERE tier = 'gold'

Nota

Os valores de user_id devem corresponder aos User IDs do Pushwoosh que você definiu para seus usuários (o mesmo identificador usado por Criar segmentos por User ID). Uma consulta que retorna IDs que o Pushwoosh não reconhece não corresponderá a nenhum dispositivo.

2. Clique em Verificar conexão para confirmar que o Pushwoosh pode alcançar o banco de dados (expira após 30 segundos).
3. Clique em Verificar consulta para confirmar que a consulta é executada e retorna a coluna correta (também expira após 30 segundos).

Verifique e crie

Quando ambas as verificações forem bem-sucedidas, clique em Criar. O Pushwoosh salva o segmento e o adiciona à lista de Segmentos Externos imediatamente.

Como o segmento se mantém atualizado

O Pushwoosh não executa sua consulta em um cronograma fixo. Em vez disso, ele atualiza o segmento com base na última vez em que foi usado:

• Se os dados do segmento tiverem menos de uma hora, o Pushwoosh usa os dados atuais como estão.
• Se tiverem mais de uma hora, o Pushwoosh continua usando os dados atuais enquanto atualiza em segundo plano.
• Se tiverem mais de três horas, o Pushwoosh aguarda uma nova atualização antes de usar o segmento.

Na prática, isso significa que um segmento que você usa regularmente (por exemplo, em uma Journey recorrente) permanece atual, enquanto um segmento que você raramente toca pode levar um momento para ser atualizado na primeira vez que você o usar novamente.

Se uma atualização falhar (por exemplo, o banco de dados se tornar inacessível ou a consulta começar a dar erro), o Pushwoosh registra o erro, mas o status do segmento na lista de Segmentos Externos não muda por si só. Depois de corrigir o problema do seu lado, abra o segmento e clique em Verificar conexão para confirmar a correção. O erro é limpo automaticamente na próxima vez que os dados do segmento forem atualizados com sucesso.

Usar um segmento externo

Depois de criado, o segmento externo aparece automaticamente em Público → Segmentos com o mesmo nome, pronto para ser usado como qualquer outro segmento, por exemplo, como público de uma campanha ou Journey.

Para combiná-lo com outras condições, adicione-o como um filtro:

1. Vá para Público → Segmentos → Criar Segmento.
2. Clique em Adicionar filtro por → Segmento.
3. Selecione seu segmento externo pelo nome.

O mesmo filtro de Segmento está disponível em filtros compostos e quando você escolhe o público em Entrada baseada em público. Para mais informações sobre como combinar segmentos, veja Criar segmentos por segmentos existentes.

Verificar quantas pessoas estão no segmento

A lista de Segmentos Externos não mostra uma contagem de membros. Abra o invólucro do segmento em Público → Segmentos (veja Usar um segmento externo) e calcule seu tamanho lá.

Gerenciar segmentos externos

Na lista de Segmentos Externos, cada linha mostra o nome do segmento, Código (o identificador usado para referenciar o segmento em chamadas de API), tipo de banco de dados, host e status (válido ou inválido).

• Clique em Editar para alterar a conexão ou a consulta. O tipo de banco de dados não pode ser alterado após a criação. Em vez disso, crie um novo segmento.
• Clique em Excluir para remover um segmento. O Pushwoosh bloqueia a exclusão enquanto o segmento é usado por uma campanha, Journey, filtro ou formulário pop-up. Remova essas referências primeiro e, em seguida, exclua o segmento. Isso não pode ser desfeito.