يتضمّن تقرير التوسّط أداء الجهات الخارجية. إذا لم تكن على دراية بتقرير التوسّط، يمكنك الاطّلاع على مقالة مركز المساعدة.
الأبعاد
أمّا في التقارير، فيتم استخدام السمات لأغراض التجميع، وإذا لم يتمّ تحديد أيّ أبعاد، يعرض التقرير صفًا واحدًا من المقاييس المطلوبة للحساب بالكامل. لكل تقرير سمات مختلفة، يمكنك الاطّلاع على تقرير الشبكة وسمات تقرير التوسّط لمزيد من التفاصيل.
تمثل المقاييس القياسات المختلفة التي يمكنك إجراؤها على تلك البيانات. عند طلب تقرير، يتمّ احتساب المقاييس وفقًا للأبعاد المختارة. يجب أن يتضمّن التقرير مقياسًا واحدًا على الأقل. يحتوي كل تقرير على مقاييس مختلفة، يمكنك الاطّلاع على تقرير الشبكة ومقاييس تقرير التوسّط لمزيد من التفاصيل.
نسبة الإعلانات المعروضة مقابل الإعلانات التي تم عرضها، وتُعرف باسم مرات الظهور / الطلبات المطابقة. القيمة هي قيمة عشرية بدقة مزدوجة (تقريبية).
الفلاتر
تسمح لك الفلاتر بتقييد الصفوف التي يتم تضمينها في التقرير من خلال تحديد سمة تريد فلترتها وتعبير الفلتر.
على سبيل المثال، يمكن تطبيق الفلتر التالي على تقرير توسّط للاطّلاع على أداء Meta Audience Network. ألقِ نظرة على قائمة مصادر الإعلانات الكاملة
التي يمكن الاطّلاع عليها في تقرير التوسّط.
فلتر السمات
تعبير الفلتر
الوصف
AD_SOURCE
يتطابق مع أي فئة = {10568273599589928883}
تُبلِغ الفلاتر عن الصفوف استنادًا إلى مصدر الإعلان.
تقليل حدود التقارير
يبلغ الحدّ الأقصى لعدد الصفوف في التقارير 100,000 صف. وعند طلب تقرير يحتوي على أكثر من 100,000 صف، سيتم اقتطاع التقرير وعرض أول 100,000 صف. اطّلِع على نص استجابة التقرير للحصول على
معلومات إضافية عن تنسيق الاستجابة.
للتأكّد من تلقّي جميع الصفوف، حاوِل تقليل حجم التقرير حسب ما يلي:
تقليل النطاق الزمني في الطلب.
تقليل عدد الأبعاد لأنها تعمل كمُضاعِف. تؤدي إضافة بُعد إلى ضرب عدد الصفوف، بينما تؤدي إضافة مقياس جديد إلى التقرير إلى إنشاء عمود جديد.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe AdMob API offers Network and Mediation reports to provide insights into ad performance and third-party network data.\u003c/p\u003e\n"],["\u003cp\u003eReports utilize dimensions for grouping data and metrics for measuring performance, with customizable options for filtering and reducing report size.\u003c/p\u003e\n"],["\u003cp\u003eNew user roles and permissions will impact the data returned by the AdMob API, requiring users to review updated documentation.\u003c/p\u003e\n"],["\u003cp\u003eReports are limited to 100,000 rows, and users can adjust date ranges and dimensions to retrieve complete data.\u003c/p\u003e\n"]]],["The AdMob API generates network and mediation reports. Reports utilize dimensions for grouping data; without them, a single row with metrics is returned. Metrics are measurements calculated based on chosen dimensions; at least one is required per report. Filters, like `AD_SOURCE`, restrict rows based on a dimension. Reports are limited to 100,000 rows. To manage this limit you can reduce the number of dimensions, or shorten the date range. Note that new user roles will impact data returned by the API.\n"],null,["# Reporting\n\n| **Important:** New user roles and permissions will affect data returned by the AdMob API. [Learn more](//support.google.com/admob/answer/2784628)\n\nThe AdMob API has the ability to generate the following reports:\n\nNetwork report\n: The network report provides data on AdMob's performance and generates the\n same data found in the\n [AdMob UI network report](//support.google.com/admob/answer/9005740).\n\nMediation report\n: The mediation report includes third-party performance. If you are unfamiliar\n with the mediation report, take a look at the\n [Help Center article](//support.google.com/admob/answer/9005741).\n\nDimensions\n----------\n\n| **Note:** Some dimensions and metrics are incompatible and will cause a conflict to arise in a single report. For additional information, see the [report reference documentation](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#dimension).\n\nIn reports, dimensions are used for grouping purposes, and if no dimensions are\nspecified, the report returns a single row of the requested metrics for the\nentire account. Each report has various dimensions, see [network report](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#dimension)\nand [mediation report dimensions](/admob/api/v1/reference/rest/v1/accounts.mediationReport/generate#dimension)\nfor more details.\n\nExamples:\n\n| Report type | Dimension | Description |\n|------------------|------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------|\n| Mediation report | [AD_SOURCE](/admob/api/v1/reference/rest/v1/accounts.mediationReport/generate#dimension) | The unique ID of the ad source (for example, \"5450213213286189855\" and \"AdMob Network\" as label value). |\n| Network report | [AD_TYPE](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#dimension) | Type of the ad (for example, \"text\" or \"image\"). |\n\nMetrics\n-------\n\nMetrics represent the different measurements you can make on that data. When a\nreport is requested, the metrics are calculated according to the chosen\ndimensions. A report must include at least one metric. Each report has various\nmetrics, see [network report](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#metric)\nand [mediation report metrics](/admob/api/v1/reference/rest/v1/accounts.mediationReport/generate#metric)\nfor more details.\n\nExamples:\n\n| Report type | Metric | Description |\n|------------------|----------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Mediation report | [OBSERVED_ECPM](/admob/api/v1/reference/rest/v1/accounts.mediationReport/generate#dimension) | The third-party ad network's estimated average eCPM. |\n| Network report | [SHOW_RATE](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#metric) | The ratio of ads that are displayed over ads that are returned, defined as impressions / matched requests. The value is a double precision (approximate) decimal value. |\n\nFilters\n-------\n\nFilters allow you to restrict the rows that get included in the report by\nspecifying a [dimension to filter](/admob/api/v1/reference/rest/v1/accounts.mediationReport/generate#dimensionfilter) on and the filter expression.\n\nFor example, the filter below can be applied to a mediation report to view\nMeta Audience Network's performance. Take a look at the complete [list of ad sources](/admob/api/v1/ad-sources-reference)\nthat can be viewed in the mediation report.\n\n| Dimension Filter | Filter Expression | Description |\n|------------------|-------------------------------------|-------------------------------------------------------------------------------|\n| AD_SOURCE | matchesAny = {10568273599589928883} | Filters report rows based on [ad source](/admob/api/v1/ad-sources-reference). |\n\nReduce report limits\n--------------------\n\nReports have a limit of 100,000 rows. When a report with over 100,000 rows is\nrequested, the report will be truncated and the first 100,000 rows will be\nreturned. See the [report response body](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#response-body)\nfor additional information on the response format.\n\nTo ensure you are receiving all rows, try reducing the size of the report by:\n\n- Reducing the date range in the request.\n- Reducing the number of dimensions as they act as a multiplier. Adding a dimension multiplies the number of rows, whereas adding a new metric to a report produces a new column."]]
