بلاگ ادپیکس

خروجی گرفتن از گوگل آنالیتیکس: قبل از قطع دسترسی، تاریخچه GA4 را نجات دهید

سه روش خروجی گرفتن از گوگل آنالیتیکس (دانلود گزارش، Data API و BigQuery)، هر کدام چه چیزی را نگه می‌دارد و کدام بخش تاریخچه با هیچ خروجی برنمی‌گردد.

۱۰ دقیقه مطالعه

خلاصه مطلب

  • برای خروجی گرفتن از GA4 سه راه دارید: دانلود گزارش به شکل CSV، PDF یا Google Sheets، گرفتن داده گزارش ها با Analytics Data API و اتصال پراپرتی به BigQuery برای داده خام رویدادها.
  • قبل از هر خروجی، مدت نگهداری داده رویدادها را روی ۱۴ ماه بگذارید؛ گوگل تنظیم طولانی تر را روی داده ای هم اعمال می‌کند که قبلا جمع شده است.
  • هر فایل CSV یا Sheets تا ۱۰۰ هزار ردیف جا دارد؛ برای گزارش ماهانه کانال ها و صفحه های ورود کافی است، برای داده خام نه.
  • خروجی BigQuery تا ۲۴ ساعت بعد از اتصال شروع می‌شود و صفحه راهنمای گوگل از پرکردن روزهای قبل حرفی نمی‌زند؛ پس فقط روزهای بعد از اتصال را نجات می‌دهد.
  • داده اکسپلوریشن قدیمی تر از بازه نگهداری، داده سن و علاقه مندی قدیمی تر از دو ماه و روزهایی که خروجی BigQuery جا انداخته با هیچ روشی برنمی‌گردد.

برای خروجی گرفتن از گوگل آنالیتیکس سه راه دارید: گزارش ها را از منوی Share this report به شکل CSV، PDF یا Google Sheets دانلود کنید، داده گزارش ها را با Google Analytics Data API بگیرید، یا پراپرتی را به BigQuery وصل کنید تا داده خام و بدون نمونه برداری رویدادها را داشته باشید. دانلود گزارش سریع ترین راه است و کدنویسی نمی‌خواهد. BigQuery بیشترین جزئیات را نگه می‌دارد ولی فقط از روز اتصال به بعد. قبل از همه این ها مدت نگهداری داده را روی ۱۴ ماه بگذارید؛ همین یک تنظیم از هر خروجی دیگری تاریخچه بیشتری نجات می‌دهد.

خروجی داده GA4 یعنی هر نسخه ای از داده گوگل آنالیتیکس ۴ که بیرون از پنل GA4 نگه داشته می‌شود؛ یا جدول های تجمیعی گزارش (CSV، Sheets، API) یا ردیف های خام رویداد (BigQuery)، تا اگر دسترسی به پراپرتی قطع شد هنوز بتوانید آن را بخوانید.

چرا همین حالا باید از GA4 خروجی بگیرید؟

چون تاریخچه GA4 طبق برنامه پاک می‌شود و بخشی از آن دیگر قابل ساختن نیست. داده سطح رویداد که اکسپلوریشن ها و گزارش قیف با آن کار می‌کنند، در پراپرتی استاندارد فقط دو یا ۱۴ ماه می‌ماند. داده سن، جنسیت و علاقه مندی همیشه دو ماه نگه داشته می‌شود، هر تنظیمی هم که داشته باشید.

برای سایت های ایرانی یک ضرب الاجل دوم هم هست: تیم با VPN وارد GA4 می‌شود و پراپرتی معمولا در جیمیل شخصی یک نفر است. قطع شدن دسترسی تاریخ مشخصی ندارد. مطلب گوگل آنالیتیکس در ایران و ریسک هایش این ریسک را با جزئیات بررسی کرده است.

خروجی حتی وقتی اتفاقی نیفتاده هم به کار می‌آید. یک CSV ماهانه از عملکرد کانال ها کمک می‌کند امسال را با پارسال مقایسه کنید، حتی بعد از اینکه بازه اکسپلوریشن بسته شده، و وقتی ابزار دوم را کنار GA4 نصب می‌کنید یک خط مبنا دارید.

از کدام داده های GA4 می‌شود خروجی گرفت و چطور؟

