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