تحليل محتوى رسالة واجهة برمجة التطبيقات باستخدام الإحصاءات المخصّصة

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

تجمع أداة Edge API Analytics وتحلل مجموعة متنوعة من المعلومات الإحصائية من كل طلب واستجابة من واجهة برمجة التطبيقات. يتم جمع هذه المعلومات تلقائيًا ويمكن بعد ذلك عرضها في واجهة مستخدم Edge أو باستخدام واجهة برمجة التطبيقات للمقاييس. اطّلع على metrics والسمات للحصول على مزيد من المعلومات عن هذه الإحصاءات.

يمكنك أيضًا جمع بيانات إحصائية مخصّصة خاصة بالخوادم الوكيلة لواجهة برمجة التطبيقات أو التطبيقات أو المنتجات أو المطوّرين. على سبيل المثال، قد تحتاج إلى جمع البيانات من مَعلمات طلب البحث أو عناوين الطلبات أو نصوص الطلبات والاستجابات أو المتغيرات التي تحدّدها في واجهات برمجة التطبيقات.

يوضح هذا الموضوع كيفية استخدام سياسة StatisticsCollector لاستخراج بيانات تحليلات مخصصة من طلب/استجابة واجهة برمجة التطبيقات وخلاصة تلك البيانات إلى تحليلات واجهة برمجة تطبيقات Edge. بعد ذلك، يوضّح الدليل طريقة عرض بيانات الإحصاءات في تقرير على واجهة مستخدم Edge أو من خلال استخدام Edge API.

معلومات عن Google Book API

يوضِّح هذا الموضوع طريقة الحصول على بيانات إحصاءات مخصّصة من طلبات الخادم الوكيل لواجهة برمجة التطبيقات إلى Google Books API. تتيح لك واجهة برمجة تطبيقات "كتب Google" البحث عن الكتب حسب العنوان والموضوع والمؤلف وغيرها من الخصائص.

على سبيل المثال، يمكنك إرسال طلبات إلى نقطة النهاية /volumes لإجراء بحث حسب عنوان الكتاب. تمرير مَعلمة طلب بحث واحدة إلى واجهة برمجة تطبيقات "الكتب" التي تحتوي على عنوان الكتاب:

curl https://www.googleapis.com/books/v1/volumes?q=davinci%20code

تعرض الاستدعاء مصفوفة JSON للعناصر التي تم العثور عليها والتي تطابق معايير البحث. يظهر أدناه عنصر الصفيف الأول في الاستجابة (لاحظ أنه تم حذف بعض المحتوى للتبسيط):

