محتوای پیام API را با استفاده از تجزیه و تحلیل سفارشی تجزیه و تحلیل کنید

شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید . اطلاعات

Edge API Analytics طیف گسترده‌ای از اطلاعات آماری را از هر درخواست و پاسخ API جمع‌آوری و تجزیه و تحلیل می‌کند. این اطلاعات به طور خودکار جمع‌آوری می‌شوند و سپس می‌توانند در رابط کاربری Edge یا با استفاده از API متریک نمایش داده شوند. برای اطلاعات بیشتر در مورد این آمار، به بخش متریک‌ها و ابعاد مراجعه کنید.

همچنین ممکن است بخواهید داده‌های تحلیلی سفارشی مختص به پروکسی‌های API، برنامه‌ها، محصولات یا توسعه‌دهندگان خود را جمع‌آوری کنید. برای مثال، ممکن است بخواهید داده‌ها را از پارامترهای پرس‌وجو، هدرهای درخواست، بدنه‌های درخواست و پاسخ یا متغیرهایی که در APIهای خود تعریف می‌کنید، جمع‌آوری کنید.

این مبحث نحوه استفاده از سیاست StatisticsCollector را برای استخراج داده‌های تحلیلی سفارشی از یک درخواست/پاسخ API و ارسال آن داده‌ها به Edge API Analytics نشان می‌دهد. سپس، نحوه مشاهده داده‌های تحلیلی خود را در یک گزارش در رابط کاربری Edge یا با استفاده از Edge API نشان می‌دهد.

درباره API کتاب گوگل

این مبحث نحوه دریافت داده‌های تحلیلی سفارشی از درخواست‌های پروکسی API به API کتاب‌های گوگل را شرح می‌دهد. API کتاب‌های گوگل به شما امکان می‌دهد کتاب‌ها را بر اساس عنوان، موضوع، نویسنده و سایر ویژگی‌ها جستجو کنید.

برای مثال، درخواست‌هایی را به نقطه پایانی /volumes ارسال کنید تا جستجو بر اساس عنوان کتاب انجام شود. یک پارامتر پرس‌وجوی واحد را به API Books که شامل عنوان کتاب است، ارسال کنید:

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 ، که شامل معیارهای جستجو است را شرح می‌دهند.

یک پروکسی API برای API کتاب گوگل ایجاد کنید

قبل از اینکه بتوانید برای API کتاب گوگل آمار جمع‌آوری کنید، باید یک پروکسی API اج ایجاد کنید که آن را فراخوانی کند. سپس آن پروکسی API را برای ارسال درخواست‌های خود به API کتاب گوگل فراخوانی می‌کنید.

مرحله ۲: ایجاد یک پروکسی API در آموزش ایجاد یک پروکسی API، نحوه ایجاد یک پروکسی که API مربوط به https://mocktarget.apigee.net را فراخوانی می‌کند، شرح داده شده است. توجه داشته باشید که پروکسی شرح داده شده در آن آموزش برای فراخوانی به کلید API نیاز ندارد.

از همین رویه برای ایجاد یک پروکسی API برای نقطه پایانی /volumes از API کتاب گوگل استفاده کنید. در مرحله 5 این رویه، هنگام ایجاد پروکسی API، ویژگی‌های زیر را برای ارجاع به API کتاب‌های گوگل تنظیم کنید:

• نام پروکسی : "mybooksearch"
• مسیر پایه پروکسی : "/mybooksearch"
• API موجود : "https://www.googleapis.com/books/v1/volumes"

پس از ایجاد و استقرار پروکسی، باید بتوانید آن را با استفاده از دستور 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

جمع‌آوری داده‌های تحلیلی سفارشی

جمع‌آوری داده‌های تحلیلی از یک درخواست API یک فرآیند دو مرحله‌ای است:

1. داده‌های مورد نظر را استخراج کرده و در یک متغیر بنویسید.

   تمام داده‌های ارسالی به Edge API Analytics از مقادیر ذخیره شده در متغیرها می‌آیند. برخی از داده‌ها به طور خودکار در متغیرهای جریان Edge از پیش تعریف شده ذخیره می‌شوند، مانند مقادیر پارامترهای پرس و جو ارسال شده به پروکسی API. برای اطلاعات بیشتر در مورد متغیرهای جریان از پیش تعریف شده، به «مروری بر متغیرهای جریان» مراجعه کنید.

   از سیاست Extract Variables برای استخراج محتوای سفارشی از یک درخواست یا پاسخ و نوشتن آن داده‌ها در یک متغیر استفاده کنید.

