Genel bakış
OneSignal + PostgreSQL entegrasyonu, kullanıcı davranışına dayalı otomatik mesajlaşma kampanyaları ve Journey’leri tetiklemek için PostgreSQL veritabanınızdan OneSignal’e özel olayların senkronize edilmesini sağlar.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)
PostgreSQL
- PostgreSQL 9.6+ veya uyumlu veritabanı
- Uygun izinlere sahip Veritabanı kullanıcısı
- OneSignal’den PostgreSQL örneğinize Ağ erişimi
- Yapılandırılmış davranışsal veri içeren Olay tabloları
OneSignal’i bir production PostgreSQL veritabanına bağlamaktan şiddetle kaçınmanızı öneririz. Olay senkronizasyon sorguları doğası gereği analitiktir ve production performansını etkileyebilir. Yalnızca analitik iş yükleri için kurulmuş veritabanlarıyla kullanın.
Kurulum
1
OneSignal için özel kullanıcı oluştur
Uygun izinlere sahip özel bir kullanıcı hesabı oluşturun:
2
Olay verisine izinler ver
Olay verinizi içeren şemalara okuma erişimi sağlayın:
3
OneSignal'e bağlan
In OneSignal, go to Data > Integrations and click Add Integration.
- Listeden PostgreSQL’i seçin
- Bağlantı ayrıntılarınızı girin:
- Host: PostgreSQL sunucu hostname’iniz
- Port: Genellikle 5432
- Database: Veritabanı adınız
- Username:
CENSUS - Password: Oluşturduğunuz şifre
- Bağlantıyı test edin
- Hangi tabloların olay verinizi içerdiğini yapılandırın
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ı
SQL Sorgu Modu
Olay verinizi dönüştürmek için özel SQL sorguları yazın:Gelişmiş Ağ Yapılandırması
OneSignal, gelişmiş ağ kontrolleri kullanarak PostgreSQL örneklerine bağlanabilir:- IP İzin Listeleri: OneSignal’in IP adreslerini güvenlik duvarınıza ve
pg_hba.conf’a ekleyin - SSH Tünelleme: Özel ağlar için bir bastion host üzerinden bağlanın
- VPC Yapılandırması: Bulut ortamları içinde doğrudan bağlantı
- TLS Şifreleme: SSL/TLS kullanarak güvenli bağlantılar
SSH Tüneli Kurulumu
Özel ağlardaki PostgreSQL örnekleri için:- SSH kullanıcısı oluştur: SSH host’unuzda özel bir kullanıcı kurun
- Tüneli yapılandır: OneSignal entegrasyon ayarlarında “Use SSH Tunnel“‘ı etkinleştirin
- Anahtar çiftini yükle: OneSignal’in genel anahtarını
~/.ssh/authorized_keys’e ekleyin - Bağlantıyı test et: Tünel bağlantısını doğrulayın
Notlar
- Birden Fazla Şema: Olay verisi içeren her şema için izin verme işlemlerini tekrarlayın
- Çapraz Şema Referansları ile Görünümler: Eski PostgreSQL sürümlerinde ek okuma izinleri gerektirebilir
- Azure PostgreSQL: Azure örnekleri için
username@hostnameformatını kullanın - AWS RDS: Standart
usernameformatını kullanın - Performans: Büyük ölçekli olay işleme için okuma replikalarını kullanmayı düşünün
Sınırlamalar
- Analitik sorgu yükü nedeniyle production veritabanlarına bağlanmaktan kaçının
- Karmaşık çapraz şema sorguları ek izinler gerektirebilir
- Yüksek frekanslı olay işleme için bağlantı havuzu önerilir