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

# Google Sheets

> Kullanıcı davranışına dayalı otomatik Journeys'leri ve kişiselleştirilmiş mesajlaşma kampanyalarını tetiklemek için Google Sheets'ten OneSignal'e özel olayları senkronize edin.

export const PLATFORM_0 = "Google Sheets"

export const DATA_TYPE_0 = "columns"

export const COLUMN_HEADER_0 = "Sheets Column Examples"

export const PROPERTIES_DESCRIPTION_0 = "Multiple columns combined into JSON"

## Genel Bakış

OneSignal + Google Sheets entegrasyonu, Google Sheets'teki özel olayların OneSignal'e otomatik olarak senkronize edilmesini sağlar. Bu, elektronik tablolarınızda saklanan kullanıcı davranışsal verilerine dayalı otomatik Journey'leri ve kişiselleştirilmiş mesajlaşma kampanyalarını tetiklemenize olanak tanır; olay verilerini işbirliği içinde yöneten ekipler için mükemmeldir.

***

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

* Olay verilerini içeren sayfaya erişimi olan **Google Hesabı**
* Olay verileri için uygun sütun yapısına sahip **Olay elektronik tablosu**
* OneSignal'in verilere erişmesi için **Sayfa paylaşım izinleri**
* Olay izleme sayfanızda **Tutarlı veri formatı**

***

## Kurulum

<Steps>
  <Step title="Olay veri sayfanızı hazırlayın">
    Google Sheet'inizi olay verileri için gerekli sütunlarla yapılandırın:

    **Gerekli sütunlar:**

    * `event_name` veya `event_type`: Olayın adı (String)
    * `user_id` veya `email`: Kullanıcı tanımlayıcısı (String)
    * `timestamp` veya `created_at`: Olay zaman damgası (Date/DateTime)
    * `properties`: JSON veya ayrı sütunlar olarak olay özellikleri (İsteğe bağlı)

    **Örnek sayfa yapısı:**

    ```
    | event_name | user_id | timestamp           | product_id | amount |
    |------------|---------|---------------------|------------|--------|
    | purchase   | user123 | 2024-01-15 10:30:00 | prod_abc   | 29.99  |
    | signup     | user456 | 2024-01-15 11:45:00 |            |        |
    ```
  </Step>

  <Step title="Sayfa izinlerini yapılandırın">
    Google Sheet'inizi OneSignal'in servis hesabıyla paylaşın:

    1. Google Sheet'inizi açın
    2. Sağ üstteki **Share** düğmesine tıklayın
    3. OneSignal'in servis hesabı e-postasını ekleyin (kurulum sırasında sağlanır)
    4. İzinleri **Viewer** (salt okunur erişim) olarak ayarlayın
    5. Erişim vermek için **Send**'e tıklayın

    <Info>
      OneSignal, entegrasyon kurulum işlemi sırasında özel servis hesabı e-postasını sağlayacaktır.
    </Info>
  </Step>

  <Step title="OneSignal'de entegrasyon ekleyin">
    In OneSignal, go to **Data > Integrations** and click **Add Integration**.

    **Google Sheets**'i seçin ve şunları sağlayın:

    * **Sheet URL**: Google Sheet'inizin tam URL'si
    * **Sheet Name**: Olay verilerini içeren belirli sekme/sayfa adı
    * **Header Row**: Sütun başlıklarını içeren satır numarası (genellikle 1)
    * **Data Range**: Olay verilerinizi içeren hücre aralığı (örn. `A2:F1000`)
  </Step>

  <Step title="Sütun eşlemesini yapılandırın">
    Google Sheets sütunlarınızı OneSignal olay alanlarına eşleyin:

    * **Event Name Column**: Olay adlarını içeren sütunu seçin
    * **User ID Column**: Kullanıcı tanımlayıcılarını içeren sütunu seçin
    * **Timestamp Column**: Olay zaman damgalarını içeren sütunu seçin
    * **Properties Columns**: Olay özellikleri olarak dahil edilecek ek sütunları seçin

    <Info>
      Birden fazla sütunu olay özellikleri olarak eşleyebilirsiniz. OneSignal bunları tek bir olay yüküne birleştirecektir.
    </Info>
  </Step>

  <Step title="Senkronizasyon programını ayarlayın">
    OneSignal'in yeni olay verilerini ne sıklıkla kontrol etmesi gerektiğini yapılandırın:

    * **Sync Frequency**: 15 dakika, saatlik veya günlük arasından seçim yapın
    * **Incremental Sync**: Son güncellemeden bu yana yalnızca yeni satırları senkronize etmek için etkinleştirin
    * **Timestamp Filter**: Yalnızca belirli bir zaman aralığındaki olayları senkronize edin

    <Warning>
      Google Sheets'in API hız limitleri vardır. Büyük veri kümeleri olan sayfalar için daha sık senkronizasyon kısıtlanabilir.
    </Warning>
  </Step>

  <Step title="Bağlantıyı test edin">
    OneSignal'in Google Sheet'inize erişebildiğini ve olay verilerini doğru şekilde okuyabildiğini doğrulamak için **Test Connection**'a tıklayı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ş Yapılandırma

