Google BigQuery

Genel Bakış

OneSignal + BigQuery entegrasyonu iki güçlü veri hattını destekler:

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.

Bu entegrasyonlar bir araya geldiğinde, kullanıcı etkileşim verileri üzerinde tam kontrol sağlar—gelişmiş analitik ve gerçek zamanlı davranış odaklı mesajlaşmayı güçlendirir.

OneSignal etkinliklerini BigQuery’ye aktarma

Mesajlaşma performansı ve etkileşim etkinliklerini (örn. gönderimler, açılmalar, tıklamalar) BigQuery’ye göndererek:

Ö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

Gereksinimler

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ı

Kurulum Adımları

1. Hizmet Hesabı Oluşturma

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

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

Hizmet hesabı oluşturun

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

Alanları doldurun.

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

'BigQuery User' rolünü atayın

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

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.

Entegrasyonu etkinleştirmek için bu JSON anahtar dosyasının tüm içeriğini OneSignal’a yapıştıracaksınız.

2. OneSignal’da Entegrasyonu Etkinleştirme

OneSignal > Veri > Entegrasyonlar > BigQuery'ye gidin

Hizmet hesabı JSON anahtarınızı yapıştırın

Ayarları yapılandırın

Senkronizasyon Sıklığı: Her 15 dakikada bir kadar sık
Veri Kümesi/Tablo Adları: Yalnızca küçük harfler, sayılar ve alt çizgiler içermeli ve bir sayı ile başlayamaz.
Etkinlik Türleri: Belirli mesaj etkinliklerini seçin (örn. gönderildi, açıldı, tıklandı)
- Not: Birden fazla etkinlik türü seçebilir veya seçilen etkinlikleri daha sonra güncelleyebilirsiniz.

Kaydet'e tıklayın ve onay bekleyin

İlk veri senkronizasyonunun BigQuery’de görünmesi 15-30 dakika sürebilir.Beklerken, seçilen etkinlikleri tetiklemek için push, e-posta, uygulama içi veya SMS yoluyla mesajlar gönderin.

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

BigQuery konsolunuzu açın ve senkronize edilmiş mesaj etkinliklerini keşfetmek için veri kümesini (örn. onesignal_events_<app-id>) bulun.

Dışa aktarılan mesaj etkinliklerini içeren BigQuery veri kümesi

Message events and properties

Message event kinds

Property: event_kind Type: String The kind of message and event (e.g. message.push.received, message.push.sent).

Message Event (OneSignal)	`event_kind`	Description
Push Sent	`message.push.sent`	Push notification successfully sent.
Push Received	`message.push.received`	Delivered push (see Confirmed Delivery).
Push Clicked	`message.push.clicked`	User clicked the push.
Push Failed	`message.push.failed`	Delivery failure. See message reports.
Push Unsubscribed	`message.push.unsubscribed`	User unsubscribed from push.
In-App Impression	`message.iam.displayed`	In-App message shown.
In-App Clicked	`message.iam.clicked`	In-App message clicked.
In-App Page Viewed	`message.iam.pagedisplayed`	In-App page shown.
Email Sent	`message.email.sent`	Email delivered.
Email Received	`message.email.received`	Email accepted by recipient’s mail server.
Email Opened	`message.email.opened`	Email opened. See Email Reports.
Email Link Clicked	`message.email.clicked`	Link in email clicked.
Email Unsubscribed	`message.email.unsubscribed`	Recipient unsubscribed.
Email Marked Spam	`message.email.resporedasspam`	Marked as spam. See Email Deliverability.
Email Bounced	`message.email.hardbounced`	Bounce due to permanent delivery failure.
Email Failed	`message.email.failed`	Delivery failed.
Email Suppressed	`message.email.supressed`	Suppressed due to suppression list.
SMS Sent	`message.sms.sent`	SMS sent.
SMS Delivered	`message.sms.delivered`	SMS successfully delivered.
SMS Failed	`message.sms.failed`	SMS failed to deliver.
SMS Undelivered	`message.sms.undelivered`	SMS rejected or unreachable.

Event data schema

For each message event generated by a user, the following metadata will be attached to the record.

Column Name	Type	Description
`event_id`	UUID	Unique identifier for the event
`event_timestamp`	Timestamp	Time of event occurrence
`event_kind`	String	The Event Kind
`subscription_device_type`	String	Device type (e.g., iOS, Android, Web, Email, SMS)
`language`	String	Subscription language code
`version`	String	Integration version
`device_os`	String	Device operating system version
`device_type`	Number	Numeric device type
`token`	String	Push token, phone number, or email
`subscription_id`	UUID	Subscription ID
`subscribed`	Boolean	Subscription status
`onesignal_id`	UUID	OneSignal user ID
`last_active`	String	Last active timestamp
`sdk`	String	OneSignal SDK version
`external_id`	String	External user ID that should match the integration user ID
`app_id`	UUID	App ID from OneSignal
`template_id`	UUID	Template ID (if applicable)
`message_id`	UUID	Message batch/request ID
`message_name`	String	Name of the message
`message_title`	String	Message title (English only)
`message_contents`	String	Truncated message body (English only)
`_created`, `_id`, `_index`, `_fivetran_synced`	Internal use	Fivetran sync metadata

Notes

Syncs after saving/activating may take an additional 15-30 minutes to complete.
Deactivating may still result in one final sync after deactivation.
To ensure efficient data synchronization, our system automatically creates and manages staging datasets. These datasets, named with a pattern like fivetran_{two random words}_staging, temporarily store data during processing before it’s integrated into your main schema. These staging datasets are essential for maintaining a streamlined workflow and should not be deleted, as they will be automatically recreated.

BigQuery’den etkinlikleri içe aktarma

BigQuery’den OneSignal’a davranışsal etkinlik verilerini göndererek:

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

Gereksinimler

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ı

Kurulum Adımları

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.

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

OneSignal'da entegrasyonu ekleyin

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

BigQuery entegrasyonu ekleyin

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ı

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

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

Map your to OneSignal’s custom events format:

OneSignal Field	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`	No

Gelişmiş yapılandırma

Özel SQL Sorguları

OneSignal’a senkronize etmeden önce etkinlik verilerini filtrelemek veya dönüştürmek için özel SQL kullanın:

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

Etkinlik verileriniz birden fazla BigQuery projesine yayılıyorsa, OneSignal hizmet hesabına referans verilen tabloları veya görünümleri içeren her projeye erişim verin.

Optimal performans için BigQuery bağlantı bölgeniz belirli tablo bölgesiyle eşleşmelidir.

SSS

Senkronizasyonum neden başarısız oluyor?

Senkronizasyonunuzun başarısız olmasının birkaç yaygın nedeni vardır:

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

Yukarıdaki kurulum adımlarını inceleyin ve bunları doğru şekilde takip ettiğinizden emin olun. Hala sorun yaşıyorsanız, lütfen support@onesignal.com ile iletişime geçin.

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

Bu genellikle bir mesaj şablonu birden fazla gönderimde veya tetiklenen akışta yeniden kullanıldığında meydana gelir.

OneSignal ne sıklıkla veri senkronize eder?

Hem dışa aktarma hem de içe aktarma entegrasyonları her 15 dakikada bir kadar sık senkronize edebilir.

BigQuery görünümlerini kullanabilir miyim?

Evet. Sadece hizmet hesabının görünümde referans verilen tüm tablolara erişimi olduğundan emin olun.

İlk adımlar & ayarlar

Mesaj kanalları

Journey'ler

Hedeflenen & özel olaylar

Analitik ve Entegrasyonlar

Gizlilik & Güvenlik

Genel Bakış