AdSense Management API تماس هایی برای تولید گزارش های جدید و ذخیره شده دارد. آنها می توانند شامل تجزیه و تحلیل ساده مانند درآمد در روز یا جداول بسیار پیچیده نرخ کلیک در هر کانال سفارشی در هر کشور باشند. این راهنما فهرستی از موارد لبه ای را ارائه می دهد که برای یکپارچگی قوی با API ها باید به درستی مدیریت شوند.
ساختار گزارش
نتایج گزارش به عنوان یک شی ReportResult برگردانده می شود. برای جزئیات کامل به مرجع پاسخ گزارش مراجعه کنید.
با استفاده از ابعاد زمانی: DATE، WEEK و MONTH
گزارش ها می توانند خالی یا دارای شکاف باشند
اگر در بازه زمانی مشخص شده در درخواست هیچ فعالیتی وجود نداشته باشد، هیچ درخواست تبلیغاتی ایجاد نمی‌شود و سرویس گزارش ردیف‌هایی را برای آن دوره‌های زمانی نشان نمی‌دهد. اگر مثلاً در حال رسم نمودار هستید، این مهم است.
برای اطلاعات بیشتر راهنمای تکمیل تاریخ ها را بررسی کنید.
درخواست ابعاد MONTH و WEEK در همان گزارش
این گزارش می تواند پیامدهای منفی یا غیرمنتظره ای داشته باشد. اگر یک هفته متعلق به دو ماه متفاوت باشد، دو ردیف برای یک هفته نشان می دهد، یکی برای هر ماه.
مثال
| ابعاد | معیارهای | تاریخ شروع | تاریخ پایان |
|---|---|---|---|
WEEKMONTH | CLICKS | 28/04/2014 | 03/05/2014 |
برمی گرداند:
MONTH | WEEK * | CLICKS |
|---|---|---|
| 2014-04 | 27/04/2014 | 50 |
| 2014-05 | 27/04/2014 | 43 |
* اولین روز هفته
راه حل
MONTH از گزارش حذف کنید.
WEEK | CLICKS |
|---|---|
| 27/04/2014 | 93 |
جمع آوری مقادیر ابعاد
هنگام درخواست ابعادی مانند موارد مربوط به مثلاً پلتفرم‌ها (رومیزی، دستگاه‌های تلفن همراه پیشرفته و غیره)، فقط پلتفرم‌های دارای فعالیت نشان داده می‌شوند. اگر روز، هفته یا ماه معینی هیچ بازدیدی از دستگاه های تلفن همراه پیشرفته نداشته باشد، هیچ اطلاعاتی برای آن دسته نخواهد داشت.
مثال
| ابعاد | معیارهای | تاریخ شروع | تاریخ پایان |
|---|---|---|---|
PLATFORM_TYPE_NAMEMONTH | AD_REQUESTS | 01/02/2014 | 31/03/2014 |
برمی گرداند:
| ماه | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 03-2014 | دسکتاپ | 100 |
| 03-2014 | دستگاه های موبایل پیشرفته | 5 |
| 2014-04 | دسکتاپ | 75 |
راه حل
هنگام پردازش نتایج گزارش، برای هر مقدار ابعادی که در نتایج ظاهر نمی شود، مقدار صفر در نظر بگیرید:
| ماه | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 03-2014 | دسکتاپ | 100 |
| 03-2014 | دستگاه های موبایل پیشرفته | 5 |
| 2014-04 | دسکتاپ | 75 |
| 2014-04 | دستگاه های موبایل پیشرفته | 0 |
ترکیب چندین گزارش پیوسته
گاهی اوقات یک گزارش آنقدر بزرگ است که به یکباره تولید نمی شود و باید دسته بندی شود. اگر برنامه شما این کار را انجام می دهد، موارد زیر را در نظر بگیرید:
- اگر از ابعاد
WEEKیاMONTHاستفاده می‌کنید و گزارش را در وسط یک هفته یا ماه تقسیم می‌کنید، هر گزارش ورودی‌های تکراری با داده‌های متفاوت خواهد داشت. - مطمئن شوید که همه گزارش‌ها معیارها و ابعاد یکسانی دارند، زیرا ممکن است داده‌ها با استفاده از ابعاد مختلف قابل ترکیب نباشند.
حساب های ویژه
برخی از کاربران شما ممکن است حساب‌های AdSense با ویژگی‌هایی داشته باشند که انتظار یا اطلاعی از آنها ندارید. حتما در نظر بگیرید:
- ناشران با هزاران دامنه یا سایت
- ناشران با هزاران واحد تبلیغاتی یا کانال سفارشی
- ناشرانی که مایلند در مورد چندین مشتری تبلیغاتی (AdSense for Search، AdSense for Video و غیره) گزارش دهند.
چند اکانت
کاربران می توانند به بیش از یک حساب AdSense دسترسی داشته باشند. به همین دلیل باید برای هر تماس با API یک شناسه حساب مشخص شود. تماس با accounts.list فهرستی از حساب ها را واکشی می کند و یک گفتگوی انتخابگر حساب باید به کاربر نمایش داده شود. اگر تعداد حساب های واکشی شده یک عدد باشد، می توان آن را دور زد.
منطقه زمانی تغییر می کند
ناشران AdSense می‌توانند منطقه زمانی خود را در هر زمانی تغییر دهند و این می‌تواند باعث افزایش یا کاهش در گزارش‌ها شود. برای اطلاعات بیشتر، راهنمای گزارش‌دهی منطقه زمانی محلی را بخوانید.