Ana içeriğe atla

​
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

​
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

1

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

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
OneSignal, entegrasyon kurulum işlemi sırasında özel servis hesabı e-postasını sağlayacaktır.
3

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)
4

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
Birden fazla sütunu olay özellikleri olarak eşleyebilirsiniz. OneSignal bunları tek bir olay yüküne birleştirecektir.
5

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

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.

​
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ş 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
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.

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