Pular para o conteúdo principal

​
Visão geral

A integração OneSignal + Microsoft Fabric permite sincronização automática de eventos personalizados do seu lakehouse ou warehouse Fabric para o OneSignal para acionar campanhas de mensagens automatizadas e Journeys com base no comportamento do usuário. Microsoft Fabric é uma plataforma de análise unificada que reúne engenharia de dados, ciência de dados, análise em tempo real e inteligência de negócios em um único ambiente.

​
Requisitos

  • Acesso a Event Streams para eventos de mensagem de saída (Limitações de plano e excedentes se aplicam)
  • Acesso a Custom Events para sincronização de eventos de entrada (Limitações de plano e excedentes se aplicam)
  • Plano de Conta Atualizado (não disponível em apps gratuitos)

​
Microsoft Fabric

  • Capacidade Microsoft Fabric com acesso ao workspace
  • Service Principal com permissões apropriadas
  • SQL Endpoint (Warehouse ou Lakehouse) contendo dados de eventos
  • Acesso a API externa habilitado nas configurações do tenant

​
Configuração

1

Criar service principal no Azure

Crie um novo service principal para o OneSignal acessar seus recursos Fabric:
  1. Faça login no portal do Azure
  2. Navegue até Microsoft Entra ID > App registrations
  3. Clique em + New registration
  4. Insira o nome: “OneSignal Fabric Integration”
  5. Selecione Accounts in this organizational directory only
  6. Clique em Register
  7. Anote o Application (client) ID e Directory (tenant) ID
  8. Em Certificates & secrets, crie um novo client secret
  9. Anote o client secret value
2

Configurar configurações do tenant Fabric

Habilite acesso externo para service principals:
  1. No Microsoft Fabric, clique em Settings > Admin portal
  2. Vá para Tenant settings
  3. Em Developer settings, habilite Service principals can use Fabric APIs
  4. Em OneLake settings, habilite Users can access data stored in OneLake with apps external to Fabric
3

Conceder acesso ao workspace

Adicione o service principal ao seu workspace Fabric:
  1. Navegue até seu workspace (crie workspace compartilhado se estiver usando “My Workspace”)
  2. Clique em Manage Access > + Add people or groups
  3. Selecione seu service principal
  4. Defina a função como Contributor
4

Obter SQL endpoint

Obtenha a string de conexão SQL para sua fonte de dados:
  1. No seu workspace, passe o mouse sobre seu warehouse/lakehouse
  2. Clique em … > Settings
  3. Copie a SQL connection string (este é seu hostname)
5

Conectar ao OneSignal

No OneSignal, vá para Data > Integrations e clique em Add Integration.Selecione Microsoft Fabric e forneça:
  • Hostname: SQL endpoint do Passo 4
  • Database/Catalog: Seu nome de lakehouse ou warehouse
  • Tenant ID: Directory ID do Passo 1
  • Client ID: Application ID do Passo 1
  • Client Secret: Secret value do Passo 1

​
Mapeamento de dados de evento

Mapeie seu para o formato de eventos personalizados do OneSignal:
Campo OneSignalDescriçãoObrigatório
nameevent_nameIdentificador de eventoSim
external_iduser_idIdentificador de usuárioSim
timestampevent_timestampQuando o evento ocorreuNão
propertiesevent_dataNão

​
Esquema de Tabela de Evento de Exemplo

-- Example Fabric table structure
CREATE TABLE user_events (
    event_name STRING,
    user_id STRING,
    event_time TIMESTAMP,
    properties JSON,
    session_id STRING,
    device_type STRING
);

​
Modos de Processamento

​
Modo de Consulta SQL

Escreva consultas SQL personalizadas para transformar seus dados Fabric antes de sincronizar: 
SELECT
    event_name,
    user_id,
    event_time,
    TO_JSON(STRUCT(
        session_id,
        device_type,
        product_id
    )) as properties
FROM user_events
WHERE event_time >= CURRENT_DATE - INTERVAL 7 DAYS

​
Modo de Tabela

Sincronize tabelas ou visualizações inteiras diretamente do seu workspace Fabric. O OneSignal mapeará automaticamente as colunas para campos de evento.

​
Limitações

  • Requer capacidade Fabric (não disponível em trial)
  • SQL endpoints devem ser acessíveis a serviços externos
  • Grandes conjuntos de resultados podem impactar o desempenho de sincronização

​
FAQ

​
Como otimizo o desempenho de consulta?

Use particionamento e indexação em suas tabelas Fabric. Considere criar visualizações materializadas para dados de eventos acessados com frequência.

​
Posso sincronizar de lakehouses e warehouses?

Sim, o OneSignal suporta qualquer recurso Fabric que exponha um SQL endpoint, incluindo lakehouses, warehouses e SQL analytics endpoints.