Google BigQuery

​

Genel Bakış

• Dışa Aktarma: OneSignal’dan BigQuery’ye analiz ve raporlama için mesajlaşma etkinlik verilerini (push, e-posta, SMS, uygulama içi) otomatik olarak gönderin.
• İçe Aktarma: BigQuery veri kümelerinizden OneSignal’a özel kullanıcı etkinliklerini senkronize ederek otomatik Yolculukları ve kişiselleştirilmiş mesajlaşmayı tetikleyin.

​

OneSignal etkinliklerini BigQuery’ye aktarma

• Özel panolar ve raporlar oluşturun
• Kanallar arasında teslimat ve etkileşim trendlerini takip edin
• OneSignal verilerini analiz için diğer iş verileriyle birleştirin

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

• Faturalandırma etkin Google Cloud Platform projesi
• GCP projenizde etkinleştirilmiş BigQuery
• BigQuery yazma izinlerine sahip hizmet hesabı

​

1. Hizmet Hesabı Oluşturma

1

Google Cloud Platform hesabınıza giriş yapın

Giriş yaptıktan sonra, doğru projenin seçildiğinden emin olun.

2

Hizmet hesabı oluşturun

Hizmet Hesabı Oluşturma sayfasını ziyaret edin ve Hizmet Hesabı Oluştur’a tıklayın.

3

Alanları doldurun.

Seçtiğiniz herhangi bir ad ve hizmet hesabı kimliği verin.

4

'BigQuery User' rolünü atayın

Hizmet hesabına “BigQuery User” rolünü verin.

5

Bu hesap için JSON anahtarı oluşturun

Yeni hizmet hesabınıza gidin > Anahtarlar > Anahtar Ekle > Yeni anahtar oluştur > JSON seçin. Dosyayı kaydedin.

​

2. OneSignal’da Entegrasyonu Etkinleştirme

​

3. BigQuery’de Verileri Görüntüleme

​

Mesaj etkinlikleri ve özellikleri

​

Mesaj etkinlik türleri

​

Etkinlik veri şeması

​

Notlar

• Kaydetme/etkinleştirme sonrası senkronizasyonlar tamamlanması için ek 15-30 dakika alabilir.
• Devre dışı bırakma, devre dışı bırakıldıktan sonra hala bir son senkronizasyonla sonuçlanabilir.
• Verimli veri senkronizasyonunu sağlamak için sistemimiz otomatik olarak hazırlama veri kümelerini oluşturur ve yönetir. fivetran_{iki rastgele kelime}_staging gibi bir desenle adlandırılan bu veri kümeleri, ana şemanıza entegre edilmeden önce işleme sırasında geçici olarak veri depolar. Bu hazırlama veri kümeleri akıcı bir iş akışını sürdürmek için gereklidir ve otomatik olarak yeniden oluşturulacakları için silinmemelidir.

​

BigQuery’den etkinlikleri içe aktarma

• Kullanıcı etkinliğine dayalı Yolculukları tetikleyin
• Davranışsal verilere dayalı mesajlaşmayı kişiselleştirin

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

• BigQuery ve etkinlik veri tabloları olan GCP projesi
• Okuma izinlerine sahip hizmet hesabı
• BigQuery veri kümelerinde davranışsal veri içeren etkinlik veri tabloları

1

BigQuery hizmet hesabı oluşturun

OneSignal, bağlantıyı oluşturduğunuzda otomatik olarak bir hizmet hesabı oluşturacaktır. Alternatif olarak, kendi hizmet hesabı anahtar JSON dosyanızı sağlayabilirsiniz.Kendi hizmet hesabınızı oluşturuyorsanız, aşağıda listelenen gerekli izinlere sahip olduğundan emin olun.

2

Gerekli izinleri verin

OneSignal hizmet hesabı şu BigQuery IAM rollerine ihtiyaç duyar:

• bigquery.dataViewer - Etkinlik verileri içeren veri kümelerine ve tablolara okuma erişimi
• bigquery.jobUser - Veri sorguları için işler oluşturma izni
• bigquery.metadataViewer - Proje düzeyinde meta veri erişimi (önerilir)

Google Cloud Console veya CLI kullanarak izinleri verin:

gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
  --member serviceAccount:ONESIGNAL_SERVICE_ACCOUNT_EMAIL \
  --role roles/bigquery.dataViewer

gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
  --member serviceAccount:ONESIGNAL_SERVICE_ACCOUNT_EMAIL \
  --role roles/bigquery.jobUser

3

OneSignal'da entegrasyonu ekleyin

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

• Senkronizasyon Motoru: Büyük veri kümeleri veya karmaşık etkinlik veri sorguları için gelişmiş senkronizasyon önerilir. Temel senkronizasyonla başlayabilir ve gerekirse daha sonra gelişmiş senkronizasyona geçebilirsiniz.
• Google Cloud Proje Kimliği: BigQuery veri kümelerini içeren GCP projeniz
• Veri Kümesi Bölgesi: BigQuery veri kümelerinizin depolandığı konum
• Hizmet Hesabı Anahtarı (isteğe bağlı): Kendi hizmet hesabınızı kullanıyorsanız JSON anahtar dosyası

4

Etkinlik veri kaynağını yapılandırın

Etkinlik verilerinizi içeren BigQuery veri kümesini ve tablosunu belirtin:

• Veri Kümesi: BigQuery veri kümesi adı (örn. analytics_events)
• Tablo/Görünüm: Etkinlik kayıtlarını içeren tablo veya görünüm
• Etkinlik Sorgusu: Etkinlik verilerini filtrelemek veya dönüştürmek için isteğe bağlı SQL sorgusu

Etkinlik tablonuz şunlar için sütunlar içermelidir:

• Etkinlik adı/türü
• Kullanıcı tanımlayıcısı
• Etkinlik zaman damgası
• Ek etkinlik özellikleri

5

Bağlantıyı test edin

OneSignal’ın BigQuery projenize erişebileceğini ve etkinlik verilerini okuyabileceğini doğrulamak için Bağlantıyı Test Et’e tıklayın.

​

Event data mapping

​

Gelişmiş yapılandırma

​

Özel SQL Sorguları

SELECT
  event_name,
  user_id,
  event_timestamp,
  STRUCT(
    product_id,
    purchase_amount,
    category
  ) as payload
FROM `project.dataset.events`
WHERE event_timestamp >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 DAY)

​

Çapraz Proje Erişimi

​

SSS

​

Senkronizasyonum neden başarısız oluyor?

• Hizmet hesabı gerekli izinlere sahip değil
• Kaynak veri kümesi temel senkronizasyon için çok büyük ve gelişmiş senkronizasyon kullanmanız gerekiyor

​

Aynı içerik için neden birden fazla mesaj kimliği görüyorum?

​

OneSignal ne sıklıkla veri senkronize eder?

​

BigQuery görünümlerini kullanabilir miyim?

​

İlgili Kaynaklar

• GCP’de hizmet hesabı anahtarları oluşturma
• OneSignal Yolculuklar belgeleri
• OneSignal Veri Dışa Aktarma belgeleri