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ı
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