2. نوشتن داده‌ها از یک متغیر در Edge API Analytics.

   از سیاست جمع‌آوری آمار برای نوشتن داده‌ها از یک متغیر در Edge API Analytics استفاده کنید. داده‌ها می‌توانند از متغیرهای جریان Edge از پیش تعریف شده یا متغیرهای ایجاد شده توسط سیاست Extract Variables باشند.

پس از جمع‌آوری داده‌های آماری، می‌توانید از رابط کاربری یا API مدیریت Edge برای بازیابی و فیلتر کردن آمار استفاده کنید. به عنوان مثال، می‌توانید یک گزارش سفارشی ایجاد کنید که میانگین امتیاز هر عنوان کتاب را نشان می‌دهد، که در آن عنوان کتاب با مقدار پارامتر پرس‌وجوی ارسال شده به API مطابقت دارد.

برای استخراج داده‌های تحلیلی از سیاست Extract Variables استفاده کنید

داده‌های تحلیلی باید قبل از اینکه بتوانند به API Analytics منتقل شوند، استخراج و در یک متغیر، یا یک متغیر جریان از پیش تعریف شده توسط Edge یا متغیرهای سفارشی که شما تعریف می‌کنید، ذخیره شوند. برای نوشتن داده‌ها در یک متغیر، از سیاست Extract Variables استفاده می‌کنید.

سیاست Extract Variables می‌تواند داده‌های پیام را با عبارات JSONPath یا XPath تجزیه کند. برای استخراج اطلاعات از نتایج جستجوی JSON از Google Book API، از عبارت JSONPath استفاده کنید. به عنوان مثال، برای استخراج مقدار averageRating از اولین مورد در آرایه نتایج JSON، عبارت JSONPath به صورت زیر است:

$.items[0].volumeInfo.averageRating

پس از ارزیابی JSONPath، سیاست Extract Variables مقدار استخراج شده را در یک متغیر می‌نویسد.

در این مثال، شما از سیاست Extract Variables برای ایجاد چهار متغیر استفاده می‌کنید:

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

برای این متغیرها، responsejson پیشوند متغیر است و totalitems ، ratingscount ، avgrating و pdf نام متغیرها هستند.

سیاست استخراج متغیرها در زیر نحوه استخراج داده‌ها از پاسخ JSON و نوشتن آن در متغیرهای سفارشی را نشان می‌دهد. هر عنصر <Variable> از ویژگی name استفاده می‌کند که نام متغیرهای سفارشی و عبارت JSONPath مرتبط را مشخص می‌کند. عنصر <VariablePrefix> پیشوند متغیر را مشخص می‌کند.

این سیاست را به پروکسی API خود در رابط کاربری Edge اضافه کنید. اگر پروکسی API را در 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>

از سیاست جمع‌آوری آمار برای نوشتن داده‌ها در سرویس تحلیلی استفاده کنید

از سیاست Statistics Collector برای نوشتن داده‌ها از یک متغیر در Edge API Analytics استفاده کنید. سیاست Statistics Collectory به شکل زیر است:

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

کجا:

• statName نامی را مشخص می‌کند که برای ارجاع به داده‌های آماری در یک گزارش سفارشی استفاده می‌کنید.
• varName نام متغیری را مشخص می‌کند که حاوی داده‌های تحلیلی برای جمع‌آوری است. این متغیر می‌تواند در Edge ساخته شود یا می‌تواند یک متغیر سفارشی باشد که توسط سیاست Extract Variables ایجاد شده است.

• dataType نوع داده‌ی داده‌های ثبت‌شده را به صورت رشته (string)، عدد صحیح (integer)، اعشاری (float)، بلند (long)، دابل (double) یا بولی (boolean) مشخص می‌کند.

  برای داده‌های از نوع رشته، شما داده‌های آماری را به عنوان یک بُعد در یک گزارش سفارشی ارجاع می‌دهید. برای انواع داده‌های عددی (عدد صحیح/اعشاری/طولانی/دوگانه)، شما داده‌های آماری را به عنوان یک بُعد یا یک معیار در یک گزارش سفارشی ارجاع می‌دهید.

