Ana içeriğe atla

OneSignal Snowflake entegrasyon genel bakışı


Genel Bakış

OneSignal + Snowflake entegrasyonu iki güçlü veri hattını destekler:
  • Dışa Aktarma: OneSignal’den Snowflake’e analiz ve raporlama için mesajlaşma etkinlik verilerini (push, e-posta, SMS, uygulama içi) otomatik olarak gönderin.
  • İçe Aktarma: Otomatik Journey’leri tetiklemek ve kişiselleştirilmiş mesajlaşma yapmak için Snowflake veri kümelerinizden OneSignal’e özel kullanıcı etkinliklerini senkronize edin.
Bu entegrasyonlar birlikte, kullanıcı etkileşim verileri üzerinde tam kontrol sağlar—gelişmiş analizleri ve gerçek zamanlı davranış odaklı mesajlaşmayı güçlendirir.

OneSignal etkinliklerini Snowflake’e dışa aktarma

Şunları yapmak için mesajlaşma performansı ve etkileşim etkinliklerini (örn. gönderimler, açılmalar, tıklamalar) Snowflake’e gönderin:
  • Özel kontrol panelleri ve raporlar oluşturun
  • Kanallar arasında teslimat ve etkileşim eğilimlerini takip edin
  • Analiz için OneSignal verilerini diğer iş verileriyle birleştirin
Gereksinimler
  • OneSignal Professional Plan (ücretsiz uygulamalarda mevcut değildir).
  • Snowflake hesabı
  • Snowflake hesabınızın IMPORT SHARE ve CREATE DATABASE rollerine sahip olduğundan emin olun.
    • Paylaşımı kabul etmek için ACCOUNTADMIN rolünü kullanmanızı öneririz.
Kurulum Adımları

1. Kaydolun

Snowflake entegrasyonunu etkinleştirmek için, Message Events Data için OneSignal Marketplace listesi üzerinden erişim talep etmeniz gerekecek. Oradan, daha fazla bilgi almak için ekibinizle iletişime geçeceğiz.

2. Hesap Bilgilerini Sağlayın

Ekibinizle bağlantı kurduktan sonra, verileri sizinle paylaşabilmemiz için bize bazı ayrıntılar sağlamanız gerekecek. Snowflake Account ID’niz ve Snowflake Organization ID’nize ihtiyacımız olacak. Bu bilgiyi almanın en kolay yolu “Copy account identifier” düğmesine tıklamaktır (aşağıda gösterildiği gibi).
OneSignal Marketplace listesi üzerinden bizimle iletişimde olmalısınız. Ancak, hesap bilgilerini sağlama konusunda başka sorularınız varsa, snowflake-data-sharing@onesignal.com adresine e-posta gönderebilirsiniz.

Snowflake hesap tanımlayıcısını kopyalama

Programa kabul edildikten sonra, birkaç öğeye dikkat edin:
  • OneSignal’den sizi programa hoş geldiniz diyen e-posta
  • Snowflake’ten veri paylaşımının tamamlandığını bildiren e-posta

Snowflake veri paylaşımı bildirim e-postası

3. Snowflake içinde veri paylaşımını kabul edin

Snowflake’ten veri paylaşımının tamamlandığını bildiren bir e-posta aldıktan sonra, Snowflake uygulamasına giriş yapabilir ve veri paylaşımını kabul edebilirsiniz. DataPrivate Sharing’e gidin, burada yeni bir Privately Shared Listing görebilmelisiniz. Get’e tıkladığınızda, verileriniz bölgenize kopyalanmaya başlayacak.

Snowflake özel paylaşım arayüzü

Not: Get düğmesi mevcut değilse ancak bir Request düğmesi varsa, paylaşımı yapmaya çalışan rolün izinleri CREATE DATABASE veya IMPORT SHARE içermez. ACCOUNTADMIN rolüne geçmenizi öneririz. Verilerin kopyalanması biraz zaman alacaktır. Snowflake, veriler hazır olduğunda ek bir e-postayla takip edecek. Şuna benzer bir diyalog görmelisiniz

