> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AlloyDB

> Kullanıcı davranışına dayalı otomatik Journey'ler ve kişiselleştirilmiş mesajlaşma kampanyaları tetiklemek için Google AlloyDB'den OneSignal'e özel olayları senkronize edin.

export const PLATFORM_0 = "AlloyDB"

export const DATA_TYPE_0 = "tablo sütunları"

export const COLUMN_HEADER_0 = "AlloyDB Sütunu"

export const PROPERTIES_DESCRIPTION_0 = "JSON nesnesi olarak olay meta verileri"

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

* Access to [Event Streams](/docs/en/event-streams) for outbound message events (Plan limitations and overages apply)
* Access to [Custom Events](/docs/en/custom-events) for inbound event syncing (Plan limitations and overages apply)
* [Updated Account Plan](https://onesignal.com/pricing) (not available on free apps)

### 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.

<Steps>
  <Step title="OneSignal veritabanı kullanıcısı oluştur">
    Güçlü, benzersiz bir şifre ile özel bir kullanıcı hesabı oluşturun:

    ```sql theme={null}
    -- OneSignal kullanıcısını oluştur
    CREATE USER ONESIGNAL WITH PASSWORD '<güçlü, benzersiz şifre>';
    ```
  </Step>

  <Step title="Şema erişimi ver">
    OneSignal kullanıcısına olay veri şemanızdan okuma erişimi verin:

    ```sql theme={null}
    -- 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;
    ```

    <Info>
      `<olay_şemanız>`'ı olay tablolarınızı içeren gerçek şema ile değiştirin.
    </Info>
  </Step>

  <Step title="Fonksiyon izinleri ver (gerekirse)">
    Olay verileri için saklı prosedürler veya fonksiyonlar kullanıyorsanız:

    ```sql theme={null}
    -- 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;
    ```
  </Step>
</Steps>

### Auth Proxy'yi kurma

<Steps>
  <Step title="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](https://cloud.google.com/alloydb/docs/auth-proxy/overview) bakın.

    <Warning>
      Auth Proxy gereklidir - OneSignal, onsuz AlloyDB'ye doğrudan bağlanamaz.
    </Warning>
  </Step>

  <Step title="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
  </Step>
</Steps>

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

<Steps>
  <Step title="Entegrasyonlara git">
    In OneSignal, go to **Data > Integrations** and click **Add Integration**.
  </Step>

  <Step title="Google AlloyDB'yi seç">
    Mevcut entegrasyonlar listesinden **Google AlloyDB**'yi seçin.
  </Step>

  <Step title="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)
  </Step>

  <Step title="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.
  </Step>
</Steps>

***

## Olay Veri Eşleştirmesi

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

<Steps>
  <Step title="Olay tablolarını seç">
    OneSignal'e senkronize etmek istediğiniz olay verilerinizi içeren tabloları seçin.
  </Step>

  <Step title="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ı)
  </Step>

  <Step title="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.)
  </Step>

  <Step title="Senkronizasyon ayarlarını yapılandır">
    Olay işleme sıklığınızı ve teslimat tercihlerinizi ayarlayın.
  </Step>
</Steps>

***

### Event data mapping

Map your {PLATFORM_0} {DATA_TYPE_0} to OneSignal's custom events format:

| OneSignal Field | {COLUMN_HEADER_0} | 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`      | {PROPERTIES_DESCRIPTION_0} | No       |

***

## 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:

<Steps>
  <Step title="SSH kullanıcısı oluştur">
    SSH host sunucunuzda OneSignal için özel bir kullanıcı hesabı oluşturun.
  </Step>

  <Step title="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ı
  </Step>

  <Step title="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.
  </Step>
</Steps>

***

## 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.