هر روش لایه متفاوتی از داده را نگه می‌دارد. انتخاب را بر اساس سوالی بکنید که بعدا باید جواب بدهید، نه بر اساس اینکه امروز کدام راحت تر است.

روش چه چیزی می‌گیرید محدودیت (طبق مستندات گوگل) چه کسی می‌تواند
دانلود گزارش (Share this report ← Download File) جدول تجمیعی گزارش به شکل PDF، CSV یا Google Sheets هر فایل CSV یا Sheets تا ۱۰۰ هزار ردیف هر کسی با نقش Viewer
Analytics Data API همان دایمنشن ها و متریک های گزارش، با اسکریپت و زمان بندی مصرف با توکن سهمیه برای هر پراپرتی، ساعتی و روزانه برنامه نویس با دسترسی به پراپرتی
خروجی BigQuery رویدادهای خام و بدون نمونه برداری، هر روز یک جدول روزانه ۱ میلیون رویداد برای پراپرتی استاندارد؛ از بعد از اتصال نقش Editor روی پراپرتی و Owner روی پروژه Cloud

بیشتر سایت های کوچک و متوسط ایرانی فقط ردیف اول را لازم دارند. دو روش دیگر برای تیم هایی است که با SQL یا اسکریپت کار می‌کنند یا داده سطح کاربر می‌خواهند.

چطور گزارش GA4 را به CSV یا اکسل دانلود کنیم؟

گزارش را باز کنید، بالا سمت راست روی Share this report بزنید، Download File را انتخاب کنید و یکی از Download PDF، Download CSV یا Export to Google Sheets را بزنید. نقش Viewer در سطح پراپرتی کافی است. هر فایل CSV یا Sheets تا ۱۰۰ هزار ردیف دارد و وقتی گزارش در حالت Customize report باز است نمی‌شود خروجی گرفت. فایل CSV را مستقیم در اکسل باز می‌کنید.

یک روال که برای بیشتر تیم ها جواب می‌دهد:

  1. اول مدت نگهداری را بالا ببرید. در Admin به Data settings ← Data retention بروید و داده رویدادها را روی ۱۴ ماه بگذارید. گوگل تنظیم طولانی تر را روی داده ای هم که قبلا جمع شده اعمال می‌کند. این کار نقش Editor می‌خواهد.
  2. گزارش هایی را که تیم واقعا باز می‌کند فهرست کنید. معمولا traffic acquisition، صفحه های ورود، تبدیل ها یا key events و خریدهای فروشگاه.
  3. بیشترین بازه تاریخی را انتخاب کنید و دایمنشن دومی را که استفاده می‌کنید، مثل session source / medium، اضافه کنید. خروجی فقط همان چیزی را دارد که جدول نشان می‌دهد.
  4. برای هر چیزی که بعدا تحلیلش می‌کنید CSV بگیرید، نه PDF. PDF برای خواندن است و CSV برای مقایسه.
  5. اسم فایل ها را یکدست بگذارید، مثلا ga4_traffic-acquisition_2025-11_2026-10.csv، و در پوشه ای نگه دارید که مال شرکت است، نه حساب شخصی یک نفر.
  6. اول هر ماه تکرار کنید، تا وقتی GA4 روی سایت است.

یک مثال فرضی. فرض کنید یک فروشگاه آنلاین لوازم خانگی ۴۰۰ صفحه ورود دارد و گزارش صفحه های ورود را با session source / medium خروجی می‌گیرد؛ حدود ۳۵ ترکیب منبع و رسانه دارد (اینستاگرام، تلگرام، گوگل، ترب، پیامک و…). بدترین حالت ۴۰۰ × ۳۵ = ۱۴ هزار ردیف است، خیلی کمتر از سقف ۱۰۰ هزار ردیف. اگر دایمنشن تاریخ را روزانه برای یک سال اضافه کنید، همین جدول می‌تواند به ۱۴٬۰۰۰ × ۳۶۵ ≈ ۵٫۱ میلیون ردیف برسد که در هیچ دانلودی جا نمی‌شود. راه حل این است که هر ماه را جدا و با دایمنشن ماه خروجی بگیرید، یا جزئیات روزانه را فقط برای صفحه های پربازدید نگه دارید.

