GSC BigQuery Dışa Aktarımı

Google Search Console BigQuery dışa aktarımını, kullanıcı arayüzü satır sınırı olmadan (anonimleştirilmiş sorgular hariç) örneklenmemiş günlük tıklama ve gösterim verilerini sorgulamak için nasıl kullanacağınız, kullanıcı arayüzü ile ham dışa aktarım arasındaki fark, kurulum, maliyet mekanizmaları ve geriye dönük doldurma olmaması tuzağı.

İlk yayın tarihi: 27 Haz 2026 · Son güncelleme: 8 Ağu 2026 · Advanced
Diller

Web sitesi özellikleri için GSC BigQuery toplu dışa aktarımı, anonimleştirilmiş sorgular hariç, Performance verilerinin günlük, örneklenmemiş bir dökümünü BigQuery'ye zamanlar; kullanıcı arayüzü satır sınırını ve 16 aylık saklama penceresini atlar. Site düzeyinde, URL düzeyinde ve dışa aktarma günlüğü tabloları oluşturur, geriye dönük doldurma yapmaz, faturalandırma gerektirir ve sorgu maliyetlerine yol açabilir. Google artık Instagram, TikTok, X ve YouTube platform özelliklerini desteklemektedir, ancak mevcut platform belgeleri bunlar için BigQuery desteğini vaat etmemektedir; bu ardışık düzenin sosyal hesaplar için geçerli olduğunu varsaymayın.

TL;DR — Toplu veri dışa aktarımı, Search Console Performans verilerinizin bir BigQuery veri kümesine zamanlanmış günlük, örneksiz bir dökümüdür — ~1 000 satırlık dışa aktarma sınırı yok, ~16 aylık saklama duvarı yok. Üç tablo (searchdata_site_impression, searchdata_url_impression, ExportLog) oluşturur. Kurulum: faturalandırma etkin bir Google Cloud projesi, BigQuery + BigQuery Storage API’leri açık, Google’ın dışa aktarma hizmet hesabına verilen iki IAM rolü ve ardından GSC’de Ayarlar → Toplu veri dışa aktarımı. Geriye dönük doldurma yapmaz, anonimleştirilmiş sorguları hâlâ boş dize olarak bildirir ve ilk dışa aktarım yaklaşık 48 saat içinde gerçekleşir. Maliyet, gerçek bir ücretsiz katman artı TB başına sorgu ücretleridir — klasik fatura, ham tabloları canlı sorgulayan panolardan gelir. Bunu üçüncü basamak olarak düşünün: arayüz → API → toplu dışa aktarım.

Aşağıdaki merdiven, web sitesi mülkleri içindir. Sosyal veya video platformu mülklerinin Search Console API’sini veya BigQuery dışa aktarımını desteklediğinin kanıtı değildir.

Gerçekte ne olduğu

Toplu dışa aktarım, bir Google Cloud projesine zamanlanmış bir Search Console veri hattıdır; bağımsız bir sıralama verisi kaynağı değildir. Evidence for this claim Search Console bulk data export sends daily performance data to BigQuery in a configured Google Cloud project. Scope: Search Console bulk export; setup, permissions, quotas, and supported properties follow Google's current documentation. Confidence: high · Verified: Google: Bulk data export Sorgular, belgelenen tablolara, anahtarlara ve gizlilik/toplama davranışına uymalıdır. Evidence for this claim Bulk export uses site-impression, URL-impression, and export-log tables with documented schemas. Scope: Google's published Search Console export schema; aggregation and privacy handling still affect analysis. Confidence: high · Verified: Google: Bulk export tables

Google’da Arama Savunucusu olan Daniel Waisberg bunu açıkça anlatıyor: “A bulk data export is a scheduled daily export of your Search Console performance data. It includes all the data used by Search Console to generate performance reports. Data is exported to Google BigQuery, where you can run SQL queries for advanced data analysis or even export it to another system.” (çeviri) «Toplu veri dışa aktarımı, Search Console performans verilerinizin zamanlanmış günlük bir dışa aktarımıdır. Search Console’un performans raporları oluşturmak için kullandığı tüm verileri içerir. Veriler, gelişmiş veri analizi için SQL sorguları çalıştırabileceğiniz veya hatta başka bir sisteme aktarabileceğiniz Google BigQuery’ye aktarılır.» (Search Engine Journal’da alıntılanmıştır).

