الاستيراد من Google Analytics 4

1. ما يدخل وما لا يدخل

يقرأ المساران من حساب Google الخاص بك ويُفعّلان منفصلين. يجيبان عن سؤالين مختلفين ولا تحتاج كليهما.

المسار	ما يجلبه	الغرض
Data API	الإجماليات اليومية: الجلسات والمستخدمون ومشاهدات الصفحات والجلسات المتفاعلة	سؤال التغطية. يحسب GA4 عدد 3,000 جلسة ويسجّل MousePlayer عدد 40 — دون رقم مرجعي لا تلاحظ الفرق أصلًا.
استيراد BigQuery	جلسات GA4 الفردية بأحداثها	ما حدث خلال زيارة لم يتمكن MousePlayer من تسجيلها.

يعيش الاستيراد في جداول مستقلة ولا يُخلط بتسجيلاتك مطلقًا. وإلا تغيّر معنى كل رقم مشتق بصمت — ملفات السلوك وتقييم الزائر وتحليل العوائق — ولن يعرف أحد لاحقًا ما قِيس وما جُلب.

2. المسار 1: Data API

تحتاج معرّف الموقع ومفتاح حساب خدمة.

معرّف الموقع ليس معرّف القياس

هذا أكثر أسباب الإخفاق شيوعًا، ولا تذكره رسالة خطأ Google. معرّف القياس يبدو مثل G-ABC123XYZ، ويوجد في مقتطف التتبع وظاهر في كل مكان. معرّف الموقع رقمي فقط ويظهر في الإدارة تحت إعدادات الموقع. نحتاج الثاني؛ نرفض الأول بملاحظة بدل تركك تواجه 400.

إنشاء حساب الخدمة وتفويضه

• أنشئ حساب خدمة في Google Cloud Console وولّد مفتاح JSON.
• في المشروع نفسه، فعّل Google Analytics Data API.
• في GA4 ضمن الإدارة، إدارة الوصول للموقع، أضف بريد حساب الخدمة بدور مشاهد. حساب الخدمة مستخدم مستقل؛ دون هذه الخطوة يعيد Google الرمز 403 دون ذكر السبب.

الصق محتوى ملف JSON في الحقل. يُحفظ مشفّرًا ولا يُعرض بعد ذلك إلا مختصرًا.

3. المسار 2: استيراد BigQuery

يقرأ هذا المسار تصدير GA4 الخام. أعدّه مرة في GA4: الإدارة، روابط BigQuery. لا تظهر الجداول إلا في اليوم التالي — وقبل ذلك لا يجد الاستيراد شيئًا، وليس هذا عطلًا.

ما تدخله

• معرّف مشروع GCP الذي يحتوي التصدير. ليس بالضرورة المشروع الذي تصدّر بيانات MousePlayer إليه.
• معرّف مجموعة البيانات. يسميها GA4 analytics_<propertyId>.
• مفتاح حساب خدمة بدور BigQuery Data Viewer لمجموعة البيانات و BigQuery Job User للمشروع. تكفي القراءة؛ يرجى عدم منح أكثر.

التكلفة ومن يدفعها

يفوتر BigQuery بحسب البايتات المقروءة، والفاتورة لك. لذا يقرأ الاستيراد أيامًا قليلة في كل تشغيل ويجري استعلامًا واحدًا فقط — سيقرأ الثاني الجداول نفسها مجددًا. وفوق ذلك يوقف حد صارم الاستعلام قبل ارتفاع التكلفة؛ وتوضح الرسالة في سجل التسليم حينها أن النافذة الزمنية كبيرة جدًا.

الوتيرة

كل ست ساعات افتراضيًا، ويعيد كل تشغيل جلب آخر ثلاثة أيام. ليس اعتباطيًا: يُكمل GA4 بياناته حتى 48 ساعة، ولا يظهر التصدير اليومي إلا في اليوم التالي. زيادة الطلبات لا تمنح أرقامًا أحدث، بل نفسها.

4. المفتاح الرابط بين الطرفين

إذا ضبطت أيضًا جسر التحليلات على GA4، يسجّل MousePlayer معرّف العميل من ملف _ga مع كل جلسة. وهي القيمة نفسها التي يحملها تصدير BigQuery باسم user_pseudo_id.

بها تُطابق جلسة GA4 بأحد تسجيلاتك — وبالعكس ترى ما حسبه GA4 خلال الزيارة نفسها. دون الجسر يبقى الطرفان متجاورين دون ربط.

5. الموافقة والاحتفاظ والحذف

ما يدخل كان له ملف ارتباط

تُستورد فقط الصفوف ذات user_pseudo_id . عند رفض الزائر، يرسل GA4 زيارات دون ملفات ارتباط في Consent Mode ولا تحمل هذا المعرّف — فتُستبعد دون حاجة لوعد. تبقى الصفوف المنمذجة، أي المقدّرة، خارجًا للسبب نفسه: حفظ تقدير كجلسة يعني حفظ زيارات لم تحدث.

مدة البقاء

180 يومًا افتراضيًا، من اليوم الذي يصفه الصف — لا لحظة الاستيراد. وإلا لم تنتهِ المدة، لأن كل تشغيل يعيد جلب الأيام نفسها.

الحذف

عند طلب زائر محو بياناته، تُحذف جلساته المستوردة من GA4 أيضًا بقدر إسنادها عبر المعرّف أعلاه. حذف المشروع يحذفها في كل حال، بما فيها صفوف لم تتبع أحد تسجيلاتك. يتركها تنظيف الاحتفاظ اليومي عمدًا: لبيانات GA4 مدة مستقلة وتنتهي تسجيلاتك قبلها.

6. حين لا يصل شيء

يكتب كل تشغيل نتيجته في سجل التسليم بصفحة التكاملات — مع الإخفاقات بكلمات واضحة. غالبًا يوضح ما ينقص.

الرسالة	الإجراء
يجب أن يكون معرّف الموقع رقميًا فقط	أدخلت معرّف القياس. الرقم الصحيح في إعدادات موقع GA4.
HTTP 403 من Data API	حساب الخدمة ليس مشاهدًا لموقع GA4، أو لم تُفعّل Data API في مشروع GCP.
مجموعة البيانات أو جداول التصدير غير موجودة	رابط BigQuery مفقود أو اسم المجموعة مختلف أو لم يمضِ يوم بعد.
الوصول مرفوض (BigQuery)	يفتقر حساب الخدمة إلى BigQuery Data Viewer للمجموعة أو BigQuery Job User للمشروع.
كان الاستعلام سيقرأ أكثر من المسموح	أوقفه سقف التكلفة قبل احتساب أي رسوم. اختر نافذة زمنية أصغر.
لا جلسات في النافذة	ليس عطلًا. لم توجد جلسة بموافقة في الأيام المجلوبة.