Veri kopyalama durum diyalogu

Veriler kullanıma hazır olduğunda, listelemenizde yeni bir Get düğmesi mevcut olmalıdır. Get düğmesine tıklayın ve yeni bir diyalogla karşılanacaksınız

Veritabanı yapılandırma diyalogu

Veritabanı ve veritabanı rollerinin adını tercih ettiğiniz bir şeye ayarlayın. Sonra Get’e tıklayın

Veri paylaşımı kurulum tamamlama

İşte bu kadar! Veriler artık OneSignal’den Snowflake’e senkronize ediliyor. Senkronizasyon sıklığı her 24 saatte bir olarak ayarlanmıştır, bu nedenle ilk veriler bir sonraki güne kadar kullanılabilir olmayabilir.

Etkinlikler ve Özellikler

Snowflake’s Marketplace’te mevcut verilere genel bakış

Mesaj Etkinlikleri Verileri

Daha fazla ayrıntı için Event Streams’e bakın. Bir kullanıcı tarafından oluşturulan her mesaj etkinliği için, aşağıdaki meta veriler kayda eklenecektir.
Sütun AdıTürAçıklamaÖrnek
event_idUUIDEtkinliği temsil eden benzersiz bir IDdc76df03-287c-403a-aabd-b2d4fe44e5c6
event_kindstringGerçekleşen etkinliğin türü. Etkinlik türlerinin listesi burada bulunabilir.message.email.opened
event_impression_timestampunix_timestampOneSignal’in etkinliği işlediği zaman1684951205
subscription_idUUIDCihazı/aboneliği temsil eden benzersiz bir ID6e8b6978-75a4-4882-878c-2d15a78c2409
subscription_languagestringBu aboneliğin dilien
subscription_timezoneintegerBu aboneliğin belirtilen saat dilimi-25200
subscription_device_typestringBu aboneliğin kullandığı cihaz türüSMS
onesignal_idUUIDİzlenimi yapan kullanıcının onesignal_id’sidc76df03-287c-403a-aabd-b2d4fe44e5c6
external_idstringİzlenimi yapan kullanıcının external_id’siMyExternalId
message_idUUIDMesajı temsil eden benzersiz bir IDdc76df03-287c-403a-aabd-b2d4fe44e5c6
message_namestringBildirim/Mesajın okunabilir id’siCampaign 1
message_titlestringBildirim/Mesajın Başlığı. Şu anda yalnızca İngilizceBonus 50 coins when you play!
message_bodystringMesajın Gövdesi. (Kısaltılmış) Şu anda yalnızca İngilizce.Play against your friends and earn an additional...

Mesaj Etkinlik Türleri

Daha fazla ayrıntı için Event Streams’e bakın. Mesaj Etkinlikleri, Snowflake’s Marketplace’te sunacağımız ilk veri kategorisidir. Ek veri kategorileri için herhangi bir talebiniz varsa lütfen snowflake-data-sharing@onesignal.com adresinden bize ulaşın!

Veri Saklama

OneSignal’den Snowflake aracılığıyla paylaşılan veriler 30 gün süreyle saklanır. Bu sürenin ötesinde veri koruması sağlamak için, ilgili verileri kendi tablolarınıza kopyalamanızı öneririz.

Snowflake’ten etkinlikleri içe aktarma

Şunları yapmak için Snowflake’ten OneSignal’e davranışsal etkinlik verilerini gönderin:
  • Kullanıcı etkinliğine dayalı Journey’leri tetikleyin
  • Davranışsal verilere dayalı mesajlaşmayı kişiselleştirin
Gereksinimler
  • Ambar erişimine sahip Snowflake hesabı
  • Snowflake tablolarında veya görünümlerinde saklanan Etkinlik verileri
  • OneSignal’den Snowflake örneğinize Ağ bağlantısı
  • Uygun izinlere sahip Kullanıcı kimlik bilgileri
Kurulum Adımları
1

OneSignal için özel rol oluşturun