Önemli olan ölçektir. Search Console arayüzü çoğu dışa aktarımı yaklaşık 1 000 satırla sınırlar ve yaklaşık 16 aylık kayan bir pencere gösterir. Search Console API size daha fazlasını verir ancak yine de sınırlıdır ve hız sınırına tabidir. Toplu dışa aktarım, satır tavanını tamamen ortadan kaldırır ve ne kadar süre saklayacağınıza sizin karar vermenizi sağlar. Google’ın duyurudaki kendi sözü, Search Engine Land tarafından yeniden üretildiği şekliyle: “The daily data row limit does not impact this data, so you can extract more data using this method,” (çeviri) «Günlük veri satırı sınırı bu verileri etkilemez, bu nedenle bu yöntemi kullanarak daha fazla veri çıkarabilirsiniz,» ve özellik “could be particularly helpful for large websites with tens of thousands of pages.” (çeviri) «on binlerce sayfası olan büyük web siteleri için özellikle yararlı olabilir.»

Hangi verileri alırsınız: üç tablo

Her şey, adı her zaman searchconsole ile başlayan bir veri kümesine iner. Üç nesne görünür (Tablo yönergeleri ve referans):

  1. searchdata_site_impression“Contains performance data for your property aggregated by property.” (çeviri) «Mülkünüz için mülke göre toplanmış performans verilerini içerir.» Anahtar alanlar: data_date (“The day on which the data in this row was generated (Pacific Time)” (çeviri) «Bu satırdaki verilerin oluşturulduğu gün (Pasifik Saati)»), site_url (alan adı mülkleri sc-domain: önekini kullanır), query, is_anonymized_query, country (ISO-3166-1 Alpha-3), search_type (web/görsel/video/haber/keşfet/googleNews), device, impressions, clicks ve sum_top_position.
  2. searchdata_url_impression“Contains performance data for your property aggregated by URL.” (çeviri) «Mülkünüz için URL’ye göre toplanmış performans verilerini içerir.» Yukarıdakilerin tümü artı url (“The fully-qualified URL where the user eventually lands when they click the search result” (çeviri) «Kullanıcının arama sonucuna tıkladığında en son ulaştığı tam nitelikli URL»), is_anonymized_discover, zengin sonuç türüne göre dilimleyebilmeniz için bir dizi is_[search_appearance_type] boole bayrağı (örn. is_amp_top_stories, is_job_listing, is_tpf_faq) ve sum_position. Çoğu analizin üzerinde çalıştığı ayrıntılı tablo budur.
  3. ExportLog“A record of what data was saved for that day. Failed exports are not recorded here.” (çeviri) «O gün için hangi verilerin kaydedildiğinin kaydı. Başarısız dışa aktarımlar buraya kaydedilmez.» Alanlar agenda (şu anda yalnızca SEARCHDATA), namespace (hangi tablonun yazıldığı), data_date, epoch_version (“An integer, where 0 is the first time data was saved to this table” (çeviri) «0’ın verilerin bu tabloya ilk kaydedildiği zaman olduğu bir tam sayı» — Google daha sonra bir günün verilerini revize ettiğinde artar) ve publish_time içerir.

The anonymized-query caveat is the important one. Even here, at the raw level, anonymized queries are not revealed. As Google’s field description puts it, when is_anonymized_query is true the query field “will be a zero-length string.” Their metrics are still aggregated into your totals, but they’re never attributable to a specific term — exactly the same limitation the UI and the API have. This is a big deal at scale: in my Ahrefs study of GSC’s hidden terms, across 146 741 websites and roughly 9 billion clicks, 46,08% of all clicks went to queries Google doesn’t disclose — and that study used the Search Console API, which “allows us to get all of the data—and there’s still a lot missing.” The BigQuery export doesn’t recover any of it. If someone tells you bulk export “finally shows you the hidden queries,” they’re wrong.

Nasıl kurulur

