يتيح نظام إعداد التقارير في AdSense Management API لكل من المرونة والتخصيص في موقع AdSense الإلكتروني. يتم إنشاء التقارير من خلال تحديد قائمة بالسمات والمقاييس.
الأبعاد
في كل مرة تعرِض فيها خدمة AdSense إعلانًا، يتم تسجيل كل حدث مرتبط بهذا الإعلان بمجموعة من السمات: التاريخ، والبلد، والقناة، والوحدة الإعلانية، وما إلى ذلك. وتُعرف هذه السمات باسم "السمات".
تُستخدم السمات لأغراض التجميع في التقارير.
المقاييس
عند طلب تقرير، تتمّ إضافة الأحداث المُسجَّلة معًا وفقًا للسمات المختارة. تمثل المقاييس القياسات المختلفة التي يمكنك إجراؤها على تلك البيانات.
يتمّ احتساب بعض المقاييس بدلاً من قياسها مباشرةً.
استخدام سمات متعدّدة بحكمة
يتألف التقرير الذي تم إنشاؤه من سلسلة من الصفوف يحتوي كل منها على حقل واحد أو أكثر. تؤدي إضافة مقياس جديد إلى تقرير إلى إنشاء عمود جديد، ولكن إضافة سمة تؤدي إلى ضرب عدد الصفوف.
على سبيل المثال، يؤدي التقرير الذي يتضمّن DATE كسمة إلى إنشاء مجموعة من الصفوف، بمعدل صف واحد لكل يوم يتضمّن نشاطًا. وستؤدي إضافة سمة جديدة، مثل CUSTOM_CHANNEL_NAME، إلى إنشاء صف في اليوم ولكل قناة حالية. كمبدأ إرشادات، من الجيد استخدام أي عدد تريده من المقاييس، ولكن حاوِل عدم استخدام أكثر من مكوّنَين لكل تقرير.
السمات والمقاييس غير المتوافقة
هناك بعض المقاييس والسمات التي لا يمكن دمجها في تقرير واحد. على سبيل المثال، سينشأ تضارب عند محاولة جلب عنوان URL والقنوات المخصّصة في الوقت نفسه. هذا القيد هو نفسه كما في موقع AdSense الإلكتروني (علامة التبويب "تقارير الأداء").
تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The AdSense Management API reporting system mirrors the AdSense website, allowing for flexible and customizable reports by specifying dimensions and metrics."],["Dimensions, like date or platform type, group data for analysis, while metrics, such as earnings or clicks, measure performance."],["While you can use multiple metrics freely, it's recommended to limit the use of dimensions to two per report to avoid excessive data complexity."],["Some dimension and metric combinations are incompatible and cannot be used together within the same report, similar to limitations in the AdSense website's Performance reports."],["You can further explore handling results, choosing the right dimensions, specifying date ranges, and reviewing a comprehensive list of available metrics and dimensions through the provided links."]]],["The AdSense Management API allows customizable reports through dimensions and metrics. Dimensions, like `DATE` or `PLATFORM_TYPE_NAME`, group ad event data by attributes. Metrics, such as `ESTIMATED_EARNINGS` or `CLICKS`, measure data based on these groupings; some are calculated, like `COST_PER_CLICK`. Adding dimensions increases report rows, so use sparingly. While metrics can be combined freely, the number of dimensions has to be minimal, as some dimensions and metrics are incompatible.\n"]]