- 1. Adım: Yeni bir Google Cloud Console projesi oluşturun ve BigQuery'yi etkinleştirin
- 2. Adım: Projenizi BigQuery Export için hazırlayın
- 3. Adım: BigQuery'yi Google Analytics 4 mülklerine bağlayın
- BigQuery bağlantısını silme
- BigQuery Export sınırları
- Veri filtreleme
- Fiyatlandırma ve faturalandırma
- Verileri ne zaman görmeye başlarsınız?
- Bağlantı hatalarının nedenleri
- Dışa aktarma hatalarının nedenleri
- İlgili kaynaklar
1. Adım: Bir Google API Konsolu projesi oluşturun ve BigQuery'yi etkinleştirin
- Google Cloud Console'a giriş yapın.
- Yeni bir Google Cloud Console projesi oluşturun veya mevcut bir projeyi seçin.
- API'ler tablosuna gidin.
Sol üst köşedeki Gezinme menüsünü açıp API'ler ve Hizmetler'i ve ardından Kitaplık'ı tıklayın. - BigQuery'yi etkinleştirin.
Google Cloud API'leri bölümünde BigQuery API'yi tıklayın. Sonraki sayfada Etkinleştir'i tıklayın. - İstenirse Hizmet Şartları'nı inceleyip kabul edin.
2. Adım: Projenizi BigQuery Export için hazırlayın
Google Analytics verilerini ücretsiz olarak BigQuery korumalı alanına aktarabilirsiniz (korumalı alan sınırları geçerlidir).
Korumalı alandan üst sürüme geçme ve BigQuery fiyatlandırması hakkında daha fazla bilgi edinin.
3. Adım: Bir Google Analytics 4 mülkünü BigQuery'ye bağlayın
İlk iki adımı tamamladıktan sonra Analytics Yönetici sayfasından BigQuery Export'u etkinleştirebilirsiniz.
BigQuery Export, Google Analytics ile aynı toplama ve yapılandırma sınırlarına tabidir. Daha yüksek sınırlara ihtiyacınız varsa mülkünüzü 360 sürümüne geçirebilirsiniz.
Analytics'te oturum açtığınızda BigQuery projesinde OWNER (SAHİP) erişimine sahip olan (daha ayrıntılı erişim şartları için aşağıdaki İzinler bölümünü inceleyin) ve bağlamak istediğiniz veri akışını içeren Analytics mülkü için Düzenleyici rolü olan bir e-posta adresi kullanın.
- Yönetici bölümündeki Ürün Bağlantıları altında BigQuery Bağlantıları'nı tıklayın.
- Bağla'yı tıklayın.
- Erişiminiz olan projelerin listesini görüntülemek için BigQuery projesi seçin'i tıklayın.
Analytics ve Firebase'i bağladıysanız (veya bağlamayı planlıyorsanız) verileri aynı Cloud projesine aktarabilirsiniz. Böylece, bunları diğer Firebase verileriyle daha kolay bir şekilde birleştirebilirsiniz. - Listeden bir proje seçin ve Onayla'yı tıklayın.
- Veriler için bir konum seçin. (Projenizde Analytics mülkü için bir veri kümesi zaten varsa bu seçeneği yapılandıramazsınız.)
- İleri'yi tıklayın.
- Dışa aktarma işlemine dahil edilecek veri akışlarını ve dışa aktarma işleminden hariç tutulacak belirli etkinlikleri seçmek için Veri akışları ve etkinliklerini yapılandırın'ı seçin. Mevcut etkinlikler listesinden seçim yapmak için Ekle'yi veya mevcut etkinlikleri ada göre seçmek ya da henüz mülkte toplanmamış etkinlik adlarını belirtmek için Ad girerek etkinlik belirtin'i tıklayarak etkinlikleri hariç tutabilirsiniz.
- Bitti'yi tıklayın.
- Reklam tanımlayıcıları eklemek isterseniz Mobil uygulama veri akışları için reklam tanımlayıcıları dahil edin'i seçin.
- Veriler için Günlük (günlük olarak) veya Akış (sürekli) dışa aktarma seçeneklerinden birini ya da ikisini birden belirleyin.
- İleri'yi tıklayın.
- Ayarlarınızı gözden geçirin ve Gönder'i tıklayın.
İzinler
Proje getIamPolicy/setIamPolicy hakları, hizmet alma/etkinleştirme hakları
OWNER (SAHİP), bu izinlerin üst kümesidir.BigQuery bağlantısı oluşturmak için ihtiyacınız olan minimum izinler:
resourcemanager.projects.get- Projeyi almak için
resourcemanager.projects.getIamPolicy- İzinlerin listesini almak için
resourcemanager.projects.setIamPolicy- Kullanıcının bu projede bağlantı oluşturma izni olup olmadığını kontrol etmek için
serviceusage.services.enable- BigQuery API'yi etkinleştirmek için
serviceusage.services.get- BigQuery API'nin etkinleştirilip etkinleştirilmediğini kontrol etmek
Hizmet hesabını doğrulama
Analytics ve BigQuery'yi bağladığınızda bu işlem aşağıdaki hizmet hesabını oluşturur:
firebase-measurement@system.gserviceaccount.com
Hesabın proje üyesi olarak eklendiğini ve BigQuery Kullanıcısı (roles/bigquery.user) rolüne sahip olduğunu doğrulayın.
Daha önce BigQuery Export'u, Google Cloud projesi için hizmet hesabınıza Düzenleyici rolü verecek şekilde ayarladıysanız bu rolü BigQuery Kullanıcısı olacak şekilde ayarlayabilirsiniz. Hizmet hesabının rolünü değiştirmek için Analytics'in bağlantısını kaldırıp BigQuery projenize yeniden bağlamanız gerekir. İlk olarak Analytics ile BigQuery'nin bağlantısını ve Düzenleyici rolüne sahip olan hizmet hesabını kaldırın. Ardından, proje için doğru izne sahip yeni hizmet hesabını oluşturmak üzere Analytics ile BigQuery'yi yukarıdaki talimatlara göre yeniden bağlayın.
Yeniden bağladıktan sonra hizmet hesabının, mevcut dışa aktarma veri kümesinde Sahip (bigquery.dataOwner) rolünde olduğundan emin olun. Bu işlemi, veri kümesinin erişim politikasını görüntüleyerek yapabilirsiniz.
Bölge değiştirme
Yanlış bölgeyi seçerseniz ve bağlantıyı oluşturduktan sonra bu bölgeyi değiştirmeniz gerekirse:
- BigQuery bağlantısını silin (aşağıya göz atın).
- Verileri BigQuery'deki başka bir veri kümesine yedekleyin (taşıyın veya kopyalayın).
- Asıl veri kümesini silin. Adı not edin. Bir sonraki adımda bu ada ihtiyacınız olacak.
- Sildiğiniz veri kümesiyle aynı ada sahip yeni bir veri kümesi oluşturun ve verilerin konumunu seçin.
- Yeni veri kümesini firebase-measurement@system.gserviceaccount.com ile paylaşın ve hizmet hesabına BigQuery Veri Sahibi rolünü verin.
- Yedekleme verilerini yeni veri kümesine kopyalayın.
- Yeni bir BigQuery bağlantısı oluşturmak için yukarıdaki prosedürü tekrarlayın.
Konumu değiştirdikten sonra verilerinizde bir boşluk oluşur: Mevcut bağlantının silinmesi ve yeni bağlantının oluşturulması arasında geçen zamanda veri akışı ve verilerin günlük olarak dışa aktarılması gerçekleşmez.
BigQuery bağlantısını silme
- Yönetici bölümündeki Ürün Bağlantıları altında BigQuery Bağlantıları'nı tıklayın.
- Bağlantının bulunduğu satırı tıklayın.
- Sağ üstten
> Sil'i tıklayın.
> Sil'i tıklayın.BigQuery Export sınırları
Standart GA4 mülklerinde, günlük (toplu) dışa aktarma işlemleri için BigQuery Export sınırı 1 milyon etkinliktir. Akışı dışa aktarma özelliğinin etkinlik sayısı için bir sınır yoktur. Mülkünüz sürekli olarak dışa aktarma sınırını aşıyorsa günlük BigQuery Export duraklatılır ve önceki günlerin dışa aktarma işlemleri yeniden işlenmez.
Mülk düzenleyiciler ve yöneticiler, yönettikleri bir mülk günlük sınırı her aştığında e-posta bildirimi alır. Bu bildirim, işlem yapılmazsa dışa aktarma işleminin duraklatılacağı zamanı gösterir. Ayrıca, standart mülk günlük bir milyon etkinlik sınırını önemli ölçüde aşarsa Analytics günlük dışa aktarma işlemlerini hemen duraklatabilir. Bildirim alırsanız lütfen günlük olarak dışa aktarılan etkinliklerin hacmini azaltmak ve etkinliklerin günlük olarak dışa aktarılmaya devam etmesini sağlamak için veri filtreleme seçeneklerinden (veri akışı dışa aktarma ve etkinlik hariç tutma) yararlanın.
360 mülklerinde kullanılabilen daha yüksek sınırlar hakkında daha fazla bilgi edinin.
Veri filtreleme
Dışa aktarma işleminizin boyutunu sınırlandırmak veya BigQuery'de yalnızca istediğiniz etkinlikleri dışa aktardığınızdan emin olmak için belirli veri akışlarını ve etkinlikleri dışa aktarma işleminden hariç tutabilirsiniz.
Bağlantı oluşturma süreci sırasında veri akışlarını ve etkinlikleri hariç tutma
Bağlantı oluşturma süreci sırasında dışa aktarmak istediğiniz veri akışlarını seçerken hariç tutulacak etkinlikleri belirleme seçeneğiniz de olur. Bağlantı oluşturma sürecinin 9. adımına bakın.
Bağlantıyı yapılandırdıktan sonra veri akışları veya etkinliklerini ekleme ya da kaldırma
BigQuery bağlantısını yapılandırdıktan sonra veri akışı ekleyip kaldırmanın yanı sıra hariç tutma listesine etkinlik ekleyebilir ya da listeden etkinlik kaldırabilirsiniz.
- Yönetici bölümündeki Ürün Bağlantıları altında BigQuery Bağlantıları'nı tıklayın.
- Bağlantısını değiştirmek istediğiniz projenin bulunduğu satırı tıklayın.
- Veri akışları ve etkinlikler bölümünde Veri akışlarını ve etkinlikleri görüntüle'yi tıklayın.
- Mevcut veri akışlarını dışa aktarmak veya listeden kaldırmak için Dışa aktarılacak veri akışları bölümünden ek veri akışları seçebilirsiniz.
- Mevcut etkinlikler listesinden seçim yapmak için Hariç tutulacak etkinlikler listesinde Ekle'yi veya mevcut etkinlikleri ada göre seçmek ya da henüz mülkte toplanmamış etkinlik adlarını belirtmek üzere Ad girerek etkinlik belirtin'i tıklayın.
- Listeden etkinlik kaldırmak için satırın sonundaki eksi işaretini tıklayın.
Fiyatlandırma ve faturalandırma
BigQuery, iki fiyatlandırma bileşeni için ücret alır: depolama ve sorgu işleme. Fiyatlandırma tablosunu inceleyerek etkileşimli ve toplu sorgular arasındaki farkları öğrenebilirsiniz.
Dışa aktarmanın devam etmesi için geçerli bir ödeme şeklinizin Cloud'da bulunması gerekir. Dışa aktarma işlemi geçersiz bir ödeme yöntemi nedeniyle kesintiye uğrarsa söz konusu zamanda verileri tekrar dışa aktarmamız mümkün değildir.
Analytics verilerini BigQuery korumalı alanına ücretsiz olarak da aktarabilirsiniz ancak korumalı alan sınırlarının geçerli olduğunu unutmayın.
Verileri ne zaman görmeye başlarsınız?
Bağlantı tamamlandıktan sonra 24 saat içinde BigQuery projenize veri akışının başlaması gerekir. Günlük dışa aktarmayı etkinleştirirseniz her gün, önceki günün verilerini içeren 1 dosya dışa aktarılır (genellikle raporlama için belirlediğiniz saat diliminde öğlen erken saatlerde).
Bağlantı hatalarının nedenleri
BigQuery bağlantısının oluşturulması, aşağıdaki iki nedenden herhangi birine bağlı olarak başarısız olabilir:
- Kuruluş politikanız, Amerika Birleşik Devletleri için verileri dışa aktarmayı yasaklamaktadır. Verilerinizin konumu olarak Amerika Birleşik Devletleri'ni seçtiyseniz farklı bir konum seçin.
- Kuruluş politikanız, verileri dışa aktarmak istediğiniz alandaki hizmet hesaplarını yasaklamaktadır. Bu durumda, kuruluş politikanızı değiştirmeniz gerekir.
Dışa aktarma hatalarının nedenleri
| Hata | Neden | Sonuç |
|---|---|---|
| Hizmet hesabı yok | Cloud projenizde Kullanıcı rolüne sahip hizmet hesabı yok. | Analytics, tablolar oluşturamaz. Dışa aktarma işlemi başarısız. |
| Robot hesabı yükleme işleminden sonra siliniyor | Cloud hesabındaki bir kullanıcı, Google Analytics tarafından yüklenen robot hizmet hesabını kaldırdı. | Analytics artık tablo oluşturamaz. Tüm dışa aktarma işlemleri durur. |
| Kuruluş Politikası BigQuery Export ile çakışıyor | Cloud projesindeki bir kullanıcı, Analytics'in verileri dışa aktarmasını engelleyen bir kuruluş politikası oluşturdu. Politika, BigQuery tablolarının oluşturulmasını veya tablolara yazmayı engelleyebilir. Politika, veri depolamanın bulunduğu bölgeyi de belirleyebilir. | Tablo oluşturulmamış veya oluşturulmuş ve daha sonra (yaklaşık 30 dakika) sonra silinmiş. |
| Kullanıcı, Faturalandırma Ayarlarını değiştiriyor | Cloud projesindeki bir kullanıcı, ücretsiz olarak BigQuery için ücretsiz olarak geçiş yapar. Bu durum normal işleyebilse de, örneğin, proje zaten 10 GB'tan fazlaysa (korumalı alan sınırı) hatalar oluşabilir. Pratikte dışa aktarma işlemi başarısız olabilir. | Tablolar doldurulmaz. |
| Kotanın üzerinde Cloud projesi | Cloud, çoğu proje için sınırlı kaynaklara sahiptir. BigQuery depolama alanı kotasını aşabilir ve daha fazla veri yazılmasının önüne geçebilirsiniz. Bu kotanın ücretsiz projeler için küçük (10 GB) olduğunu unutmayın. | Tablolar doldurulmaz. |
| Kullanıcı mülk saat dilimini değiştiriyor | Dışa aktarma işlemi, mülk saat dilimine göre bir mülkün 24 saatlik anlık görüntüsünü alır. Saat dilimi değişirse, dışa aktarma penceresi belirli bir gün kısaltılabilir veya uzatılabilir (ör. saat dilimi ABD Doğu Standart Saati'nden ABD Pasifik Saati'ne değiştirilirse 3 saat daha kısa). Her iki durumda da kullanıcı, olağan dışı bir etkinlik sayısı görür. | Bir günlük olağandışı etkinlik sayısı. Genel kullanıcılar için kafa karışıklığı. |
Destek
Faturalandırma gibi BigQuery sorunları için Google Cloud Destek Ekibi ile iletişime geçin.
İlgili kaynaklar
BigQuery Export
Dışa aktarma hakkında bilgi ve örnek bir veri kümesine erişim için BigQuery Export belgelerini inceleyin.