بيت فريزيلا، مسؤول علاقات المطوّرين لدى "إحصاءات Google" – تموز (يوليو) 2013
يتناول هذا المستند الخادم الوكيل الخارق لخدمة "إحصاءات Google" ويوضّح كيفية البدء واستخدام ميزات محدّدة ويناقش الاعتبارات المهمة.
مقدمة
يسمح لك SuperProxy في "إحصاءات Google" بمشاركة بيانات إعداد تقارير "إحصاءات Google" بشكل علني. ويمكنك استخدامها لتشغيل لوحات البيانات والتطبيقات المصغّرة المخصّصة، وتحويل الردود إلى تنسيقات مختلفة، وإجراء اختبارات، وغير ذلك الكثير.
يعمل SuperProxy في "إحصاءات Google" مع واجهة برمجة التطبيقات الأساسية لإعداد التقارير وواجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي وواجهة برمجة التطبيقات لإعداد التقارير للمسارات المتعددة القنوات.
أبرز الميزات:
- مشاركة بياناتك في "إحصاءات Google" علنًا.
- يمكنك استخدام الخادم الوكيل لتشغيل لوحات البيانات المخصّصة.
- التحويل إلى ملف CSV أو جدول البيانات أو TSV.
- يُسمح باستخدام التواريخ النسبية (على سبيل المثال، آخر 7 أيام).
- تتم إعادة تحميل بيانات التقارير تلقائيًا.
- التخزين المؤقت - ردود سريعة واستخدام فعال للحصة.
كيفية العمل
أنشئ طلب بحث لبياناتك في "إحصاءات Google"، وستكون بيانات إعداد التقارير المحدّدة متاحة للجميع على عنوان URL جديد يمكنك مشاركته. سيتمكّن أي شخص يزور عنوان URL من الوصول إلى بيانات الإبلاغ بدون الحاجة إلى أي إذن.
على سبيل المثال، يمكنك إنشاء طلب بحث لعرض أهم 10 متصفّحات استنادًا إلى مشاهدات الصفحة على الويب خلال الأسبوع الماضي وطلب بحث واحد لعدد الجلسات التي تمت بالأمس، وهكذا. ويمكنك تحديد طلبات البحث التي تريد عرضها بشكل علني وعدد المرات التي تريد تعديل البيانات فيها، وسيتولى الخادم الوكيل المميّز لخدمة "إحصاءات Google" الاهتمام بالباقي.
نصيحة:يمكنك استخدام
مستكشف طلبات البحث لإنشاء
تقارير ثم نسخ Query URI لاستخدامها مع
"إحصاءات Google" SuperProxy
إعداد استعلام وإنشاؤه
يُعد SuperProxy من "إحصاءات Google" تطبيق ويب يتم تشغيله في بيئة Google App Engine. يمكنك تنزيل هذا التطبيق ونشره من خلال اتّباع مجموعة بسيطة من التعليمات.
إدارة المستخدمين
يشتمل الخادم الوكيل الفائق لخدمة "إحصاءات Google" على واجهة بسيطة لإدارة المستخدمين يمكنك استخدامها لإضافة مستخدمين. سيكون بإمكان كل مستخدم إدراج وإدارة طلبات البحث الخاصة بواجهة برمجة التطبيقات التي ينشئها فقط.
يمكن للمشرفين فقط إدارة المستخدمين. لإضافة مستخدم جديد:
- من واجهة مشرف الخادم الوكيل الفائق في "إحصاءات Google" (على سبيل المثال
https://your-application-id.appspot.com/admin)، انقر على الزر إدارة المستخدمين. - في صفحة إدارة المستخدمين، أدخِل عنوان البريد الإلكتروني للمستخدم الذي تريد إضافته وانقر على الزر إضافة مستخدم. ستتم إضافة المستخدم ولكنه لن يتمكّن من الوصول إلى أن يتم تفعيل الحساب.
- اطلب من المستخدم تفعيل حسابه بالانتقال إلى صفحة
/admin/activate. مثال:https://your-application-id.appspot.com/admin/activateيجب تسجيل الدخول إلى حساب Google للبريد الإلكتروني الذي أضفته لكي تتم عملية التفعيل. - بعد تفعيل المستخدم لحسابه بنجاح، سيتمكّن من زيارة صفحة
/adminوالسماح بالوصول إلى حسابه على "إحصاءات Google" والبدء في إنشاء طلبات البحث الخاصة بواجهة برمجة التطبيقات.
المستخدمون المشرفون
تتم إضافة المستخدمين المشرفين على SuperProxy في "إحصاءات Google" باستخدام وحدة التحكّم الإدارية في App Engine. وسيكون أي مستخدم تتم إضافته من خلال وحدة التحكم هذه، أيًا كان دوره، مشرفًا.
ويمكن للمشرفين إدراج وإدارة طلبات البحث الخاصة بواجهة برمجة التطبيقات الخاصة بأي مستخدم.
قيود النطاق
في بعض الحالات، قد تحتاج إلى الاستفادة من الميزات التي يوفّرها Google Analytics SuperProxy ولكن لا تريد جعل أي بيانات علنية خارج نطاق مجموعة محدّدة من المستخدمين أو النطاقات. بالنسبة إلى أي تطبيق مجاني تتم استضافته على App Engine، بشكل تلقائي، يمكن لأي مستخدم سجّل الدخول باستخدام حساب Google الوصول إلى نقاط النهاية العامة.
إذا أردت فرض قيود إضافية على الوصول إلى تطبيقك، عليك تنفيذ طبقة المصادقة الخاصة بك أمام الخادم الوكيل الفائق لخدمة "إحصاءات Google" أو استخدام G Suite، ما يتيح لك حصر إمكانية الوصول إلى المستخدمين الخاضعين لإدارة نطاقك. راجع تهيئة مصادقة التطبيق للحصول على مزيد من التفاصيل.
اعتبارات الحصص
يساعدك SuperProxy في "إحصاءات Google" على توفير الحصة من خلال عرض بيانات إعداد التقارير من ذاكرة التخزين المؤقت/مخزن البيانات. ومع ذلك، قد يؤدي ضبط فترات إعادة تحميل قصيرة إلى استهلاك حصة من المساحة بسرعة. لتجنّب حدوث ذلك، تأكَّد من إعادة تحميل طلبات البحث على فترة معقولة لنوع البيانات المطلوبة.
App Engine
إنّ حدود الحصة التلقائية المجانية لتطبيقات App Engine كبيرة وستكون كافية على الأرجح لمعظم حالات الاستخدام. مع ذلك، يمكنك تفعيل الفوترة لزيادة الحدود القصوى التلقائية أو إزالتها. يُرجى الاطّلاع على حصص بيئة App Engine للحصول على تفاصيل.
المنتدى وأداة تتبُّع المشاكل
إنّ منتدى "إحصاءات Google" SuperProxy هو مجموعة مناقشة تتيح لك طرح الأسئلة ومشاركة الأفكار والحصول على ملاحظات بشأن مشاريعك الرائعة.
أداة تتبُّع المشاكل هي المكان الذي يمكنك فيه الإبلاغ عن المشاكل وتتبُّع طلبات الميزات الخاصة بخدمة "إحصاءات Google" SuperProxy.