Akış (Yeni bir toplu veri dışa aktarımı başlatın):

  1. Faturalandırma etkin bir Google Cloud projesi oluşturun veya seçin. Google’a göre: “Veriler Google Cloud depolama ve sorgu maliyetlerine tabidir, ancak ücretsiz bir kullanım düzeyi vardır.” Ücretsiz katmanda kalmak için bile faturalandırmaya ihtiyacınız var.
  2. BigQuery API’sini ve BigQuery Storage API’sini bu projede etkinleştirin.
  3. Google’ın dışa aktarım hizmet hesabına erişim verin. search-console-data-export@system.gserviceaccount.com adresini iki IAM rolüyle bir asıl olarak ekleyin: BigQuery Job User (bigquery.jobUser) ve BigQuery Data Editor (bigquery.dataEditor).
  4. Search Console’da Ayarlar → Toplu veri dışa aktarımı’na gidin. Cloud proje kimliğini (kimliği, proje numarasını değil) yapıştırın, bir veri kümesi adı seçin ve bir veri kümesi konumu seçin. Adlandırma kuralına dikkat edin: “Veri kümesi adı her zaman searchconsole dizesiyle başlar, özelleştirseniz bile.” Dışa aktarımın kendi veri kümesinde bir bölüm sona erme ilkesi ayarlarsanız, bunu 14 gün veya daha uzun tutun — Google 14 günlük bir minimum belgeler ve daha kısa süre belgelenmiş bir başarısızlık nedenidir. Oluşturulan tablo şemasını da değiştirmeden bırakın; değiştirmek, dışa aktarımı bozmanın diğer belgelenmiş yoludur (aşağıda Sorun Giderme’de daha fazlası).
  5. Bekleyin. Google, dışa aktarım sürecinin etkinleştirmeden sonraki bir gün içinde başlaması gerektiğini söylüyor. “İlk dışa aktarım, Search Console’da başarılı yapılandırmanızdan sonra 48 saate kadar gerçekleşir,” ve bu ilk teslimat yalnızca dışa aktarım günü verilerini içerir — kurulumdan önceki hiçbir şey (sonraki bölüme bakın: geri doldurma yok). Bundan sonra siz durdurana kadar günlük çalışır.
Evidence for this claim Setup requires a billed Google Cloud project, BigQuery API and BigQuery Storage API, plus BigQuery Job User and BigQuery Data Editor roles for search-console-data-export@system.gserviceaccount.com. Scope: verified property and public web as applicable Confidence: high · Verified: Start a new bulk data export

Belirlenmesi gereken pratik bir beklenti: Search Console verileri iki günlük bir gecikmeyle gelir, bu nedenle sahip olacağınız en güncel gün iki gün öncesidir. 30 günlük bir aralık isteyin ve etkili bir şekilde yaklaşık 28 gün kullanılabilir veri elde edersiniz.

Geri doldurma olmaması tuzağı

Bunu yüksek sesle söyleyin, çünkü insanları yakar: dışa aktarımı etkinleştirmek geçmiş verilerinizi çekmez. Etkinleştirme gününden başlar ve yalnızca ileriye doğru birikir. Bu o kadar yaygındır ki Google’ın kendi topluluk forumunda bununla ilgili birden fazla konu vardır — “Toplu veri dışa aktarımı etkinleştirildiğinde geçmiş verilerle nasıl geri doldurulur” (konu 300051568), konu 255704574 ve konu 429248330. Antoine Eripret bunu uygulayıcı derinlemesine incelemesinde açıkça ifade ediyor: “Geçmiş verileri alamazsınız: bugün etkinleştirirseniz, bugünden itibaren verilere sahip olursunuz.” Çıkarım basit — ilk duyduğunuz gün açın, henüz hiçbir şeyi analiz etmeye hazır olmasanız bile, böylece saat başlar.

Maliyeti ne kadar ve nasıl sürprizle karşılaşılmaz

Google Cloud Blog yazısı Daniel Waisberg ve Gaal Yahas tarafından yazılan bu yazı, avantajları satıyor — “Büyük bir web siteniz varsa, bu çözüm diğer veri dışa aktarma çözümlerinden daha fazla sorgu ve sayfa sağlayacaktır” ve “Search Console on altı aya kadar veri depolar; BigQuery kullanarak kuruluşunuz için anlamlı olan kadar veri depolayabilirsiniz” — ancak maliyet mekaniği size kalmış.

