AdSense Management API-তে নতুন ও সেভ করা রিপোর্ট তৈরি করার জন্য কল আছে। এতে প্রতিদিনের উপার্জনের মতো সহজ অ্যানালিটিক্স বা দেশ অনুযায়ী কাস্টম চ্যানেল পিছু ক্লিক-থ্রু রেটের মতো জটিল টেবিল থাকতে পারে। এই গাইডে এমন কিছু এজ কেসের তালিকা দেওয়া হয়েছে যেগুলি API-এর সাথে ইন্টিগ্রেশন মজবুত করার জন্য সঠিকভাবে ম্যানেজ করা উচিত।
রিপোর্টের স্ট্রাকচার
রিপোর্ট ফলাফল ReportResult অবজেক্ট হিসেবে ফেরত পাঠানো হয়। সম্পূর্ণ বিবরণের জন্য
রিপোর্ট
রেসপন্স রেফারেন্স দেখুন।
কালানুক্রমিক ডাইমেনশন ব্যবহার করা: তারিখ, সপ্তাহ এবং মাস
রিপোর্ট খালি থাকতে পারে বা তাতে ফাঁক থাকতে পারে
অনুরোধে উল্লেখ করা সময়সীমার মধ্যে কোনও অ্যাক্টিভিটি না থাকলে, কোনও বিজ্ঞাপনের অনুরোধ তৈরি হয় না এবং রিপোর্ট পরিষেবা সেই সময়সীমার জন্য কোনও সারি দেখাবে না। এটি গুরুত্বপূর্ণ যদি আপনি, উদাহরণস্বরূপ, একটি গ্রাফ প্লট করছেন।
আরও তথ্যের জন্য তারিখ পূরণ করা সংক্রান্ত নির্দেশিকা দেখুন।
একই রিপোর্টে মাস এবং সপ্তাহের ডাইমেনশনের জন্য অনুরোধ করা হচ্ছে
এই রিপোর্টের নেতিবাচক বা অপ্রত্যাশিত ফলাফল হতে পারে। কোনও সপ্তাহ দুটি আলাদা মাসের মধ্যে পড়লে, একই সপ্তাহের জন্য দুটি সারি দেখানো হবে, প্রতিটি মাসের জন্য একটি করে।
উদাহরণ
| আকার | মেট্রিক্স | শুরুর তারিখ | শেষ হওয়ার তারিখ |
|---|---|---|---|
WEEKMONTH |
CLICKS | 2014-04-28 | 2014-05-03 |
ফেরত:
MONTH | WEEK* | CLICKS |
|---|---|---|
| 2014-04 | 2014-04-27 | 50 |
| 2014-05 | ২৭-০৪-২০১৪ | ৪৩ |
* সপ্তাহের প্রথম দিন
সমাধান
রিপোর্ট থেকে 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 |
| ২০১৪-০৪ | উন্নত প্রযুক্তির মোবাইল ডিভাইস | ০ |
একাধিক সংলগ্ন রিপোর্ট একত্রিত করা হচ্ছে
কখনও কখনও রিপোর্ট অনেক বড় হওয়ার কারণে একবারে তৈরি করা যায় না এবং এটি ব্যাচ হিসেবে তৈরি করতে হয়। আপনার অ্যাপ যদি এটি করে, তাহলে এইসব পরিস্থিতি বিবেচনা করুন:
- আপনি
WEEKবাMONTHডাইমেনশন ব্যবহার করলে এবং সপ্তাহ বা মাসের মাঝামাঝি সময়ে রিপোর্ট স্প্লিট করলে, প্রতিটি রিপোর্টে আলাদা ডেটা সহ ডুপ্লিকেট এন্ট্রি থাকবে। - সব রিপোর্টে একই মেট্রিক ও ডাইমেনশন আছে কিনা তা দেখে নিন, কারণ বিভিন্ন ডাইমেনশন ব্যবহার করে ডেটা একত্রিত করা নাও যেতে পারে।
বিশেষ অ্যাকাউন্ট
আপনার কিছু ব্যবহারকারীর AdSense অ্যাকাউন্টে এমন অ্যাট্রিবিউট থাকতে পারে যা আপনি আশা করেননি বা জানেন না। এগুলি বিবেচনা করতে ভুলবেন না:
- হাজার হাজার ডোমেন বা সাইট সহ প্রকাশক
- হাজার হাজার বিজ্ঞাপন ইউনিট বা কাস্টম চ্যানেল সহ প্রকাশক
- যেসব প্রকাশক একাধিক বিজ্ঞাপন ক্লায়েন্ট (AdSense for Search, AdSense for Video ইত্যাদি) সম্পর্কে রিপোর্ট করতে চান
একাধিক অ্যাকাউন্ট
ব্যবহারকারীদের একাধিক AdSense অ্যাকাউন্টে অ্যাক্সেস থাকতে পারে। এই কারণে API-তে করা প্রতিটি কলের জন্য
অ্যাকাউন্ট আইডি উল্লেখ করতে হবে। accounts.list-এ কল করলে অ্যাকাউন্টের তালিকা পাওয়া যায় এবং ব্যবহারকারীকে অ্যাকাউন্ট বাছাইকারী
ডায়ালগ দেখানো উচিত। ফেচ করা অ্যাকাউন্টের সংখ্যা এক হলে
এটি বাইপাস করা যেতে পারে।
টাইম জোন পরিবর্তন
AdSense প্রকাশকরা যেকোনও সময় তাদের টাইমজোন পরিবর্তন করতে পারেন এবং এর ফলে রিপোর্টে স্পাইক বা ডিপ দেখা যেতে পারে। আরও তথ্যের জন্য স্থানীয় টাইম জোন রিপোর্টিং সংক্রান্ত নির্দেশিকা পড়ুন।