AdSense Management API دارای فراخوانیهایی برای تولید گزارشهای جدید و ذخیرهشده است. این گزارشها میتوانند حاوی تحلیلهای سادهای مانند درآمد روزانه یا جدولهای بسیار پیچیدهای از نرخ کلیکگذری برای هر کانال سفارشی در هر کشور باشند. این راهنما فهرستی از موارد حاشیهای را ارائه میدهد که باید بهدرستی مدیریت شوند تا ادغام با میاناهای برنامهسازی کاربردی بهطور پایدار انجام شود.
ساختار گزارش
نتایج گزارش بهصورت شیء ReportResult برگردانده میشود. برای جزئیات کامل،
مرجع پاسخ
گزارش را ببینید.
استفاده از ابعاد زمانی: DATE (تاریخ)، WEEK (هفته)، و MONTH (ماه)
گزارشها ممکن است خالی باشند یا شکافهایی داشته باشند
اگر درطول دوره زمانی مشخصشده در درخواست فعالیتی وجود نداشته باشد، هیچ درخواست آگهیای تولید نمیشود و سرویس گزارش ردیفهایی را برای آن دورههای زمانی نشان نخواهد داد. این مورد برای مثال زمانی اهمیت دارد که درحال رسم نمودار هستید.
برای اطلاعات بیشتر، راهنمای تکمیل کردن تاریخها را بررسی کنید.
درخواست ابعاد «ماه» و «هفته» در یک گزارش
این گزارش میتواند پیامدهای منفی یا غیرمنتظره داشته باشد. اگر یک هفته به دو ماه مختلف تعلق داشته باشد، دو ردیف برای همان هفته نشان داده میشود، یکی برای هر ماه.
مثال
| ابعاد | سنجهها | تاریخ شروع | تاریخ پایان |
|---|---|---|---|
WEEKMONTH |
CLICKS | 2014-04-28 | 2014-05-03 |
برمیگرداند:
MONTH | WEEK* | CLICKS |
|---|---|---|
| 2014-04 | 2014-04-27 | 50 |
| 2014-05 | ۲۰۱۴-۰۴-۲۷ | 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 | رایانه | ۷۵ |
راهحل
هنگام پردازش نتایج گزارش، برای هر مقدار بُعدی که در نتایج نشان داده نمیشود، مقدار صفر را درنظر بگیرید:
| ماه | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | رایانه | 100 |
| 2014-03 | دستگاههای همراه پیشرفته | 5 |
| 2014-04 | رایانه | ۷۵ |
| 2014-04 | دستگاههای همراه پیشرفته | ۰ |
ترکیب کردن چندین گزارش مجاور
گاهیاوقات گزارش برای تولید یکباره بسیار بزرگ است و باید دستهبندی شود. اگر برنامهتان این کار را انجام میدهد، این موارد را درنظر بگیرید:
- اگر از بُعدهای
WEEKیاMONTHاستفاده میکنید و گزارش را در اواسط هفته یا ماه تقسیم میکنید، هر گزارش ورودیهای تکراری با دادههای متفاوت خواهد داشت. - مطمئن شوید همه گزارشها سنجهها و ابعاد یکسانی داشته باشند، زیرا ممکن است دادهها بااستفاده از ابعاد مختلف قابلترکیب نباشند.
حسابهای ویژه
برخیاز کاربران شما ممکن است حسابهای AdSense با ویژگیهایی داشته باشند که شما انتظار ندارید یا از آنها اطلاعی ندارید. حتماً موارد زیر را درنظر بگیرید:
- ناشران با هزاران دامنه یا سایت
- ناشرانی که هزاران واحد آگهی یا کانال سفارشی دارند
- ناشرانی که میخواهند درباره چند مشتری آگهی (AdSense برای جستجو، AdSense برای ویدیو، و غیره) گزارش دهند.
چند حساب
کاربران میتوانند به بیشاز یک حساب AdSense دسترسی داشته باشند. به همین دلیل، برای هر فراخوانی به API باید شناسه حساب مشخص شود. فراخوانی
accounts.list فهرستی از حسابها را واکشی میکند و کادر گفتگوی انتخابگر حساب
باید به کاربر نشان داده شود. اگر تعداد حسابهای واکشیشده یک عدد باشد، میتوان از آن عبور کرد.
تغییرات منطقه زمانی
ناشران AdSense میتوانند منطقه زمانی خود را در هر زمانی تغییر دهند و این میتواند باعث افزایش یا کاهش ناگهانی در گزارشها شود. برای اطلاعات بیشتر، راهنمای گزارشدهی منطقه زمانی محلی را بخوانید.