Ana içeriğe atla

​
Genel bakış

OneSignal + Google AlloyDB entegrasyonu, AlloyDB veritabanınızdan özel olayların doğrudan OneSignal’in Custom Events API’sine otomatik senkronizasyonunu sağlar. Bu, veritabanınızda saklanan gerçek kullanıcı davranışına dayalı otomatik Journey’leri ve kişiselleştirilmiş mesajlaşma kampanyalarını tetiklemenize olanak tanır. Satın almalar, ürün görüntülemeleri, abonelik değişiklikleri veya herhangi bir özel kullanıcı eylemi gibi olayları senkronize ederek push bildirimleri, e-posta, uygulama içi mesajlar ve SMS’te onboarding dizilerini, yeniden etkileşim kampanyalarını, işlemsel mesajları ve hedeflenmiş promosyonları otomatik olarak tetikleyebilirsiniz.

​
Gereksinimler

​
Google AlloyDB

  • AlloyDB instance’ına sahip Google Cloud Platform hesabı
  • Google Cloud tarafından gerektiği şekilde yapılandırılmış Auth Proxy
  • Kullanıcı oluşturmak ve erişim vermek için veritabanı izinleri
  • AlloyDB instance’ınıza ağ erişimi

​
Kurulum

​
AlloyDB izinlerini yapılandırma

OneSignal’in AlloyDB veritabanınızdan olay verilerini okuması gerekir. Olay tablolarınıza yalnızca okuma erişimi olan özel bir ONESIGNAL kullanıcı hesabı oluşturmanızı öneririz.
1

OneSignal veritabanı kullanıcısı oluştur

Güçlü, benzersiz bir şifre ile özel bir kullanıcı hesabı oluşturun:
-- OneSignal kullanıcısını oluştur
CREATE USER ONESIGNAL WITH PASSWORD '<güçlü, benzersiz şifre>';
2

Şema erişimi ver

OneSignal kullanıcısına olay veri şemanızdan okuma erişimi verin:
-- OneSignal kullanıcısının olay şemanızı görmesine izin ver
GRANT USAGE ON SCHEMA "<olay_şemanız>" TO ONESIGNAL;

-- OneSignal kullanıcısının bu şemadaki tüm mevcut tabloları okumasına izin ver
GRANT SELECT ON ALL TABLES IN SCHEMA "<olay_şemanız>" TO ONESIGNAL;

-- OneSignal kullanıcısının bu şemaya eklenen yeni tabloları okumasına izin ver
ALTER DEFAULT PRIVILEGES IN SCHEMA "<olay_şemanız>" GRANT SELECT ON TABLES TO ONESIGNAL;
<olay_şemanız>’ı olay tablolarınızı içeren gerçek şema ile değiştirin.
3

Fonksiyon izinleri ver (gerekirse)

Olay verileri için saklı prosedürler veya fonksiyonlar kullanıyorsanız:
-- OneSignal kullanıcısının bu şemadaki fonksiyonları çalıştırmasına izin ver
GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA "<olay_şemanız>" TO ONESIGNAL;

-- OneSignal kullanıcısının bu şemaya eklenen yeni fonksiyonları çalıştırmasına izin ver
ALTER DEFAULT PRIVILEGES IN SCHEMA "<olay_şemanız>" GRANT EXECUTE ON FUNCTIONS TO ONESIGNAL;

​
Auth Proxy’yi kurma

1

Auth Proxy'yi yapılandır

AlloyDB, üçüncü taraf bağlantılar için bir Auth Proxy gerektirir. Bunu kurmak için Google’ın Auth Proxy belgelerine bakın.
Auth Proxy gereklidir - OneSignal, onsuz AlloyDB’ye doğrudan bağlanamaz.
2

Bağlantı detaylarını not et

Aşağıdaki bağlantı bilgilerini kaydedin:
  • Host: Auth Proxy endpoint’i
  • Port: Auth Proxy portu (tipik olarak 5432)
  • Veritabanı: AlloyDB veritabanı adınız
  • Kullanıcı adı: ONESIGNAL (yukarıda oluşturuldu)
  • Şifre: Belirlediğiniz şifre