• defValue به صورت اختیاری یک مقدار پیش‌فرض برای یک متغیر سفارشی ارائه می‌دهد که در صورت عدم امکان حل متغیرها یا تعریف نشدن متغیر، به API Analytics ارسال می‌شود.

در مثال زیر، شما از سیاست جمع‌آوری آمار برای جمع‌آوری داده‌ها برای متغیرهای ایجاد شده توسط سیاست استخراج متغیرها استفاده می‌کنید. همچنین مقدار پارامتر پرس‌وجو ارسال شده به هر فراخوانی API را جمع‌آوری می‌کنید. با استفاده از متغیر جریان از پیش تعریف شده، به پارامترهای پرس‌وجو ارجاع می‌دهید:

request.queryparam.queryParamName

برای پارامتر پرس و جو با نام "q" به آن به صورت زیر ارجاع دهید:

request.queryparam.q

این سیاست را به پروکسی API خود در رابط کاربری Edge اضافه کنید، یا اگر پروکسی API را در XML می‌سازید، فایلی با نام AnalyzeBookResults.xml, با محتوای زیر در /apiproxy/policies اضافه کنید:

<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 متصل کنید

برای اینکه همه چیز به درستی کار کند، سیاست‌ها باید در محل مناسب به جریان پروکسی API متصل شوند. در این مورد استفاده، سیاست‌ها باید پس از دریافت پاسخ از API کتاب گوگل و قبل از ارسال پاسخ به کلاینت درخواست‌کننده اجرا شوند. بنابراین، سیاست‌ها را به PreFlow پاسخ ProxyEndpoint متصل کنید.

پیکربندی ProxyEndpoint نمونه زیر ابتدا سیاستی به نام ExtractVars را برای تجزیه پیام پاسخ اجرا می‌کند. سپس سیاستی به نام AnalyzeBookResults آن مقادیر را به API Analytics ارسال می‌کند:

<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>

پراکسی API را مستقر کنید

پس از انجام این تغییرات، باید پروکسی API که پیکربندی کرده‌اید را مستقر کنید.

داده‌های تحلیلی را جمع‌آوری کنید

پس از استقرار پروکسی API خود، آن را برای پر کردن داده‌ها در API Analytics فراخوانی کنید. می‌توانید این کار را با اجرای دستورات زیر انجام دهید که هر کدام از آنها از عنوان کتاب متفاوتی استفاده می‌کنند:

موبی دیک:

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  

بازی تاج و تخت:

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

مشاهده داده‌های تحلیلی

Edge دو روش برای مشاهده داده‌های تحلیلی سفارشی شما ارائه می‌دهد:

• رابط کاربری Edge از گزارش‌های سفارشی پشتیبانی می‌کند که به شما امکان می‌دهد داده‌های خود را در یک نمودار گرافیکی مشاهده کنید.
• API معیارها به شما امکان می‌دهد با برقراری تماس‌های REST به Edge API، داده‌های تحلیلی را بازیابی کنید. می‌توانید از این API برای ساخت مصورسازی‌های خود در قالب ویجت‌های سفارشی استفاده کنید که می‌توانید در پورتال‌ها یا برنامه‌های سفارشی جاسازی کنید.

با استفاده از رابط کاربری Edge، گزارشی از آمار ایجاد کنید

گزارش‌های سفارشی به شما امکان می‌دهند تا با دقت به آمار API خاص دسترسی پیدا کنید تا داده‌های دقیقی را که می‌خواهید ببینید، مشاهده کنید. می‌توانید با استفاده از هر یک از معیارها و ابعاد تعبیه‌شده در Edge، یک گزارش سفارشی ایجاد کنید. علاوه بر این، می‌توانید از هر یک از داده‌های تحلیلی که با استفاده از سیاست StatisticsCollector استخراج کرده‌اید، استفاده کنید.

وقتی یک سیاست جمع‌آوری آمار ایجاد می‌کنید، نوع داده‌ی داده‌های جمع‌آوری‌شده را مشخص می‌کنید. برای نوع داده‌ی رشته‌ای، داده‌های آماری را به عنوان یک بُعد در یک گزارش سفارشی ارجاع دهید. برای انواع داده‌های عددی (عدد صحیح/اعشاری/طولانی/دوگانه)، تاریخ آماری را در یک گزارش سفارشی به عنوان یک بُعد یا به عنوان یک معیار ارجاع دهید. برای اطلاعات بیشتر به مدیریت گزارش‌های سفارشی مراجعه کنید.