### Artımlı Senkronizasyon Kurulumu

Yalnızca yeni olayları işlemek için artımlı senkronizasyonu yapılandırın:

1. **Timestamp Column**: Sayfanızın tutarlı bir zaman damgası sütununa sahip olduğundan emin olun
2. **Sort Order**: Olayları zaman damgasına göre sıralanmış tutun (en yeni son)
3. **Append-Only**: Yeni olayları sayfanızın altına ekleyin
4. **Avoid Edits**: Senkronize edildikten sonra geçmiş olay satırlarını değiştirmeyin

### Veri Doğrulama

Google Sheet'inizde veri doğrulamayı uygulayın:

```
Data > Data validation
- Event Name: List from range (önceden tanımlanmış olay türleri)
- User ID: Formatı kontrol etmek için özel formül
- Timestamp: Date/Time format doğrulaması
- Amount: Sayısal özellikler için sayı doğrulaması
```

### İşbirliği İş Akışları

Ekip işbirliği için en iyi uygulamalar:

* **Named Ranges**: Olay veri bölümleri için adlandırılmış aralıklar kullanın
* **Protected Ranges**: Başlık satırlarını kazara değişikliklerden koruyun
* **Comments**: Olay tanımlarını açıklamak için yorumlar ekleyin
* **Version History**: Değişiklikleri izlemek için Google Sheets'in sürüm geçmişini kullanın
* **Access Controls**: Veri girişi ekip üyelerine düzenleme erişimini sınırlayın

### Performans Optimizasyonu

Büyük veri kümeleri için optimize edin:

* **Sheet Limits**: En iyi performans için tek tek sayfaları 10.000 satırın altında tutun
* **Multiple Sheets**: Farklı olay türleri için ayrı sayfalar kullanın
* **Data Archival**: Eski verileri aylık olarak ayrı sayfalara arşivleyin
* **Formulas**: Olay veri aralıklarındaki karmaşık formülleri en aza indirin

<Warning>
  Google Sheets, toplam 50.000 hücrenin altında en iyi performansı gösterir. Yüksek hacimli olay izleme için bunun yerine bir veritabanı kaynağı kullanmayı düşünün.
</Warning>

***

## SSS

### OneSignal, Google Sheets'ten olayları ne sıklıkla senkronize eder?

OneSignal her 15 dakikada bir sıklıkta senkronize edebilir, ancak Google'ın API limitlerini dikkate almak için çoğu kullanım durumu için saatlik veya günlük senkronizasyonu öneriyoruz.

### Birden fazla ekip üyesi aynı sayfaya olay ekleyebilir mi?

Evet, Google Sheets gerçek zamanlı işbirliğini destekler. Ancak, ekip üyelerinin gerekli veri formatını ve sütun yapısını anladığından emin olun.

### Biri geçmiş olay verilerini düzenlerse ne olur?

OneSignal, zaman damgalarına ve satır konumlarına göre senkronize eder. Geçmiş verilerin düzenlenmesi, yinelenen olaylara veya veri tutarsızlıklarına neden olabilir. Yalnızca ekleme iş akışlarını öneriyoruz.