​
OneSignal AlloyDB bağlantısını yapılandırma

1

Entegrasyonlara git

In OneSignal, go to Data > Integrations and click Add Integration.
2

Google AlloyDB'yi seç

Mevcut entegrasyonlar listesinden Google AlloyDB’yi seçin.
3

Bağlantı detaylarını gir

AlloyDB bağlantı bilgilerini sağlayın:
  • Host: Auth Proxy endpoint’iniz
  • Port: Auth Proxy portu
  • Veritabanı: AlloyDB veritabanı adı
  • Kullanıcı adı: ONESIGNAL
  • Şifre: Kullanıcı şifresi
  • SSL: Etkin (önerilir)
4

Bağlantıyı test et

OneSignal’in AlloyDB instance’ınıza erişebildiğini doğrulamak için Bağlantıyı Test Et’e tıklayın.

​
Olay Veri Eşleştirmesi

Bağlandıktan sonra, AlloyDB tablo sütunlarınızı OneSignal özel olay alanlarına eşleştirmeniz gerekecek:
1

Olay tablolarını seç

OneSignal’e senkronize etmek istediğiniz olay verilerinizi içeren tabloları seçin.
2

Gerekli olay alanlarını eşleştir

Özel olaylar için gerekli alanları eşleştirin:
  • Olay Adı: Olay türünü içeren sütun (örneğin, “purchase”, “signup”)
  • Kullanıcı Tanımlayıcısı: External User ID, E-posta veya Telefon Numarası sütunu
  • Olay Zaman Damgası: Olayın ne zaman gerçekleştiği (isteğe bağlı)
3

Olay payload verilerini eşleştir

Ek sütunları olay payload özelliklerine eşleştirin:
  • Özel olay özellikleri (product_id, price, category, vb.)
  • Bağlamsal veri (source, campaign, vb.)
  • Davranışsal metrikler (value, quantity, vb.)
4

Senkronizasyon ayarlarını yapılandır

Olay işleme sıklığınızı ve teslimat tercihlerinizi ayarlayı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

​
Gelişmiş Ağ Yapılandırması

​
IP Adresi İzin Listeleri

AlloyDB instance’ınız IP izin listeleri kullanıyorsa, OneSignal’in IP adreslerini ekleyin. Mevcut IP aralıklarını OneSignal dashboard’unuzda Veri > Entegrasyonlar > Ağ Erişimi altında bulabilirsiniz.

​
SSH Tünelleme

OneSignal, ek güvenlik için SSH tünelleri üzerinden AlloyDB’ye bağlanmayı destekler:
1

SSH kullanıcısı oluştur

SSH host sunucunuzda OneSignal için özel bir kullanıcı hesabı oluşturun.
2

SSH tünelini yapılandır

OneSignal AlloyDB bağlantı ayarlarında, SSH Tüneli Kullan’ı etkinleştirin ve şunları sağlayın:
  • SSH Host
  • SSH Portu
  • SSH Kullanıcı Adı
3

SSH anahtarı ekle

OneSignal bir SSH anahtar çifti oluşturacaktır. Public key’i OneSignal kullanıcısı için SSH host’unuzun authorized_keys dosyasına kopyalayın.

​
Sınırlamalar

  • Performans: Yoğun kullanım sırasında production veritabanlarına bağlanmaktan kaçının
  • İzinler: OneSignal, olay tablolarına yalnızca okuma erişimi gerektirir
  • Auth Proxy: Tüm AlloyDB bağlantıları için gereklidir

​
SSS

​
Olay tablo yapım değişirse ne olur?

OneSignal şema değişikliklerini algılayacak ve alanların yeniden eşleştirilmesini gerektirebilir. Entegrasyon ayarlarında alan eşleştirmelerinizi güncelleyin.

​
OneSignal olayları ne sıklıkla senkronize eder?

OneSignal, yapılandırılmış senkronizasyon sıklığınıza göre yeni olayları kontrol eder, minimum aralık 15 dakikadır.

​
Yardım mı gerekiyor?

AlloyDB entegrasyon kurulumunuzla ilgili yardım için support@onesignal.com adresinden destek ekibimizle iletişime geçin veya uygulama içi sohbeti kullanın.