ایجاد گزارش سفارشی با استفاده از رابط کاربری Edge:

1. همانطور که در زیر توضیح داده شده است، به صفحه گزارش‌های سفارشی دسترسی پیدا کنید.

   لبه

   برای دسترسی به صفحه گزارش‌های سفارشی با استفاده از رابط کاربری Edge:

   1. وارد apigee.com/edge شوید.
   2. در نوار پیمایش سمت چپ، گزینه‌ی «تحلیل» > «گزارش‌های سفارشی» > «گزارش‌ها» را انتخاب کنید.

   لبه کلاسیک (ابر خصوصی)

   برای دسترسی به صفحه گزارش‌های سفارشی با استفاده از رابط کاربری کلاسیک اج:

   1. وارد آدرس http:// ms-ip :9000 شوید، که در آن ms-ip آدرس IP یا نام DNS گره سرور مدیریت است.

   2. در نوار پیمایش بالا ، Analyics > Reports را انتخاب کنید.

2. در صفحه گزارش‌های سفارشی، روی +گزارش سفارشی کلیک کنید.
3. یک نام برای گزارش مشخص کنید، مانند mybookreport .

4. یک معیار داخلی مانند Traffic و یک تابع Aggregate مانند Sum انتخاب کنید.

   یا، یکی از آمار داده‌های عددی که با استفاده از سیاست StatisticsCollector ایجاد کرده‌اید را انتخاب کنید. برای مثال، ratingscount و یک تابع Aggregate از Sum را انتخاب کنید.

5. یک Dimension داخلی مانند API Proxy یا هر یک از داده‌های آماری رشته‌ای یا عددی که با استفاده از سیاست StatisticsCollector ایجاد کرده‌اید را انتخاب کنید.

   برای مثال، booktitle را انتخاب کنید. گزارش شما اکنون مجموع ratingscount را بر اساس booktitle نمایش می‌دهد:

   
6. ذخیره را انتخاب کنید. گزارش در لیست تمام گزارش‌های سفارشی نمایش داده می‌شود.

7. برای اجرای گزارش، نام گزارش را انتخاب کنید. به طور پیش‌فرض، گزارش داده‌های یک ساعت گذشته را نشان می‌دهد.

8. برای تنظیم محدوده زمانی، نمایش تاریخ را در گوشه بالا سمت راست انتخاب کنید تا پنجره انتخاب تاریخ باز شود.

9. ۷ روز گذشته را انتخاب کنید. گزارش به‌روزرسانی می‌شود تا مجموع امتیازها را به ازای هر عنوان کتاب نشان دهد:

   

دریافت آمار با استفاده از Edge API

از API معیارهای Edge برای آمارگیری روی داده‌های تحلیلی سفارشی خود استفاده کنید. در مثال درخواست زیر:

• منبعی که پس از /stats در URL قرار دارد، بُعد مورد نظر را مشخص می‌کند. در این مثال، شما داده‌های مربوط به بُعد booktitle دریافت می‌کنید.
• پارامتر کوئری select برای مشخص کردن معیارهای بازیابی. این درخواست، تجزیه و تحلیل را بر اساس مجموع ratingscount برمی‌گرداند.

• پارامتر timeRange فاصله زمانی برای داده‌های برگشتی را مشخص می‌کند. این محدوده زمانی به شکل زیر است:

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

فراخوانی کامل API به صورت زیر است:

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"
    ]
  }
}

API معیارهای Edge گزینه‌های زیادی دارد. برای مثال، می‌توانید نتایج را به ترتیب صعودی یا نزولی مرتب کنید. در مثال زیر، از ترتیب صعودی استفاده می‌کنید:

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

همچنین می‌توان نتایج را با مشخص کردن مقادیر ابعاد مورد نظر فیلتر کرد. در مثال زیر، گزارش بر اساس نتایج «دختر گمشده» و «رمز داوینچی» فیلتر شده است:

$ 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

ایجاد متغیرهای تحلیلی سفارشی با Solution Builder

ابزار Solution Builder به شما امکان می‌دهد متغیرهای تحلیلی سفارشی را از طریق یک رابط کاربری مدیریتی آسان ایجاد کنید.

