Microsoft Fabric

Genel bakış

OneSignal + Microsoft Fabric entegrasyonu, kullanıcı davranışına dayalı otomatik mesajlaşma kampanyalarını ve Journey’leri tetiklemek için Fabric lakehouse veya warehouse’unuzdan OneSignal’e özel olayların otomatik senkronizasyonunu sağlar. Microsoft Fabric, veri mühendisliği, veri bilimi, gerçek zamanlı analitik ve iş zekasını tek bir ortamda bir araya getiren birleşik bir analitik platformudur.

Gereksinimler

Access to Event Streams for outbound message events (Plan limitations and overages apply)
Access to Custom Events for inbound event syncing (Plan limitations and overages apply)
Updated Account Plan (not available on free apps)

Çalışma alanı erişimi olan Microsoft Fabric kapasitesi
Uygun izinlere sahip Service Principal
Olay verileri içeren SQL Endpoint (Warehouse veya Lakehouse)
Kiracı ayarlarında etkinleştirilmiş Harici API erişimi

Kurulum

Azure'da service principal oluşturun

OneSignal’in Fabric kaynaklarınıza erişmesi için yeni bir service principal oluşturun:

Azure portalında oturum açın
Microsoft Entra ID > App registrations’a gidin
+ New registration’a tıklayın
Adı girin: “OneSignal Fabric Integration”
Accounts in this organizational directory only’yi seçin
Register’a tıklayın
Application (client) ID ve Directory (tenant) ID’yi not edin
Certificates & secrets altında yeni bir client secret oluşturun
Client secret value’yu not edin

Fabric kiracı ayarlarını yapılandırın

Service principal’lar için harici erişimi etkinleştirin:

Microsoft Fabric’te Settings > Admin portal’a tıklayın
Tenant settings’e gidin
Developer settings altında Service principals can use Fabric APIs’yi etkinleştirin
OneLake settings altında Users can access data stored in OneLake with apps external to Fabric’i etkinleştirin

Çalışma alanı erişimi verin

Service principal’ı Fabric çalışma alanınıza ekleyin:

Çalışma alanınıza gidin (“My Workspace” kullanıyorsanız paylaşılan çalışma alanı oluşturun)
Manage Access > + Add people or groups’a tıklayın
Service principal’ınızı seçin
Rolü Contributor olarak ayarlayın

SQL endpoint'ini alın

Veri kaynağınız için SQL bağlantı dizesini edinin:

Çalışma alanınızda warehouse/lakehouse’unuzun üzerine gelin
… > Settings’e tıklayın
SQL connection string’i kopyalayın (bu sizin hostname’inizdir)

OneSignal'e bağlanın

In OneSignal, go to Data > Integrations and click Add Integration.Microsoft Fabric’i seçin ve şunları sağlayın:

Hostname: Adım 4’ten SQL endpoint
Database/Catalog: Lakehouse veya warehouse adınız
Tenant ID: Adım 1’den Directory ID
Client ID: Adım 1’den Application ID
Client Secret: Adım 1’den Secret value

Event data mapping

Map your to OneSignal’s custom events format:

OneSignal Field	Description	Required
`name`	`event_name`	Event identifier	Yes
`external_id`	`user_id`	User identifier	Yes
`timestamp`	`event_timestamp`	When event occurred	No
`properties`	`event_data`	No

Örnek Olay Tablosu Şeması

-- Örnek Fabric tablo yapısı
CREATE TABLE user_events (
    event_name STRING,
    user_id STRING,
    event_time TIMESTAMP,
    properties JSON,
    session_id STRING,
    device_type STRING
);

İşleme Modları

SQL Sorgu Modu

Senkronize etmeden önce Fabric verilerinizi dönüştürmek için özel SQL sorguları yazın:

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

Tablo Modu

Fabric çalışma alanınızdan doğrudan tüm tabloları veya görünümleri senkronize edin. OneSignal, sütunları olay alanlarına otomatik olarak eşleyecektir.

Sınırlamalar

Fabric kapasitesi gerektirir (denemede mevcut değildir)
SQL endpoint’leri harici hizmetler tarafından erişilebilir olmalıdır
Büyük sonuç kümeleri senkronizasyon performansını etkileyebilir

SSS

Sorgu performansını nasıl optimize ederim?

Fabric tablolarınızda bölümleme ve indeksleme kullanın. Sık erişilen olay verileri için materyalize edilmiş görünümler oluşturmayı düşünün.

Hem lakehouse’lardan hem de warehouse’lardan senkronize edebilir miyim?

Evet, OneSignal lakehouse’lar, warehouse’lar ve SQL analitik endpoint’leri dahil olmak üzere SQL endpoint’i açığa çıkaran herhangi bir Fabric kaynağını destekler.

İlk adımlar & ayarlar

Mesaj kanalları

Journey'ler

Hedeflenen & özel olaylar

Analitik ve Entegrasyonlar

Gizlilik & Güvenlik

Microsoft Fabric

Genel bakış

Gereksinimler