چه وقت به جای دانلود از Data API استفاده کنیم؟

وقتی همان گزارش را هر هفته لازم دارید، چند پراپرتی دارید یا ترکیب های دایمنشن آن قدر زیاد است که کلیک کردنشان وقت تلف کردن است. یک اسکریپت می‌تواند دایمنشن ها و متریک ها را برای یک بازه تاریخی بگیرد و در یک شیت یا دیتابیس بریزد و روال دستی ماهانه را حذف کند.

دو نکته را از قبل در نظر بگیرید. اول اینکه API داده تجمیعی شبیه گزارش ها برمی‌گرداند، نه رویداد خام؛ پس برای تحلیل سطح کاربر جای BigQuery را نمی‌گیرد. دوم اینکه گوگل مصرف را با توکن سهمیه برای هر پراپرتی، به صورت ساعتی و روزانه، حساب می‌کند و کوئری بزرگ تر توکن بیشتری مصرف می‌کند. عددهای فعلی در صفحه سهمیه گوگل است؛ قبل از اینکه یک خروجی بزرگ از کل تاریخچه را زمان بندی کنید آن را چک کنید و بازه های طولانی را به درخواست های ماهانه بشکنید.

خروجی BigQuery در GA4 را چطور راه بیندازیم؟

یک پروژه Google Cloud بسازید یا انتخاب کنید، BigQuery API را فعال کنید و بعد در GA4 به Admin ← Product links ← BigQuery links ← Link بروید. پروژه و محل نگهداری داده را انتخاب کنید، استریم ها و رویدادهایی را که می‌خواهید مشخص کنید و Daily export، Streaming export یا هر دو را بزنید. نقش Editor روی پراپرتی GA4 و نقش Owner روی پروژه BigQuery لازم است.

کاری که این خروجی می‌کند، طبق مستندات گوگل:

  • خروجی روزانه همه رویدادهای خام و بدون نمونه برداری روز قبل را در یک جدول روزانه (events_YYYYMMDD) می‌نویسد. پراپرتی استاندارد روزانه تا ۱ میلیون رویداد خروجی دارد.
  • خروجی استریم رویدادها را ظرف چند دقیقه به یک جدول intraday می‌فرستد. گوگل آن را best effort می‌داند، بدون تضمین کامل بودن، و می‌گوید منبع ورود کاربران جدید را ندارد. پس خروجی روزانه را مرجع بدانید.
  • داده تا ۲۴ ساعت بعد از اتصال می‌رسد. صفحه راهنمای گوگل از پرکردن روزهای قبل حرفی نمی‌زند، پس شروع خروجی را همان روز اتصال حساب کنید.
  • بالاتر از سقف، متوقف می‌شود. اگر پراپرتی مدام از ۱ میلیون رویداد در روز بیشتر شود، خروجی روزانه متوقف می‌شود و روزهای قبل دوباره پردازش نمی‌شود. فیلتر رویداد روی اتصال کمک می‌کند زیر سقف بمانید.

درباره هزینه: اتصال رایگان است و سایت کوچک می‌تواند با سندباکس BigQuery شروع کند، اما سقف های سندباکس اعمال می‌شود؛ صفحه راهنما برای پروژه رایگان سقف ۱۰ گیگابایت را نام می‌برد و بیشتر از سندباکس هزینه دارد. خروجی استریم گیگابایتی ۰٫۰۵ دلار است و گوگل می‌گوید هر گیگابایت تقریبا ۶۰۰ هزار رویداد است. برای تیم ایرانی مشکل اصلی معمولا مبلغ نیست، پرداخت ارزی و ساختن حساب Google Cloud است؛ صفحه راهنما می‌گوید برای ادامه خروجی باید روش پرداخت معتبر در Cloud ثبت باشد.

یک مثال فرضی. سایتی که روزی ۳۰ هزار رویداد ثبت می‌کند، ماهی حدود ۹۰۰ هزار رویداد دارد. با قاعده سرانگشتی گوگل (۶۰۰ هزار رویداد در هر گیگابایت) این حدود ۱٫۵ گیگابایت در ماه است و استریم کردنش ماهی حدود ۱٫۵ × ۰٫۰۵ ≈ ۰٫۰۸ دلار هزینه دارد. با همین نسبت، سندباکس ۱۰ گیگابایتی بعد از حدود ۱۰ × ۶۰۰٬۰۰۰ ÷ ۹۰۰٬۰۰۰ ≈ ۶٫۷ ماه پر می‌شود. محدودیت واقعی بیشتر تیم ها هزینه نیست؛ داشتن کسی است که روی جدول های رویداد SQL بنویسد.