شاید بخواهید بخش قبلی «جمع‌آوری داده‌های تحلیلی سفارشی» را بخوانید، که توضیح می‌دهد چگونه سیاست‌های «استخراج متغیرها» و «جمع‌آوری آمار» دست در دست هم برای تغذیه متغیرهای سفارشی به Edge API Analytics کار می‌کنند. همانطور که خواهید دید، رابط کاربری از همین الگو پیروی می‌کند، اما راهی مناسب برای پیکربندی کامل موارد از طریق رابط کاربری فراهم می‌کند. در صورت تمایل، به جای ویرایش و پیوست کردن دستی سیاست‌ها، مثال API کتاب‌های گوگل را با استفاده از رابط کاربری امتحان کنید.

پنجره‌ی محاوره‌ای Solution Builder به شما امکان می‌دهد متغیرهای تحلیلی را مستقیماً در رابط کاربری پیکربندی کنید. این ابزار، سیاست‌ها را ایجاد کرده و آنها را به پروکسی API برای شما متصل می‌کند. سیاست‌ها متغیرهای مورد نظر را از درخواست‌ها یا پاسخ‌ها استخراج کرده و متغیرهای استخراج شده را به Edge API Analytics منتقل می‌کنند.

سازنده راهکار، سیاست‌های جدید Extract Variables و Statistics Collector را ایجاد می‌کند و به آنها نام‌های منحصر به فردی می‌دهد. سازنده راهکار به شما اجازه نمی‌دهد که پس از ایجاد این سیاست‌ها در یک نسخه پروکسی مشخص، به عقب برگردید و آنها را تغییر دهید. برای ایجاد تغییرات، سیاست‌های تولید شده را مستقیماً در ویرایشگر سیاست ویرایش کنید.

1. به صفحه نمای کلی پروکسی خود در رابط کاربری Edge بروید.
2. روی توسعه کلیک کنید.
3. در صفحه توسعه، از منوی ابزارها ، مجموعه تحلیل‌های سفارشی را انتخاب کنید. پنجره‌ی «سازنده‌ی راه‌حل» ظاهر می‌شود.
4. در پنجره‌ی Solution Builder، ابتدا دو سیاست را پیکربندی می‌کنید: Extract Variables و Statistics Collector. سپس، محل الصاق این سیاست‌ها را پیکربندی می‌کنید.
5. داده‌هایی را که می‌خواهید استخراج کنید مشخص کنید:
   • نوع مکان: نوع داده‌ای که می‌خواهید جمع‌آوری کنید و محل جمع‌آوری آن را انتخاب کنید. می‌توانید داده‌ها را از سمت درخواست یا پاسخ انتخاب کنید. برای مثال، درخواست: پارامتر پرس‌وجو یا پاسخ: بدنه XML.
   • منبع مکان: داده‌هایی را که می‌خواهید جمع‌آوری کنید، مشخص کنید. برای مثال، نام پارامتر پرس‌وجو یا XPath برای داده‌های XML در بدنه پاسخ.
6. نام (و نوع) متغیری را مشخص کنید که سیاست جمع‌آوری آمار برای شناسایی داده‌های استخراج‌شده از آن استفاده خواهد کرد. محدودیت‌های نامگذاری را در این مبحث ببینید.
   
   نامی که استفاده می‌کنید در منوی کشویی مربوط به ابعاد یا معیارها در رابط کاربری سازنده گزارش سفارشی ظاهر می‌شود.
7. انتخاب کنید که در جریان پروکسی API، می‌خواهید سیاست‌های تولید شده، متغیرهای استخراج و جمع‌آوری‌کننده آمار را به کجا پیوست کنید. برای راهنمایی، به « پیوست کردن سیاست‌ها به جریان پاسخ ProxyEndpoint » مراجعه کنید. برای اینکه همه چیز به درستی کار کند، سیاست‌ها باید در محل مناسب به جریان پروکسی API پیوست شوند. شما باید سیاست‌ها را در مرحله‌ای از جریان پیوست کنید که متغیرهایی که به دام می‌اندازید در محدوده (جمع‌آوری‌شده) قرار دارند.
8. برای افزودن متغیرهای سفارشی بیشتر، روی +Collector کلیک کنید.

9. وقتی کارتان تمام شد، روی «ساخت راهکار» کلیک کنید.

   

10. پروکسی را ذخیره و اجرا کنید.

اکنون می‌توانید همانطور که در بالا توضیح داده شد، یک گزارش سفارشی برای داده‌ها ایجاد کنید.