تحتوي AdSense Management API على طلبات لإنشاء تقارير جديدة ومحفوظة. ويمكنها أن تتضمن تحليلات بسيطة مثل الأرباح لكل يوم أو جداول معقدة للغاية لنسبة النقر إلى الظهور لكل قناة مخصّصة لكل بلد. يعرض هذا الدليل قائمة بالحالات الحدّية التي يجب معالجتها بشكل صحيح لإجراء دمج قوي مع واجهات برمجة التطبيقات.
بنية التقرير
يتم عرض نتائج التقارير كعنصر ReportResult. راجِع مرجع الردود على التقرير للتعرّف على التفاصيل الكاملة.
استخدام أبعاد زمنية: DATE وWEEK وMONTH
يمكن أن تكون التقارير فارغة أو بها فجوات.
وإذا لم يكن هناك أي نشاط خلال الفترة الزمنية المحددة في الطلب، لن يتم إنشاء أي طلبات إعلان ولن تعرض خدمة إعداد التقارير صفوفًا لتلك الفترات الزمنية. هذا مهم إذا كنت، على سبيل المثال، تقوم برسم رسم بياني.
اطّلِع على دليل ملء التواريخ للحصول على مزيد من المعلومات.
طلب السمتين MONTH وWEEK في التقرير نفسه
قد يؤدي هذا التقرير إلى عواقب سلبية أو غير متوقعة. فإذا كان أسبوع ما لشهرين مختلفين، فسيعرض صفين للأسبوع نفسه، صفًا واحدًا لكل شهر.
مثال
| الأبعاد | المقاييس | تاريخ البدء | تاريخ الانتهاء |
|---|---|---|---|
WEEKMONTH |
CLICKS | 2014-04-28 | 2014-05-03 |
المرتجعات:
MONTH | WEEK* | CLICKS |
|---|---|---|
| 2014-04 | 2014-04-27 | 50 |
| 2014-05 | 2014-04-27 | 43 |
* في اليوم الأول من الأسبوع
الحلّ
يُرجى إزالة "MONTH" من التقرير.
WEEK | CLICKS |
|---|---|
| 2014-04-27 | 93 |
تجميع قيم السمات
عند طلب سمات مثل السمات ذات الصلة، على سبيل المثال، الأنظمة الأساسية (أجهزة الكمبيوتر المكتبي، وأجهزة الجوّال المتقدمة، وما إلى ذلك)، سيتم عرض الأنظمة الأساسية التي بها نشاط فقط. إذا لم يحصل يوم أو أسبوع أو شهر معيّن على زيارات من الأجهزة الجوّالة المتقدمة، لن تتوفر أي معلومات عن تلك الفئة.
مثال
| الأبعاد | المقاييس | تاريخ البدء | تاريخ الانتهاء |
|---|---|---|---|
PLATFORM_TYPE_NAMEMONTH |
AD_REQUESTS |
2014-02-01 | 2014-03-31 |
المرتجعات:
| الشهر | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | أجهزة الكمبيوتر المكتبي | 100 |
| 2014-03 | أجهزة الجوّال المتطورة | 5 |
| 2014-04 | أجهزة الكمبيوتر المكتبي | 75 |
الحلّ
عند معالجة نتائج التقرير، افترض أن تكون القيمة صفرًا لأي قيم أبعاد لا تظهر في النتائج:
| الشهر | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | أجهزة الكمبيوتر المكتبي | 100 |
| 2014-03 | أجهزة الجوّال المتطورة | 5 |
| 2014-04 | أجهزة الكمبيوتر المكتبي | 75 |
| 2014-04 | الأجهزة الجوّالة المتقدّمة | 0 |
الجمع بين عدة تقارير متجاورة
في بعض الأحيان، يكون التقرير كبيرًا جدًا بحيث لا يمكن إنشاؤه مرة واحدة ويجب أن يتم دفعه بشكل مجمّع. وإذا نفّذ تطبيقك ذلك، ضع في اعتبارك الحالات التالية:
- إذا كنت تستخدم السمة
WEEKأوMONTHوكنت تقسّم التقرير في منتصف أسبوع أو شهر، سيحتوي كل تقرير على إدخالات مكرّرة ببيانات مختلفة. - تأكد من أن جميع التقارير تحتوي على المقاييس والسمات نفسها، إذ قد لا تكون البيانات قابلة للدمج باستخدام سمات مختلفة.
الحسابات الخاصة
قد يمتلك بعض المستخدمين حسابات على AdSense بسمات لا تتوقّعها أو تعرفها. يُرجى مراعاة ما يلي:
- الناشرون الذين لديهم آلاف النطاقات أو المواقع الإلكترونية
- الناشرون الذين لديهم آلاف الوحدات الإعلانية أو القنوات المخصّصة
- الناشرون الذين يريدون إعداد تقارير عن برامج إعلانات متعدّدة ("AdSense للبحث" و"AdSense للفيديو" وما إلى ذلك)
حسابات متعددة
يمكن أن يملك المستخدمون إذن الوصول إلى أكثر من حساب واحد على AdSense. يجب تحديد رقم تعريف حساب لكل استدعاء لواجهة برمجة التطبيقات لهذا السبب. يؤدي الاستدعاء إلى
accounts.list لجلب قائمة بالحسابات ومن المفترض أن يتم عرض مربع حوار أداة اختيار الحساب للمستخدم. يمكن تجاوزه إذا كان عدد
الحسابات التي تم جلبها واحدًا.
تغييرات المنطقة الزمنية
يمكن للناشرين في AdSense تغيير منطقتهم الزمنية في أي وقت، ما قد يؤدي إلى حدوث ارتفاعات أو انخفاضات في التقارير. يُرجى قراءة الدليل حول الإبلاغ عن المنطقة الزمنية المحلية للحصول على مزيد من المعلومات.