کدام داده های GA4 دیگر برنمی‌گردد؟

بعضی از دست رفتن ها دائمی است و دانستنشان می‌گوید اول از چه چیزی خروجی بگیرید.

داده از دست رفته چرا برنمی‌گردد
داده اکسپلوریشن و گزارش قیف قدیمی تر از بازه نگهداری داده سطح رویداد بعد از دو یا ۱۴ ماه پاک می‌شود؛ گزارش های استاندارد تجمیعی اثر نمی‌پذیرند
داده سن، جنسیت و علاقه مندی قدیمی تر از دو ماه گوگل همیشه برای آن نگهداری دو ماهه اعمال می‌کند
رویدادهای قبل از اتصال BigQuery خروجی از بعد از اتصال شروع می‌شود و از پرکردن گذشته حرفی زده نشده
روزهایی که خروجی BigQuery جا انداخت گوگل روزهایی را که به خاطر روش پرداخت نامعتبر یا توقف خروجی از دست رفته دوباره نمی‌فرستد
داده ای که با کم کردن مدت نگهداری پاک شد با کوتاه کردن مدت، داده قدیمی تر در پردازش ماهانه بعدی پاک می‌شود؛ فقط ۲۴ ساعت فرصت برگرداندن دارید

قاعده عملی این است: گزارش های تجمیعی بیشتر از همه می‌مانند، پس خروجی CSV از آن ها تور ایمنی شماست. هر داده سطح رویدادی از همان روزی که جمع شده یک ساعت شمارش معکوس دارد.

بعد از خروجی گرفتن، اندازه گیری را چطور ادامه دهید؟

خروجی گذشته را منجمد می‌کند، ولی ماه بعد را ثبت نمی‌کند. اگر دلیل خروجی گرفتن ریسک قطع دسترسی به GA4 است، نیمه دوم برنامه این است که از همین حالا داده را در ابزاری جمع کنید که در اختیار خودتان است.

ادپیکس پلتفرم آنالیتیکس وب برای تیم های ایرانی است: گزارش های هم سطح گوگل آنالیتیکس (ریل تایم، منابع ورودی، رفتار کاربران، قیف تبدیل و فروش) به علاوه لایه سنجش مارکتینگ، روی زیرساخت داخل ایران و با داشبورد فارسی. ادپیکس کنار گوگل آنالیتیکس کار می‌کند و تداخلی ندارد، پس می‌توانید امروز کنار GA4 نصبش کنید و چند هفته هر دو را مقایسه کنید. بدون VPN باز می‌شود و هر وقت بخواهید از داده ها خروجی می‌گیرید، که اگر مشکل خروجی شما را به اینجا رسانده مهم است. پلن رایگان ماهی ۱۰۰ هزار رویداد، ۳۰ روز داده خام و ۱۳ ماه داده تجمیعی دارد؛ پلن های بزرگ تر در صفحه تعرفه ادپیکس است. این مطلب فرض نمی‌کند ابزاری بتواند تاریخچه GA4 شما را وارد کند؛ پس آرشیو CSV را به عنوان سابقه سال های قبل از جابه جایی نگه دارید.

برای انتخاب ابزار، راهنمای جایگزین گوگل آنالیتیکس سه گزینه GA4، Matomo نصبی و ادپیکس را از نظر نمونه برداری، مدت نگهداری، محل میزبانی و هزینه مقایسه کرده است. برای اینکه ابزار جدید همان منابع ورودی و تبدیل های GA4 را ثبت کند، از پنج لایه راهنمای ترکینگ سایت استفاده کنید و پارامترهای UTM را در هر دو ابزار یکسان نگه دارید.

از کار دو دقیقه ای شروع کنید: Admin ← Data settings ← Data retention را باز کنید، آن را روی ۱۴ ماه بگذارید و بعد گزارش traffic acquisition را با کل بازه ای که دارید به CSV دانلود کنید.

