ربط Google Analytics خطوة بخطوة

يتكوّن هذا الدليل من أربعة أجزاء. تقوم بها مرة واحدة. أبقِ علامتي تبويب مفتوحتين في المتصفح: Kaam360 وGoogle.

ما الذي ستحصل عليه في النهاية

شيئان تلصقهما في Kaam360:

• رقم الخاصية (property number): أرقام فقط، مثل 412345678.
• ملف المفتاح (JSON): ملف نصي تتيح لك Google تنزيله. تلصق محتواه كاملًا.

الجزء 1. اعثر على رقم الخاصية

1. افتح analytics.google.com وسجّل الدخول.
2. اضغط على أيقونة الترس (Admin) في أسفل اليسار.
3. في العمود الأوسط (Property) اضغط على Property details. وإذا كانت لديك عدة خصائص فاختر الخاصية الصحيحة من الأعلى أولًا.
4. في أعلى اليمين سترى PROPERTY ID. وهو رقم. انسخه.

الجزء 2. فعّل Google Analytics Data API

1. افتح console.cloud.google.com وسجّل الدخول بحساب Google نفسه.
2. في الأعلى اضغط على منتقي المشاريع ثم اضغط New project. سمّه "Kaam360 stats" واضغط Create. تأكد من أنه محدّد.
3. في مربع البحث في الأعلى اكتب Google Analytics Data API وافتح النتيجة.
4. اضغط Enable وانتظر بضع ثوانٍ.

الجزء 3. أنشئ ملف المفتاح

1. في صفحة Google Cloud نفسها افتح القائمة، ثم IAM & Admin، ثم Service accounts.
2. اضغط Create service account. سمّه "kaam360-reader". اضغط Create and continue ثم Done. لا تحتاج إلى اختيار أي دور.
3. اضغط على حساب الخدمة الجديد في القائمة. انسخ عنوان بريده الإلكتروني. يبدو هكذا kaam360-reader@kaam360-stats.iam.gserviceaccount.com.
4. افتح تبويب Keys. اضغط Add key ثم Create new key واختر JSON واضغط Create.
5. سيتم تنزيل ملف صغير إلى حاسوبك. احتفظ به سريًّا، مثل كلمة المرور.

الجزء 4. اسمح لحساب الخدمة برؤية أرقامك

1. ارجع إلى Google Analytics واضغط على أيقونة الترس (Admin).
2. في عمود Property اختر Property access management.
3. اضغط على الزر الأزرق + ثم Add users.
4. الصق عنوان البريد الإلكتروني لحساب الخدمة الذي نسخته.
5. اختر الدور Viewer. أزل العلامة من "Notify new users by email" إذا ظهرت. ثم اضغط Add.

الجزء 5. ضعه في Kaam360

1. افتح التسويق ثم زيارات الموقع ثم موقعك.
2. تحت من أين تأتي الأرقام؟ اختر Google Analytics 4.
3. الصق رقم الخاصية في رقم موقع Google Analytics.
4. افتح الملف الذي نزّلته باستخدام Notepad (في Windows) أو TextEdit (في Mac). حدّد كل المحتوى وانسخه والصقه في ملف مفتاح Google (JSON). يبدأ بالرمز { وينتهي بالرمز }.
5. اضغط حفظ ثم اختبار الاتصال.
6. تعني الرسالة الخضراء أنك انتهيت. تظهر الأرقام في صفحة زيارات الموقع وتتحدّث كل 10 دقائق.

هل أحتاج إلى تغيير أي شيء في موقعي؟

لا. إذا كان موقعك يحتوي أصلًا على رمز Google Analytics فاتركه كما هو تمامًا. يقرأ Kaam360 الأرقام من Google، لذلك لا يُضاف شيء إلى موقعك ولا حاجة إلى رمز عدّاد Kaam360.

إذا فشل الاختبار

• رسالة "Permission" أو "403": لم يتم الجزء 4، أو أضفت بريدًا إلكترونيًا خاطئًا. تأكد من أن بريد حساب الخدمة موجود في Property access management بالدور Viewer. قد تحتاج التغييرات إلى بضع دقائق لتعمل.
• رسالة "API has not been used" أو "disabled": لم يتم الجزء 2 في مشروع Google Cloud نفسه الذي ينتمي إليه المفتاح. فعّل Google Analytics Data API هناك.
• رسالة "Property not found": لصقت رقمًا خاطئًا. استخدم الأرقام من Property details وليس رمز G-.
• رسالة "Key file is not valid": لم تنسخ الملف كاملًا. انسخ من أول { إلى آخر }.
• رسالة "Connected ... 0 page views from 0 visitors": الاتصال يعمل، لكن رقم الخاصية يعود إلى خاصية مختلفة عن التي تستقبل زيارات موقعك. لدى كثير من الحسابات أكثر من خاصية. في Google Analytics اختر الخاصية التي تُظهر زياراتك (من أعلى اليسار)، ثم افتح Admin ثم Property details وانسخ PROPERTY ID الخاص بها. الصقه في Kaam360 واضغط حفظ ثم اختبار الاتصال مرة أخرى.
• الأرقام صفر: تحتاج الخاصية الجديدة إلى يوم لجمع البيانات. تأكد من أن موقعك يحتوي فعلًا على وسم Google Analytics.

كيف تتراجع

احذف حساب الخدمة في Google Cloud، أو أزله من Property access management. عندها لا يعود Kaam360 قادرًا على قراءة أي شيء.