Bu yazının yazıldığı tarih itibarıyla BigQuery’nin ücretsiz katmanı kabaca 10 GiB depolama ücretsiz artı ayda 1 TiB (~1 TB) isteğe bağlı sorgu işleme ücretsizdir; bunun ötesinde işlenen her TiB için yaklaşık 6,25 USD ve ayda depolanan her GB için yaklaşık 0,02 USD’dir (bölgeye ve depolama sınıfına göre değişir). Fiyatlandırma değişir, bu yüzden birine aktarmadan önce güncel rakamları doğrulayın. Çoğu küçük ve orta ölçekli site ücretsiz veya neredeyse ücretsiz kalır.

Faturalar ne kadar trafiğiniz olduğundan değil, nasıl sorguladığınızdan gelir. İki şey önemlidir:

  • Maliyet, ham trafikle değil, sorgu/anahtar kelime çeşitliliğiyle ölçeklenir. Trevor Fox’un kapsamlı rehberinde belirttiği gibi: “Veri hacmi, arama hacminden çok anahtar kelime çeşitliliğinin bir faktörüdür. Çok sayıda anahtar kelime için düşük arama hacmine sahip bir site, tek bir anahtar kelime için çok sayıda arama hacmine sahip bir siteden daha fazla veri üretecektir.”
  • Canlı bir panoyu ham tablolara bağlamayın. Bu klasik korku hikayesidir. Antoine Eripret, Looker Studio’nun ham milyar satırlık tablolara doğrudan bağlandığında tek bir günde 23 TB taradığını, yaklaşık 115 EUR olduğunu belgelemiştir. Google’ın kendi BigQuery verimlilik ipuçları yazısı da aynı şeyi prensipte söylüyor: özet tablolarında önceden toplayın, WHERE yan tümcesinde tarih bölümünde filtreleyin, SELECT * kullanmaktan kaçının, bütçe uyarıları ayarlayın ve eski bölümleri otomatik silmek için bölüm sona erme süresini ayarlayın.

Çözüm sıkıcı ama etkilidir: somutlaştırın sorgu sonuçlarınızı bir zamanlamayla küçük kalıcı özet tablolarına dönüştürün ve panolarınızı ham dışa aktarıma değil, bunlara yönlendirin.

Sorgulama: sizi aklı başında (ve ucuz) tutan kurallar

Google’ın sorgu yönergelerinden:

  • Her zaman toplayın. “Tablolardaki verilerin tarihe, URL’ye, siteye veya herhangi bir anahtar kombinasyonuna göre birleştirileceği garanti edilmez.” Çeviri: aynı gün/URL/sorgu için birden çok satır alırsınız, bu yüzden her zaman metriklerinizi SUM() ve boyutlarınızı GROUP BY yapın. Tek bir satırı asla bitmiş bir sayı olarak kabul etmeyin.
  • Tarih bölümünü filtreleyin. “Sorgu maliyetlerini en aza indirmenin iyi bir yolu, tarih bölümlü tabloda tarih aralığını sınırlamak için bir WHERE yan tümcesi kullanmaktır.”
  • Gerçek en iyi sorguları istediğinizde anonimleştirilmiş satırları bırakın. “Anonimleştirilmiş bir sorgu, tabloda sıfır uzunluklu bir dize olarak raporlanır” — bu yüzden WHERE query != '' ekleyin.
  • Konum sıfır tabanlıdır. Her iki tablo da konumu 0’dan başlayarak saklar, bu yüzden ortalama konum SUM(sum_top_position) / SUM(impressions) + 1’dir (1’i ekleyin).

Google, günlük web arama istatistikleri, ülkeye göre en iyi mobil sorgular, tıklamalara göre Discover URL’leri, SSS zengin sonuç performansı (is_tpf_faq = true) ve REGEXP_CONTAINS ile marka sorgusu takibi için örnek sorgular sunar. Bunlardan başlayın.

Dışa aktarımı yönetme ve sorun giderme