Snowflake en iyi uygulamalarını izleyerek bir rol hiyerarşisi oluşturun:
-- Create a role for the census user
CREATE ROLE CENSUS_ROLE;

-- Ensure the sysadmin role inherits any privileges the census role is granted
GRANT ROLE CENSUS_ROLE TO ROLE SYSADMIN;
2

Özel ambar oluşturun

OneSignal operasyonları için maliyet optimize edilmiş bir ambar oluşturun:
-- Create a warehouse for the census role, optimizing for cost over performance
CREATE WAREHOUSE CENSUS_WAREHOUSE WITH
    WAREHOUSE_SIZE = XSMALL
    AUTO_SUSPEND = 60
    AUTO_RESUME = TRUE
    INITIALLY_SUSPENDED = FALSE;

GRANT USAGE ON WAREHOUSE CENSUS_WAREHOUSE TO ROLE CENSUS_ROLE;
GRANT OPERATE ON WAREHOUSE CENSUS_WAREHOUSE TO ROLE CENSUS_ROLE;
GRANT MONITOR ON WAREHOUSE CENSUS_WAREHOUSE TO ROLE CENSUS_ROLE;
3

Kullanıcı oluşturun ve izinleri verin

OneSignal kullanıcısını oluşturun ve etkinlik verilerinize erişim verin:
-- Create the census user
CREATE USER CENSUS WITH
    DEFAULT_ROLE = CENSUS_ROLE
    DEFAULT_WAREHOUSE = CENSUS_WAREHOUSE
    PASSWORD = '<strong-unique-password>';

GRANT ROLE CENSUS_ROLE TO USER CENSUS;

-- Grant access to your event data (replace with your actual database/schema)
GRANT USAGE ON DATABASE "<your-database>" TO ROLE CENSUS_ROLE;
GRANT USAGE ON SCHEMA "<your-database>"."<your-schema>" TO ROLE CENSUS_ROLE;
GRANT SELECT ON ALL TABLES IN SCHEMA "<your-database>"."<your-schema>" TO ROLE CENSUS_ROLE;
GRANT SELECT ON FUTURE TABLES IN SCHEMA "<your-database>"."<your-schema>" TO ROLE CENSUS_ROLE;
GRANT SELECT ON ALL VIEWS IN SCHEMA "<your-database>"."<your-schema>" TO ROLE CENSUS_ROLE;
GRANT SELECT ON FUTURE VIEWS IN SCHEMA "<your-database>"."<your-schema>" TO ROLE CENSUS_ROLE;
4

Kayıt tutma veritabanı oluşturun (Advanced Sync Engine)

OneSignal’in senkronizasyon durumu yönetimi için özel bir veritabanı oluşturun:
-- Create a private bookkeeping database
CREATE DATABASE "CENSUS";
GRANT ALL PRIVILEGES ON DATABASE "CENSUS" TO ROLE CENSUS_ROLE;

CREATE SCHEMA "CENSUS"."CENSUS";
GRANT ALL PRIVILEGES ON SCHEMA "CENSUS"."CENSUS" TO ROLE CENSUS_ROLE;
GRANT CREATE STAGE ON SCHEMA "CENSUS"."CENSUS" TO ROLE CENSUS_ROLE;
Basic Sync Engine veya salt okunur mod kullanıyorsanız bu adımı atlayın.
5

Kimlik doğrulamayı yapılandırın

Gelişmiş güvenlik için anahtar çifti kimlik doğrulamasını (önerilir) ayarlayın:
  1. Snowflake’in belgelerini izleyerek bir public/private anahtar çifti oluşturun
  2. Public anahtarı Snowflake kullanıcınızda yapılandırın
  3. OneSignal’in bağlantı ayarlarında private anahtarı kullanın
Alternatif olarak, şifre kimlik doğrulamasını kullanabilirsiniz (kullanımdan kaldırılmış - Kasım 2025’te engellenecek).
6

OneSignal'e bağlanın

