إعداد التقارير

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

تقرير الشبكة
يوفّر تقرير الشبكة بيانات عن أداء AdMob وينشئ البيانات نفسها الواردة في تقرير شبكة واجهة مستخدم AdMob.
تقرير "التوسّط"
يتضمّن تقرير التوسّط أداء الجهات الخارجية. إذا لم تكن على دراية بتقرير التوسّط، يمكنك الاطّلاع على مقالة مركز المساعدة.

الأبعاد

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

أمثلة:

نوع التقرير السمة الوصف
تقرير "التوسّط" AD_SOURCE رقم التعريف الفريد لمصدر الإعلان (مثل "5450213213286189855" و "شبكة AdMob" كقيمة للتصنيف).
تقرير الشبكة AD_TYPE نوع الإعلان (على سبيل المثال، "نص" أو "صورة").

المقاييس

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

أمثلة:

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

الفلاتر

تسمح لك الفلاتر بتقييد الصفوف التي يتم تضمينها في التقرير من خلال تحديد سمة تريد فلترتها وتعبير الفلتر.

على سبيل المثال، يمكن تطبيق الفلتر التالي على تقرير توسّط للاطّلاع على أداء Meta Audience Network. ألقِ نظرة على قائمة مصادر الإعلانات الكاملة التي يمكن الاطّلاع عليها في تقرير التوسّط.

فلتر السمات تعبير الفلتر الوصف
AD_SOURCE يتطابق مع أي فئة = {10568273599589928883} تُبلِغ الفلاتر عن الصفوف استنادًا إلى مصدر الإعلان.

تقليل حدود التقارير

يبلغ الحدّ الأقصى لعدد الصفوف في التقارير 100,000 صف. وعند طلب تقرير يحتوي على أكثر من 100,000 صف، سيتم اقتطاع التقرير وعرض أول 100,000 صف. اطّلِع على نص استجابة التقرير للحصول على معلومات إضافية عن تنسيق الاستجابة.

للتأكّد من تلقّي جميع الصفوف، حاوِل تقليل حجم التقرير حسب ما يلي:

  • تقليل النطاق الزمني في الطلب.
  • تقليل عدد الأبعاد لأنها تعمل كمُضاعِف. تؤدي إضافة بُعد إلى ضرب عدد الصفوف، بينما تؤدي إضافة مقياس جديد إلى التقرير إلى إنشاء عمود جديد.