AdSense ম্যানেজমেন্ট API-এ নতুন এবং সংরক্ষিত প্রতিবেদন তৈরি করার জন্য কল রয়েছে। এগুলিতে প্রতিদিন উপার্জনের মতো সাধারণ বিশ্লেষণ বা দেশ প্রতি কাস্টম চ্যানেল প্রতি ক্লিক-থ্রু হারের খুব জটিল সারণী থাকতে পারে। এই গাইডটি এজ কেসগুলির একটি তালিকা উপস্থাপন করে যেগুলি 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 অ্যাকাউন্টে অ্যাক্সেস থাকতে পারে। এই কারণে API-তে প্রতিটি কলের জন্য একটি অ্যাকাউন্ট আইডি নির্দিষ্ট করতে হবে। accounts.list এ একটি কল অ্যাকাউন্টের একটি তালিকা নিয়ে আসে এবং ব্যবহারকারীর কাছে একটি অ্যাকাউন্ট চয়নকারী ডায়ালগ প্রদর্শন করা উচিত। আনা অ্যাকাউন্টের সংখ্যা এক হলে এটি বাইপাস করা যেতে পারে।
টাইম জোন পরিবর্তন হয়
AdSense প্রকাশকরা যে কোনো সময় তাদের টাইমজোন পরিবর্তন করতে পারে এবং এটি রিপোর্টে স্পাইক বা ডিপ তৈরি করতে পারে। আরও তথ্যের জন্য স্থানীয় সময় অঞ্চল রিপোর্টিং সম্পর্কে গাইড পড়ুন।