Toplu veri dışa aktarımlarını yönetme ve izleme bölümünden:

  • Durdurma anında gerçekleşmez. Ayarlar → Toplu veri dışa aktarımı → Dışa aktarımı devre dışı bırak. “Toplu dışa aktarımlar önümüzdeki 24 saat içinde durdurulacak,” bu yüzden kapattıktan sonra bir gün daha veri gelebilir.
  • İki başarısızlık eşiği, tek değil. “Search Console, başarısız dışa aktarımlardan gelen verileri yaklaşık bir hafta boyunca saklar.” Ve sonra: “Search Console, belirli bir tarih için veri dışa aktarmayı yaklaşık bir haftalık başarısız denemeden sonra durdurmayı bırakacak ve yaklaşık bir aylık başarısız dışa aktarma denemesinden sonra Search Console toplu dışa aktarımı tamamen durduracaktır.” Yani kalıcı bir sorun sadece günleri atlamaz — yaklaşık bir ay sonra tüm dışa aktarımı kapatır ve yeniden kurmanız gerekir.
  • Şema değişikliği tuzağı (ve bölüm sona erme tabanı). Dışa aktarılan bir tablonun şemasını değiştirirseniz, dışa aktarımı bozarsınız. Google ayrıca dışa aktarma veri kümesinde en az 14 gün bölüm sona erme süresi gerektirir — daha kısa ayarlarsanız dışa aktarım başarısız olabilir. Bu tablolara dokunmayın; bunun yerine kendi türetilmiş tablolarınızı oluşturun. (Diğer yaygın başarısızlık nedenleri arasında Cloud projenizin kotasını aşmak ve hizmet hesabının erişimini iptal etmek yer alır.)
  • Test raporunu kullanın. Belirli düzeltilebilir sorunları — proje kimliği/kimlik bilgileri, izinler — bir sonraki zamanlanmış çalıştırmayı beklemeden doğrulamanıza olanak tanıyan bir “Test raporu” özelliği vardır. Anında yeniden dışa aktarma yapmadığını unutmayın; düzeltmenin işe yaradığını doğrulamak için yaklaşık 24 saat sonra tekrar kontrol edin.
  • Search Console, dışa aktarma hataları başladığında ve çözüldüğünde mülk sahiplerine e-posta gönderir ve Ayarlar en son dışa aktarma denemesinin durumunu gösterir.

Nerede duruyor: UI → API → toplu dışa aktarım

Bir merdivende, her biri altındakinin karşılaştığı bir sınırı kaldıran üç basamak düşünün:

  • UI dışa aktarımı — ~1 000 satır, ~16 ay, anonimleştirilmiş sorgu yok. Çoğu için yeterli.
  • Search Console API — daha fazla satır, yine de sınırlı ve hız sınırlı, yine anonimleştirilmiş sorgu yok. Geçici ve programatik çekmeler için iyi.
  • Toplu veri dışa aktarımı — satır sınırı yok, kontrol ettiğiniz saklama, günlük ayrıntılı veri, veri ambarı ve birleştirmeler için tasarlandı. Yine anonimleştirilmiş sorgu yok. Geriye dönük doldurma yapmaz.

Ve eski kılavuzların yanlış anladığı bir nüans: artık Cloud projesi başına tek bir mülkle sınırlı değilsiniz. Google daha sonra, farklı searchconsole_ önekli veri kümesi adları kullanarak tek bir projeye birden fazla mülkün eklenmesine izin verdi.

Peki ya Bing?

Bu yazının yazıldığı sırada, yerel bir eşdeğeri yok. Bing Webmaster Tools, birinci taraf BigQuery/toplu dışa aktarım sunmuyor — bu yüzden Bing Webmaster Tools verilerini BigQuery’ye taşımak için üçüncü taraf ETL bağlayıcıları (Supermetrics, Improvado, Catchr ve diğerleri) pazarının var olmasının nedeni tam olarak bu. Bing’in yerel bir hattı olsaydı, bu pazar olmazdı. Bununla birlikte, bir bağlayıcının GSC’nin kendi dışa aktarma şemasını veya günlük bölümleme davranışını alan alan kopyalayacağı garanti edilmez — eşitlik varsaymadan önce herhangi bir bağlayıcının belgelenmiş kapsamını kontrol edin. Bu nedenle, GSC dışa aktarımınızın yanında BigQuery’de Bing verileri istiyorsanız, bir bağlayıcı için bütçe ayırın ve gerçekte ne teslim ettiğini doğrulayın. (Alıntı yapmadan önce bunun hâlâ güncel olduğunu doğrulayın — Bing’in kendi özellik seti değişebilir.)

Bunun nerede durduğuna dair daha geniş bağlam için, Search Engine Tools merkezine ve Google Search Console ile Bing Webmaster Tools hakkındaki kılavuzlarına bakın.

Add an expert note

Pin an expert quote

New person? Create their unclaimed profile at /admin/experts/ → Pin a quote first.