همین امروز داده‌های سایت‌تان را بسنجید

پلن رایگان ادپیکس تا ۱۰۰ هزار رویداد در ماه، بدون کارت بانکی. راه‌اندازی کمتر از پنج دقیقه طول می‌کشد.

پرسش‌های متداول

چطور از گوگل آنالیتیکس ۴ خروجی بگیرم؟

گزارش را باز کنید، بالا سمت راست روی Share this report بزنید، Download File را انتخاب کنید و یکی از PDF، CSV یا Export to Google Sheets را بزنید. حداقل نقش Viewer روی پراپرتی لازم است و هر فایل CSV یا Sheets تا ۱۰۰ هزار ردیف دارد.

می‌شود داده های قدیمی GA4 را به BigQuery فرستاد؟

فرض را بر این بگذارید که نه. صفحه راهنمای گوگل می‌گوید داده تا ۲۴ ساعت بعد از اتصال به BigQuery می‌رسد و از پرکردن روزهای قبل حرفی نمی‌زند؛ پس هرچه زودتر وصلش کنید و تاریخچه قبل از آن را با دانلود گزارش ها نگه دارید.

GA4 داده ها را چند وقت نگه می‌دارد؟

پراپرتی استاندارد GA4 داده سطح رویداد و سطح کاربر را بسته به تنظیم Data retention دو یا ۱۴ ماه نگه می‌دارد و نسخه Analytics 360 مدت طولانی تری دارد. این تنظیم روی اکسپلوریشن ها و گزارش قیف اثر دارد، نه روی گزارش های استاندارد تجمیعی.

خروجی BigQuery در GA4 رایگان است؟

اتصال رایگان است و برای سایت های کوچک سندباکس BigQuery کار می‌کند، اما سقف های سندباکس اعمال می‌شود و بیشتر از آن هزینه دارد. خروجی استریم طبق گفته گوگل گیگابایتی ۰٫۰۵ دلار است و هر گیگابایت تقریبا ۶۰۰ هزار رویداد است.

سریع ترین راه بکاپ گرفتن از GA4 قبل از عوض کردن ابزار چیست؟

مدت نگهداری را ۱۴ ماه کنید، پنج تا ده گزارش پرکاربرد را با بیشترین بازه تاریخی به CSV دانلود کنید، هر ماه تکرار کنید و یک ابزار آنالیتیکس دوم کنار GA4 نصب کنید تا داده تازه جایی ثبت شود که در اختیار خودتان است.

منابع و روش

همه جمله های مربوط به خروجی GA4، مدت نگهداری داده و BigQuery از صفحه های Google Analytics Help و Google for Developers در فهرست منابع است که ۱۰ آبان ۱۴۰۵ (۱ نوامبر ۲۰۲۶) خوانده شده اند. سهمیه های Data API تغییر می‌کند، برای همین به جای عدد، به صفحه سهمیه گوگل ارجاع داده ایم. فروشگاه، ترافیک و حجم فایل ها در مثال ها فرضی است و محاسبه کامل آمده است. اطلاعات ادپیکس از سایت adpix.io است.

  1. Google Analytics Help: [GA4] Share & export reports
  2. Google Analytics Help: [GA4] Data retention
  3. Google Analytics Help: [GA4] Set up BigQuery Export
  4. Google Analytics Help: [GA4] BigQuery Export
  5. Google for Developers: Analytics Data API limits and quotas

این مطلب با کمک هوش مصنوعی نوشته شده و پیش از انتشار توسط تیم ادپیکس بازبینی شده است. سیاست تحریریه

درباره نویسندهبنیان‌گذار ادپیکس · سازنده ادپیکس

بنیان‌گذار ادپیکس، پلتفرم آنالیتیکس وب برای تیم‌های ایرانی. همه مطالب بلاگ پیش از انتشار زیر نظر او بازبینی می‌شوند.

آنالیتیکس وباتریبیوشنسنجش کمپین

داده‌ها را تحلیل کنید، با اطمینان بیشتری تصمیم بگیرید

با ادپیکس، عملکرد کمپین‌ها را تحلیل کنید و متناسب با نیاز کسب‌وکارتان پیش بروید.