{
 "kind": "books#volumes",
 "totalItems": 1799,
 "items": [
  {
   "kind": "books#volume",
   "id": "ohZ1wcYifLsC",
   "etag": "4rzIsMdBMYM",
   "selfLink": "https://www.googleapis.com/books/v1/volumes/ohZ1wcYifLsC",
   "volumeInfo": {
    "title": "The Da Vinci Code",
    "subtitle": "Featuring Robert Langdon",
    "authors": [
     "Dan Brown"
    ],
    "publisher": "Anchor",
    "publishedDate": "2003-03-18",
    "description": "MORE THAN 80 MILLION COPIES SOLD ....",
    "industryIdentifiers": [
     {
      "type": "ISBN_10",
      "identifier": "0385504217"
     },
     {
      "type": "ISBN_13",
      "identifier": "9780385504218"
     }
    ],
    "readingModes": {
     "text": true,
     "image": true
    },
    "pageCount": 400,
    "printType": "BOOK",
    "categories": [
     "Fiction"
    ],
    "averageRating": 4.0,
    "ratingsCount": 710,
    "maturityRating": "NOT_MATURE",
    "allowAnonLogging": true,
    "contentVersion": "0.18.13.0.preview.3",
    "panelizationSummary": {
     "containsEpubBubbles": false,
     "containsImageBubbles": false
    },
...
   "accessInfo": {
    "country": "US",
    "viewability": "PARTIAL",
    "embeddable": true,
    "publicDomain": false,
    "textToSpeechPermission": "ALLOWED_FOR_ACCESSIBILITY",
    "epub": {
     "isAvailable": true,
     "acsTokenLink": "link"
    },
    "pdf": {
     "isAvailable": true,
     "acsTokenLink": "link"
    },
...
   }
  }

لاحظ أنه تم تمييز عدة جوانب من الرد:

  • عدد نتائج البحث
  • متوسط تقييم الكتاب
  • عدد التقييمات
  • مدى توفُّر نُسخ PDF من الكتاب

توضح الأقسام التالية طريقة جمع الإحصاءات لهذه المناطق من الإجابة وأيضًا لمعلمة طلب البحث q التي تحتوي على معايير البحث.

إنشاء خادم وكيل لواجهة برمجة تطبيقات Google Book API

قبل أن تتمكن من جمع الإحصاءات لواجهة برمجة تطبيقات Google Book API، يجب إنشاء خادم وكيل واجهة برمجة تطبيقات Edge يسميها. بعد ذلك، يمكنك استدعاء وكيل واجهة برمجة التطبيقات هذا لإرسال طلباتك إلى Google Book API.

الخطوة الثانية: إنشاء خادم وكيل لواجهة برمجة التطبيقات في الدليل التعليمي حول إنشاء خادم وكيل لواجهة برمجة التطبيقات، يصف كيفية إنشاء خادم وكيل يستدعي واجهة برمجة التطبيقات https://mocktarget.apigee.net. لاحظ أن الوكيل الموضح في هذا البرنامج التعليمي لا يتطلب مفتاح واجهة برمجة تطبيقات لاستدعائه.

استخدِم الإجراء نفسه لإنشاء خادم وكيل لواجهة برمجة التطبيقات لنقطة نهاية /volumes من Google Book API. في الخطوة 5 من الإجراء، عند إنشاء الخادم الوكيل لواجهة برمجة التطبيقات، اضبط السمات التالية للإشارة إلى واجهة برمجة التطبيقات في "كتب Google":

  • اسم الخادم الوكيل: "mybooksearch"
  • المسار الأساسي للخادم الوكيل: "/mybooksearch"
  • واجهة برمجة التطبيقات الحالية: "https://www.googleapis.com/books/v1/folders"

بعد إنشاء الخادم الوكيل ونشره، من المفترض أن تتمكّن من الاتصال به باستخدام أمر curl في النموذج:

curl http://org_name-env_name.apigee.net/mybooksearch?q=davinci%20code

حيث يحدد org_name وenv_name المؤسسة والبيئة حيث تم نشر الخادم الوكيل. مثلاً: 

curl http://myorg-test.apigee.net/mybooksearch?q=davinci%20code

جمع بيانات الإحصاءات المخصّصة

جمع البيانات الإحصائية من طلب واجهة برمجة التطبيقات هو إجراء من خطوتين:

  1. استخراج البيانات التي تهمك واكتبها إلى متغير.

    تأتي جميع البيانات التي يتم تمريرها إلى إحصاءات واجهة برمجة تطبيقات Edge من القيم المخزَّنة في المتغيرات. يتم تخزين بعض البيانات تلقائيًا في متغيّرات تدفق Edge المحددة مسبقًا، مثل قيم معلَمات طلب البحث التي يتم تمريرها إلى الخادم الوكيل لواجهة برمجة التطبيقات. راجِع نظرة عامة على متغيّرات التدفق لمعرفة المزيد عن متغيّرات التدفق المحدّدة مسبقًا.

    استخدِم سياسة استخراج المتغيّرات لاستخراج محتوى مخصّص من طلب أو استجابة وكتابة هذه البيانات في متغيّر.

  2. اكتب البيانات من متغيّر إلى إحصاءات واجهة برمجة تطبيقات Edge.

    استخدِم سياسة أداة جمع الإحصاءات لكتابة البيانات من متغيّر إلى إحصاءات Edge API في Edge. ويمكن الحصول على البيانات من متغيّرات تدفق Edge المحددة مسبقًا، أو المتغيرات التي تم إنشاؤها من خلال سياسة استخراج المتغيرات.

بعد جمع البيانات الإحصائية، يمكنك استخدام واجهة مستخدم إدارة Edge أو واجهة برمجة التطبيقات لاسترداد الإحصاءات وتصفيتها. على سبيل المثال، يمكنك إنشاء تقرير مخصّص يعرض متوسط التقييم لكل عنوان كتاب، حيث يتجاوب عنوان الكتاب مع قيمة معلَمة طلب البحث التي تم تمريرها إلى واجهة برمجة التطبيقات.

استخدم سياسة استخراج المتغيرات لاستخراج بيانات التحليلات

يجب استخراج بيانات "إحصاءات Google" وتخزينها في متغيّر، يكون إما متغيّر تدفق محدّد مسبقًا من خلال Edge أو المتغيرات المخصّصة التي تحدّدها، قبل تمريرها إلى "إحصاءات واجهة برمجة التطبيقات". لكتابة بيانات إلى متغيّر، يمكنك استخدام سياسة استخراج المتغيرات.

يمكن لسياسة استخراج المتغيرات تحليل حمولات الرسائل باستخدام تعبيرات JSONPath أو XPath. لاستخراج المعلومات من نتائج بحث JSON لواجهة برمجة تطبيقات الكتب من Google، استخدِم تعبير JSONPath. على سبيل المثال، لاستخراج قيمة averageRating من العنصر الأول في مصفوفة نتائج JSON يكون تعبير JSONPath على النحو التالي:

$.items[0].volumeInfo.averageRating

بعد تقييم مسار JSONPath، تكتب سياسة استخراج المتغيرات القيمة المستخرَجة إلى متغيّر.

في هذا المثال، يمكنك استخدام سياسة استخراج المتغيرات لإنشاء أربعة متغيرات:

  • responsejson.totalitems
  • responsejson.ratingscount
  • responsejson.avgrating
  • responsejson.pdf

بالنسبة إلى هذه المتغيّرات، يكون responsejson هو المتغيّر prefix وtotalitems وratingscount وavgrating وpdf هما أسماء المتغيّرات.

توضِّح سياسة "استخراج المتغيرات" أدناه كيفية استخراج البيانات من استجابة JSON وكتابتها في المتغيرات المخصَّصة. ويستخدم كل عنصر <Variable> السمة name التي تحدّد اسم المتغيّرات المخصّصة وتعبير JSONPath المرتبط بها. يحدّد العنصر <VariablePrefix> بادئة المتغيّر.

يمكنك إضافة هذه السياسة إلى الخادم الوكيل لواجهة برمجة التطبيقات في واجهة مستخدم Edge. إذا كنت بصدد إنشاء الخادم الوكيل لواجهة برمجة التطبيقات في ملف XML، أضِف السياسة إلى ملف ضمن /apiproxy/policies باسم ExtractVars.xml:

<ExtractVariables name="ExtractVars">
    <Source>response</Source>
    <JSONPayload>
        <Variable name="totalitems">
            <JSONPath>$.totalItems</JSONPath>
        </Variable>
        <Variable name="ratingscount">
            <JSONPath>$.items[0].volumeInfo.ratingsCount</JSONPath>
        </Variable>
        <Variable name="avgrating">
            <JSONPath>$.items[0].volumeInfo.averageRating</JSONPath>
        </Variable>
        <Variable name="pdf">
            <JSONPath>$.items[0].accessInfo.pdf.isAvailable</JSONPath>
        </Variable>
    </JSONPayload>
    <VariablePrefix>responsejson</VariablePrefix>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
</ExtractVariables>

استخدام سياسة جامع الإحصاءات لكتابة البيانات في خدمة "إحصاءات Google"

استخدِم سياسة أداة تجميع الإحصاءات لكتابة البيانات من متغيّر إلى إحصاءات Edge API في Edge. تكون سياسة تجميع الإحصاءات بالشكل التالي:

<StatisticsCollector>
<DisplayName>Statistics Collector-1</DisplayName>
    <Statistics>
        <Statistic name="statName" ref="varName" type="dataType">defVal</Statistic>
       …
    </Statistics>
</StatisticsCollector>

المكان:

  • تحدّد statName الاسم الذي تستخدمه للإشارة إلى البيانات الإحصائية في تقرير مخصّص.
  • تحدّد varName اسم المتغيّر الذي يحتوي على بيانات الإحصاءات المطلوب جمعها. يمكن تضمين هذا المتغيّر في Edge أو يمكن أن يكون متغيّرًا مخصّصًا تم إنشاؤه بموجب سياسة "استخراج المتغيرات".

  • تحدّد dataType نوع بيانات البيانات المسجّلة كسلسلة أو عدد صحيح أو عدد عائم أو طويل أو مزدوج أو منطقية.

    بالنسبة إلى بيانات نوع السلسلة، يجب الإشارة إلى البيانات الإحصائية على أنّها سمة في تقرير مخصّص. بالنسبة إلى أنواع البيانات الرقمية (عدد صحيح/عدد عائم/طويل/مزدوج)، يمكنك الرجوع إلى البيانات الإحصائية على أنّها سمة أو مقياس في تقرير مخصّص.

  • تقدِّم defValue قيمة تلقائية لمتغيّر مخصّص اختياريًا، يتم إرساله إلى "إحصاءات واجهة برمجة التطبيقات" في حال تعذّر حلّ المتغيّرات أو في حال كان المتغيّر غير محدّد.

في المثال أدناه، يمكنك استخدام سياسة جامع الإحصاءات لجمع بيانات عن المتغيرات التي تم إنشاؤها بواسطة نهج "استخراج المتغيرات". يمكنك أيضًا جمع قيمة معلمة طلب البحث التي تم تمريرها إلى كل طلب بيانات من واجهة برمجة التطبيقات. مرجع معلمات طلب البحث عن طريق استخدام متغيّر التدفق المحدّد مسبقًا:

request.queryparam.queryParamName

بالنسبة إلى معلمة طلب البحث المسماة "q"، يمكنك الإشارة إليها على النحو التالي:

request.queryparam.q

يمكنك إضافة هذه السياسة إلى الخادم الوكيل لواجهة برمجة التطبيقات في واجهة مستخدم Edge، أو إذا كان المطلوب إنشاء الخادم الوكيل لواجهة برمجة التطبيقات بتنسيق XML، أضِف ملفًا ضمن /apiproxy/policies باسم AnalyzeBookResults.xml, يتضمّن المحتوى التالي:

<StatisticsCollector name="AnalyzeBookResults">
 <Statistics>
        <Statistic name="totalitems" ref="responsejson.totalitems" type="integer">0</Statistic>
        <Statistic name="ratingscount" ref="responsejson.ratingscount" type="integer">0</Statistic>
        <Statistic name="avgrating" ref="responsejson.avgrating" type="float">0.0</Statistic>
        <Statistic name="pdf" ref="responsejson.pdf" type="boolean">true</Statistic>
        <Statistic name="booktitle" ref="request.queryparam.q" type="string">none</Statistic>
 </Statistics>
</StatisticsCollector>

إرفاق السياسات بمسار استجابة ProxyEndpoint

لضمان سير الأمور بشكل صحيح، يجب إرفاق السياسات بتدفق الخادم الوكيل لواجهة برمجة التطبيقات في الموقع المناسب. في حالة الاستخدام هذه، يجب تنفيذ السياسات بعد تلقّي الردّ من Google Book API وقبل إرسال الردّ إلى العميل الذي قدّم الطلب. لذلك، أرفِق السياسات بعنوان ProxyEndpoint response PreFlow.

ينفِّذ مثال إعداد ProxyEndpoint أدناه أولاً السياسة المسماة ExtractVars لتحليل رسالة الاستجابة. بعد ذلك، تعيد السياسة التي تُسمى AnalyzeBookResults توجيه هذه القيم إلى إحصاءات واجهة برمجة التطبيقات:

<ProxyEndpoint name="default">
    ><PreFlow name="PreFlow">
        <Request/>
        <Response>
            <Step>
                <Name>Extract-Vars</Name>
            </Step>
            <Step>
                <Name>AnalyzeBookResults</Name>
            </Step>
        </Response>
    </PreFlow>
 <HTTPProxyConnection>
  <!-- Base path used to route inbound requests to this API proxy -->
  <BasePath>/mybooksearch</BasePath>
  <!-- The named virtual host that defines the base URL for requests to this proxy -->
  <VirtualHost>default</VirtualHost>
 </HTTPProxyConnection>
 <RouteRule name="default">
 <!-- Connects the proxy to the target defined under /targets -->
  <TargetEndpoint>default</TargetEndpoint>
 </RouteRule>
</ProxyEndpoint>

نشر الخادم الوكيل لواجهة برمجة التطبيقات

بعد إجراء هذه التغييرات، عليك نشر الخادم الوكيل لواجهة برمجة التطبيقات الذي تم ضبطه.

تعبئة بيانات الإحصاءات

بعد نشر الخادم الوكيل لواجهة برمجة التطبيقات، يمكنك طلب الخادم الوكيل لتعبئة البيانات في "إحصاءات واجهة برمجة التطبيقات". يمكنك القيام بذلك عن طريق تشغيل الأوامر التالية، يستخدم كل منها عنوان كتاب مختلفًا:

موبي ديك:

curl https://org_name-env_name.apigee.net/mybooksearch?q=mobey%20dick

كود "دا فينشي":

curl https://org_name-env_name.apigee.net/mybooksearch?q=davinci%20code

فتاة غائبة:

curl https://org_name-env_name.apigee.net/mybooksearch?q=gone%20girl

Game of Thrones:

curl https://org_name-env_name.apigee.net/mybooksearch?q=game%20of%20thrones

عرض بيانات الإحصاءات

يوفّر Edge طريقتَين لعرض بيانات الإحصاءات المخصّصة:

  • تدعم واجهة مستخدم Edge التقارير المخصّصة التي تمكّنك من عرض بياناتك في رسم بياني رسومي.
  • تتيح لك واجهة برمجة التطبيقات للمقاييس استرداد بيانات الإحصاءات من خلال إجراء طلبات REST لواجهة برمجة تطبيقات Edge. يمكنك استخدام واجهة برمجة التطبيقات لإنشاء تمثيلات بصرية خاصة بك على شكل تطبيقات مصغّرة مخصّصة يمكنك تضمينها في بوابات إلكترونية أو تطبيقات مخصّصة.

إنشاء تقرير بالإحصاءات باستخدام واجهة مستخدم Edge

تتيح لك التقارير المخصّصة التوغّل في إحصاءات معيّنة لواجهة برمجة التطبيقات لعرض البيانات الدقيقة التي تريد الاطّلاع عليها. يمكنك إنشاء تقرير مخصّص باستخدام أي من metrics والسمات المضمّنة في Edge. بالإضافة إلى ذلك، يمكنك استخدام أي من بيانات الإحصاءات التي استخلصتها من خلال استخدام سياسة StatisticsCollector.

عند إنشاء سياسة جامع الإحصاءات، فإنك تحدد نوع بيانات البيانات التي تم جمعها. بالنسبة إلى نوع بيانات السلسلة، عليك الإشارة إلى البيانات الإحصائية على أنّها سمة في تقرير مخصّص. بالنسبة إلى أنواع البيانات الرقمية (عدد صحيح/عدد عائم/طويل/مزدوج)، أشِر إلى التاريخ الإحصائي في أي تقرير مخصّص على أنّه سمة أو كمقياس. الاطّلاع على إدارة التقارير المخصّصة لمزيد من المعلومات

إنشاء تقرير مخصّص باستخدام واجهة مستخدم Edge:

  1. انتقل إلى صفحة "التقارير المخصَّصة"، كما هو موضّح أدناه.

    Edge

    للوصول إلى صفحة "التقارير المخصّصة" باستخدام واجهة مستخدم Edge:

    1. سجِّل الدخول إلى apigee.com/edge.
    2. اختر تحليل > التقارير المخصّصة > التقارير في شريط التنقّل الأيمن.

    كلاسيكي Edge (السحابة الإلكترونية الخاصة)

    للوصول إلى صفحة "التقارير المخصّصة" باستخدام واجهة مستخدم الإصدار الكلاسيكي من Edge:

    1. سجِّل الدخول إلى http://ms-ip:9000، حيث يشير ms-ip إلى عنوان IP أو اسم نظام أسماء النطاقات لعقدة خادم الإدارة.

    2. حدد التحليلات > التقارير في شريط التنقل العلوي.

  2. في صفحة "التقارير المخصّصة"، انقر على +تقرير مخصّص.
  3. حدِّد اسم التقرير، مثل mybookreport.

  4. اختَر مقياسًا مضمّنًا، مثل عدد الزيارات، ودالة تجميع، مثل الإجمالي.

    أو حدد أحد إحصائيات البيانات الرقمية التي قمت بإنشائها باستخدام سياسة StatisticsCollector. على سبيل المثال، اختر ratingscount ودالة تجميع للدالة Sum.

  5. اختَر سمة مدمجة، مثل الخادم الوكيل لواجهة برمجة التطبيقات، أو أيًا من الإحصاءات الرقمية أو السلسلة التي أنشأتها باستخدام سياسة StatisticsCollector.

    على سبيل المثال، اختَر booktitle. سيعرض تقريرك الآن مجموع ratingscount حسب booktitle:

    تقرير مخصّص للكتاب
  6. انقر على حفظ. يظهر التقرير في قائمة جميع التقارير المخصّصة.

  7. لتشغيل التقرير، اختر اسم التقرير. يعرض التقرير تلقائيًا بيانات آخر ساعة.

  8. لضبط النطاق الزمني، اختَر التاريخ المعروض في أعلى يسار الصفحة لفتح النافذة المنبثقة لأداة اختيار التاريخ.

  9. اختَر آخر 7 أيام. يتم تعديل التقرير لعرض مجموع التقييمات لكل عنوان كتاب:

    رسم بياني لتقرير الكتب

الحصول على الإحصاءات باستخدام Edge API

استخدم واجهة برمجة تطبيقات مقاييس Edge للحصول على إحصاءات حول بيانات التحليلات المخصصة. في نموذج الطلب أدناه:

  • يحدِّد المورد إلى عنوان URL بعد /stats السمة المطلوبة. في هذا المثال، يمكنك الحصول على بيانات للسمة "booktitle".
  • معلمة طلب البحث select لتحديد metrics المطلوب استردادها. يعرض هذا الطلب إحصاءات استنادًا إلى مجموع ratingscount.

  • تحدد المعلمة timeRange الفاصل الزمني للبيانات المعروضة. يكون النطاق الزمني بالتنسيق:

    MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM

الطلب الكامل من واجهة برمجة التطبيقات هو:

curl -X GET "https://api.enterprise.apigee.com/v1/organizations/org_name/environments/env_name/stats/booktitle?select=sum(ratingscount)&timeRange=04/21/2019&2014:00:00~04/22/2019&2014:00:00" /
-u email:password

من المفترض أن يظهر لك رد بالنموذج:

{
  "environments": [
    {
      "dimensions": [
        {
          "metrics": [
            {
              "name": "sum(ratingscount)",
              "values": [
                "5352.0"
              ]
            }
          ],
          "name": "gone girl"
        },
        {
          "metrics": [
            {
              "name": "sum(ratingscount)",
              "values": [
                "4260.0"
              ]
            }
          ],
          "name": "davinci code"
        },
        {
          "metrics": [
            {
              "name": "sum(ratingscount)",
              "values": [
                "1836.0"
              ]
            }
          ],
          "name": "game of thrones"
        },
        {
          "metrics": [
            {
              "name": "sum(ratingscount)",
              "values": [
                "1812.0"
              ]
            }
          ],
          "name": "mobey dick"
        }
      ],
      "name": "prod"
    }
  ],
  "metaData": {
    "errors": [],
    "notices": [
      "query served by:9b372dd0-ed30-4502-8753-73a6b09cc028",
      "Table used: uap-prod-gcp-us-west1.edge.edge_api_raxgroup021_fact",
      "Source:Big Query"
    ]
  }
}

تشمل واجهة برمجة التطبيقات لمقاييس الحافة العديد من الخيارات. على سبيل المثال، يمكنك فرز النتائج بترتيب تصاعدي أو تنازلي. في المثال التالي، يمكنك استخدام الترتيب التصاعدي:

curl -X GET "https://api.enterprise.apigee.com/v1/organizations/org_name/environments/env_name/stats/booktitle?select=sum(ratingscount)&timeRange=04/21/2019&2014:00:00~04/22/2019&2014:00:00&sort=ASC" /
-u email:password

يمكن أيضًا فلترة النتائج من خلال تحديد قيم الأبعاد التي تهمك. في المثال التالي، تتم فلترة التقرير حسب نتائج "Gone Girl" و "The Da Vinci Code":

$ curl -X GET "https://api.enterprise.apigee.com/v1/organizations/org_name/environments/env_name/stats/booktitle?select=sum(ratingscount)&timeRange=04/21/2019&2014:00:00~04/22/2019&2014:00:00&filter=(booktitle%20in%20'gone%20girl'%2C%20'davinci%20code')" /
-u email:password

إنشاء متغيّرات إحصاءات مخصّصة باستخدام "أداة إنشاء الحلول"

تتيح لك أداة إنشاء الحلول إنشاء متغيّرات إحصاءات مخصّصة من خلال مربّع حوار سهل الاستخدام لواجهة المستخدم الإدارية.

يمكنك قراءة القسم السابق جمع بيانات الإحصاءات المخصّصة، الذي يوضّح آلية عمل سياسات "استخراج المتغيّرات" و"أداة جمع الإحصاءات" جنبًا إلى جنب مع خلاصة المتغيّرات المخصّصة في "إحصاءات Edge API" في أداة Edge. يتّضح مما سبق أنّ واجهة المستخدم تتبع النمط نفسه، ولكنّها توفّر طريقة سهلة لضبط الإعدادات بالكامل من خلال واجهة المستخدم. يمكنك تجربة مثال واجهة برمجة تطبيقات "كتب Google" إذا أردت باستخدام واجهة المستخدم بدلاً من تعديل السياسات وإرفاقها يدويًا.

يتيح لك مربّع الحوار "أداة إنشاء الحلول" ضبط متغيرات الإحصاءات مباشرةً في واجهة المستخدم. تنشئ هذه الأداة السياسات وترفقها بالخادم الوكيل لواجهة برمجة التطبيقات نيابةً عنك. تعمل السياسات على استخراج المتغيّرات المهمة من الطلبات أو الردود، وتمرير المتغيّرات المُستخرَجة إلى Edge API Analytics.

تعمل أداة إنشاء الحلول على إنشاء سياستين جديدتين من المتغيّرات "استخراج المتغيرات" و"جامع الإحصاءات" ومنحها أسماء فريدة. لا تتيح لك "أداة إنشاء الحلول" إمكانية الرجوع وتغيير هذه السياسات بعد إنشائها في مراجعة معيّنة للخادم الوكيل. لإجراء تغييرات، يجب تعديل السياسات التي تم إنشاؤها مباشرةً في محرّر السياسات.

  1. انتقِل إلى صفحة Overview (نظرة عامة) للخادم الوكيل في واجهة مستخدم Edge.
  2. انقر على تطوير.
  3. في صفحة "التطوير"، اختَر مجموعة الإحصاءات المخصّصة من قائمة "الأدوات". سيظهر مربّع الحوار "أداة إنشاء الحلول".
  4. في مربّع الحوار "أداة إنشاء الحلول"، عليك أولاً ضبط سياستَين: استخراج المتغيرات وأداة تجميع الإحصاءات. وبعد ذلك، يمكنك ضبط مكان إرفاق هذه السياسات.
  5. حدِّد البيانات التي تريد استخراجها:
    • نوع الموقع الجغرافي: اختَر نوع البيانات التي تريد جمعها ومكان جمعها منها. يمكنك اختيار البيانات من جانب الطلب أو الردّ. على سبيل المثال، الطلب: مَعلمة طلب البحث أو الردّ: نص XML.
    • مصدر الموقع الجغرافي: حدِّد البيانات التي تريد جمعها. على سبيل المثال، اسم مَعلمة طلب البحث أو XPath لبيانات XML في نص الاستجابة.
  6. حدِّد اسم متغيّر (ونوع) متغيّر ستستخدمه سياسة أداة تجميع الإحصاءات لتحديد البيانات المستخرجة. يمكنك الاطّلاع على قيود التسمية في هذا الموضوع.

    سيظهر الاسم الذي تستخدِمه في القائمة المنسدلة السمات أو المقاييس في واجهة مستخدم "أداة إنشاء التقارير المخصّصة".
  7. اختَر المكان الذي تريد في تدفق خادم وكيل واجهة برمجة التطبيقات أن ترفق فيه السياستين اللتين تم إنشاؤهما استخراج المتغيرات وأداة تجميع الإحصاءات. للحصول على إرشادات، راجِع "إرفاق السياسات بمسار استجابة ProxyEndpoint". لضمان سير الأمور بشكل صحيح، يجب إرفاق السياسات بمسار الخادم الوكيل لواجهة برمجة التطبيقات في الموقع المناسب. عليك إرفاق السياسات في مرحلة من التدفق تكون فيها المتغيّرات التي تدرجها ضمن النطاق (تتم تعبئته).
  8. انقر على +أداة الجمع لإضافة المزيد من المتغيّرات المخصّصة.

  9. عند الانتهاء، انقر على إنشاء حل.

  10. احفظ الخادم الوكيل وانشره.

يمكنك الآن إنشاء تقرير مخصّص للبيانات كما هو موضّح أعلاه.