In OneSignal, go to Data > Integrations and click Add Integration.Snowflake’i seçin ve aşağıdaki bağlantı ayrıntılarını sağlayın:
  • Account Name: Snowflake hesap tanımlayıcınız (örn. abc123.us-east-1)
  • Warehouse: CENSUS_WAREHOUSE
  • User: CENSUS
  • Database: Etkinlik veri veritabanı adınız
  • Schema: Etkinlik veri şema adınız
  • Authentication: Anahtar çifti (private anahtarı ve isteğe bağlı parolayı sağlayın)

Event data mapping

Map your to OneSignal’s custom events format:
OneSignal FieldDescriptionRequired
nameevent_nameEvent identifierYes
external_iduser_idUser identifierYes
timestampevent_timestampWhen event occurredNo
propertiesevent_dataNo

Örnek Etkinlik Tablo Şeması

-- Example Snowflake event table
CREATE TABLE analytics.user_events (
    event_id STRING,
    event_name STRING NOT NULL,
    user_id STRING NOT NULL,
    event_timestamp TIMESTAMP_TZ DEFAULT CURRENT_TIMESTAMP(),
    event_properties VARIANT,
    session_id STRING,
    device_type STRING
);

SQL Sorgu Modu

Etkinlik verilerinizi dönüştürmek için özel SQL sorguları yazın:
-- Example: Recent high-value events
SELECT
    event_name,
    user_id,
    event_timestamp,
    event_properties
FROM analytics.user_events
WHERE event_timestamp >= DATEADD(day, -7, CURRENT_TIMESTAMP())
    AND event_properties:value::NUMBER > 100
ORDER BY event_timestamp DESC;

Gelişmiş yapılandırma

Ambar Maliyetlerini Yönetme

  • Maliyet optimizasyonu için X-Small ambar boyutu kullanın
  • Otomatik askıya alma (60 saniye) ve otomatik devam ettirmeyi yapılandırın
  • Senkronizasyonları yoğun olmayan saatlerde programlayın
  • Ambarı diğer toplu işlem sistemleriyle paylaşmayı düşünün

Canlı Senkronizasyon Desteği

Gerçek zamanlı etkinlik işleme için, etkinlik tablolarınızda değişiklik takibini etkinleştirin:
ALTER TABLE "analytics"."user_events" SET CHANGE_TRACKING = TRUE;

Ağ Güvenliği

Snowflake’in Allowed IPs ağ politikasını kullanıyorsanız, OneSignal’in IP adreslerini izin listenize ekleyin. Mevcut IP aralıkları için OneSignal desteğiyle iletişime geçin.

Sınırlamalar

  • Karmaşık analitik sorgular ambar performansını ve maliyetlerini etkileyebilir
  • Kullanıcı/Şifre kimlik doğrulaması Kasım 2025’te kullanımdan kaldırılacak
  • CENSUS veritabanı yalnızca OneSignal operasyonları için ayrılmıştır

OneSignal ile veri paylaşımını kesme

OneSignal ile veri paylaşımınızı devre dışı bırakma talebinde bulunmak için lütfen bize snowflake-data-sharing@onesignal.com adresinden e-posta gönderin.

SSS

Hangi kimlik doğrulama yöntemini kullanmalıyım?

Anahtar çifti kimlik doğrulaması’nı kullanın (önerilir). Kullanıcı/Şifre kimlik doğrulaması Kasım 2025’ten itibaren Snowflake tarafından engellenecek.

Mevcut bir ambarı kullanabilir miyim?

Evet, maliyetleri optimize etmek için bir ambarı dbt veya Fivetran gibi diğer toplu işlem sistemleriyle paylaşabilirsiniz. Ambarın etkinlik işleme ihtiyaçlarınız için yeterli kapasiteye sahip olduğundan emin olun.

Maliyetleri nasıl optimize edebilirim?

  • X-Small ambar boyutu kullanın
  • Agresif otomatik askıya alma (60 saniye) yapılandırın
  • Senkronizasyonları yoğun olmayan saatlerde programlayın
  • Sürekli senkronizasyon yerine saatlik/günlük senkronizasyonları kullanın