Data Studio: بناء التقارير ببيانات AutoPSEO

لا يوفّر AutoPSEO موصّلًا لأداة Data Studio، وهي أداة لوحات المعلومات من Google التي كانت تُعرف سابقًا باسم Looker Studio. ومع ذلك يمكنك عرض أرقامه فيها بثلاث طرق: موصّل Search Console الرسمي من Google للحصول على البيانات الخام، أو ملف CSV مُصدَّر من أحد تقارير AutoPSEO، أو جدول Google Sheet يملؤه سكربت مجدوَل من REST API الخاص بـ AutoPSEO. يعتمد اختيارك على مدى حداثة البيانات التي تحتاجها اللوحة، وعلى ما إذا كانت تحتاج إلى تحليلات AutoPSEO أم تكفيها المقاييس الخام.

الخيار الأول: موصّل Search Console من Google

يقرأ موصّل Google بيانات Search Console مباشرة، لذلك يوفّر المقاييس الخام دون أي من تحليلات AutoPSEO. وفقًا لـدليل Google الخاص بالموصّل:

• يوفّر جدولين هما Site Impression وURL Impression، ويستخدم مصدر البيانات الواحد أحدهما فقط. أضف مصدرَي بيانات إلى التقرير لعرض الجدولين معًا.
• تحتاج إلى صلاحية عرض على الأقل على موقع Search Console، مع تسجيل الدخول إلى المنتجين بحساب Google نفسه.
• يغطي Site Impression نتائج الويب والصور والفيديو والأخبار، بينما يضيف URL Impression نتائج Discover وGoogle News.

للإضافة، اختر Create → Data Source → Search Console، ثم حدّد الموقع والجدول ونوع البحث الافتراضي، ثم اضغط Connect.

الخيار الثاني: رفع ملف CSV من AutoPSEO

للوحة تُنشأ مرة واحدة أو شهريًا، صدِّر جدولًا من أي تقرير (تصدير البيانات) وأضفه عبر موصّل رفع ملفات CSV في Data Studio. تحدد متطلبات الرفع من Google طريقة التصدير:

• يجب أن تكون الحقول مفصولة بفواصل، لذا اضبط Account → CSV export format على Standard (US / UK) أولًا.
• يجب أن يكون الملف بترميز UTF-8 ويحتوي على صف رأس، وهو ما تلتزم به ملفات AutoPSEO المُصدَّرة.
• يجب أن تحمل كل الملفات المضافة إلى مجموعة البيانات الأعمدة نفسها بالترتيب نفسه تمامًا، لذا صدِّر التقرير نفسه بالأعمدة وإعداد المقارنة نفسيهما في كل مرة.
• تُلحَق الملفات الجديدة ولا تُحذف التكرارات، فلا ترفع نطاقات زمنية متداخلة.
• يصل حجم الملف الواحد إلى 100 MB، ويحصل كل مستخدم على 2 GB من مساحة الرفع.

تُصدَّر النسب المئوية مع علامة النسبة (27.03%)، فتحقّق من أنواع الحقول بعد الرفع.

الخيار الثالث: جدول Google Sheet يُغذّيه REST API

للوحة تحدّث نفسها تلقائيًا، اجعل مهمة مجدولة تكتب أرقام AutoPSEO في جدول Google Sheet، ثم اربط الجدول باللوحة. يتحقق موصّل Sheets من Google من القيم المتغيّرة والصفوف الجديدة كلما استعلم التقرير عنه.

1. في AutoPSEO، افتح MCP & API وأنشئ مفتاح API بنطاق Read only. يظهر المفتاح مرة واحدة فقط، فاحفظه ضمن أسرار المهمة.
2. من المهمة المجدولة (Google Apps Script أو مهمة cron أو أداة سير عمل)، استدعِ REST API واكتب الصفوف في الجدول.
3. في Data Studio، أضف الجدول عبر موصّل Google Sheets وفعّل الخيار Use first row as headers.

يبدو استدعاء أهم الاستعلامات خلال آخر 28 يومًا على النحو التالي:

curl -s "https://app.autopseo.com/v1/properties/sc-domain%3Aexample.com/queries?range=28d&limit=1000" \
  -H "Authorization: Bearer apk_live_..."

تأتي كل استجابة بصيغة JSON، وتوجد النتيجة ضمن data وتفاصيل الاستدعاء ضمن meta. يقدّم REST API الأدوات التسع عشرة نفسها الخاصة بـ Search Console وGA4 التي يقدّمها خادم MCP: المواقع، وصفوف تحليلات البحث، وأهم الاستعلامات والصفحات والدول، ومقارنة الفترات، وتغيّرات الترتيب، والترتيبات الجديدة والمفقودة، وتراجع المحتوى، والتنافس الداخلي بين الصفحات، ومعيار CTR المرجعي، واستحواذ الصفحات على ترتيب غيرها، وفحص URL، وخرائط الموقع، والتعليقات التوضيحية، ونظرة GA4 العامة والتفصيل والأحداث الرئيسية. تُعيد أهم الاستعلامات وأهم الصفحات ما يصل إلى 1,000 صف، وأهم الدول ما يصل إلى 300، وsearch-analytics ما يصل إلى 5,000 صف خام لبُعد واحد أو بُعدين. تُحدَّد الاستدعاءات بـ 60 في الدقيقة لكل مفتاح و1,000 في الساعة لكل حساب، وتصف وثيقة OpenAPI 3.1 على https://app.autopseo.com/v1/openapi.json كل معامل.

أي خيار تختار

إذا كان الغرض الرئيسي من اللوحة هو عرض الأرقام على عميل، فقد يكون رابط التقرير المشترك أو تقرير Slack أو Teams المجدول أقل جهدًا. وتتناول مقالتنا في الأسئلة الشائعة حول Search Console في Looker Studio موصّل Google بمزيد من التفصيل.