يتيح نظام إعداد التقارير في AdSense Management API لكل من المرونة والتخصيص في موقع AdSense الإلكتروني. يتم إنشاء التقارير من خلال تحديد قائمة بالسمات والمقاييس.
الأبعاد
في كل مرة تعرِض فيها خدمة AdSense إعلانًا، يتم تسجيل كل حدث مرتبط بهذا الإعلان بمجموعة من السمات: التاريخ، والبلد، والقناة، والوحدة الإعلانية، وما إلى ذلك. وتُعرف هذه السمات باسم "السمات".
تُستخدم السمات لأغراض التجميع في التقارير.
المقاييس
عند طلب تقرير، تتمّ إضافة الأحداث المُسجَّلة معًا وفقًا للسمات المختارة. تمثل المقاييس القياسات المختلفة التي يمكنك إجراؤها على تلك البيانات.
يتمّ احتساب بعض المقاييس بدلاً من قياسها مباشرةً.
استخدام سمات متعدّدة بحكمة
يتألف التقرير الذي تم إنشاؤه من سلسلة من الصفوف يحتوي كل منها على حقل واحد أو أكثر. تؤدي إضافة مقياس جديد إلى تقرير إلى إنشاء عمود جديد، ولكن إضافة سمة تؤدي إلى ضرب عدد الصفوف.
على سبيل المثال، يؤدي التقرير الذي يتضمّن DATE
كسمة إلى إنشاء مجموعة من الصفوف، بمعدل صف واحد لكل يوم يتضمّن نشاطًا. وستؤدي إضافة سمة جديدة، مثل CUSTOM_CHANNEL_NAME
، إلى إنشاء صف في اليوم ولكل قناة حالية. كمبدأ إرشادات، من الجيد استخدام أي عدد تريده من المقاييس، ولكن حاوِل عدم استخدام أكثر من مكوّنَين لكل تقرير.
![اختيار الأبعاد بحكمة](https://developers-dot-devsite-v2-prod.appspot.com/static/adsense/management/images/choosedimensions.png?authuser=4&hl=ar)
السمات والمقاييس غير المتوافقة
هناك بعض المقاييس والسمات التي لا يمكن دمجها في تقرير واحد. على سبيل المثال، سينشأ تضارب عند محاولة جلب عنوان URL والقنوات المخصّصة في الوقت نفسه. هذا القيد هو نفسه كما في موقع AdSense الإلكتروني (علامة التبويب "تقارير الأداء").