আমার প্রথম অ্যাপে বর্ণিত হিসাবে আপনি আপনার ক্লায়েন্ট অ্যাপ সেট আপ করার পরে, আপনি প্রতিবেদনের অনুরোধ এবং ডাউনলোড করতে অনুসন্ধান বিজ্ঞাপন 360 API ব্যবহার করতে পারেন। আপনি নিম্নলিখিত ধরনের অনুরোধ করতে পারেন:
- সিঙ্ক্রোনাস
শুধুমাত্র একটি অনুরোধের প্রয়োজন এবং একটি JSON-ফরম্যাটেড প্রতিক্রিয়াতে প্রতিবেদনটি ফেরত দেয়। সিঙ্ক্রোনাস অনুরোধ:
- শুধুমাত্র বিজ্ঞাপনদাতা এবং ইঞ্জিন অ্যাকাউন্ট রিপোর্ট ফেরত দিতে পারেন
- Search Ads 360 রিপোর্ট তৈরি না করা পর্যন্ত আপনার ক্লায়েন্টকে ব্লক করুন
আপনি যদি বড় বিজ্ঞাপনদাতা বা ইঞ্জিন-অ্যাকাউন্ট রিপোর্টের জন্য অনুরোধ করেন, আমরা অ্যাসিঙ্ক্রোনাস পদ্ধতির সুপারিশ করি।
- অ্যাসিঙ্ক্রোনাস
আপনাকে একটি প্রাথমিক অনুরোধ পাঠাতে হবে যা রিপোর্টে আপনি যে ডেটা চান তা নির্দিষ্ট করে। তারপরে আপনি অনুসন্ধান বিজ্ঞাপন 360 পোল-এ অতিরিক্ত অনুরোধ পাঠান। যখন অনুসন্ধান বিজ্ঞাপন 360 রিপোর্ট তৈরি করা শেষ করে, আপনি প্রতিবেদনটিকে এক বা একাধিক ফাইল হিসাবে ডাউনলোড করার অনুরোধ পাঠান। অ্যাসিঙ্ক্রোনাস অনুরোধ:
- যে কোনো ধরনের রিপোর্ট ফেরত দিতে পারেন
- একাধিক ফাইলের মধ্যে খুব বড় রিপোর্ট Shards
- রিপোর্টগুলিকে CSV বা TSV হিসাবে ফর্ম্যাট করে৷
ডেটা মডেল: সারি এবং কলাম
অনুসন্ধান বিজ্ঞাপন 360 সারি এবং কলামে প্রতিবেদনে ডেটা সংগঠিত করে। আপনি যে ধরনের প্রতিবেদনের অনুরোধ করছেন তা নির্ধারণ করে যে সারিগুলি ফেরত দেওয়া হয়েছে। উদাহরণস্বরূপ, যদি আপনি একটি কীওয়ার্ড রিপোর্টের অনুরোধ করেন, প্রতিটি সারিতে একটি একক কীওয়ার্ড সম্পর্কে ডেটা থাকবে। সমস্ত রিপোর্ট প্রকারের তালিকার জন্য প্রতিবেদনের প্রকার রেফারেন্স দেখুন। আপনার প্রতিবেদনের অনুরোধে প্রতিটি কলামের নামকরণ করে আপনি রিপোর্টে কোন কলামগুলি চান তা নির্দিষ্ট করুন৷ কলামের তালিকার জন্য প্রতিবেদনের প্রকারের রেফারেন্স দেখুন যা প্রতিটি প্রতিবেদনের প্রকারের জন্য ফেরত দেওয়া যেতে পারে।
কলাম আচরণ
একটি কলামের আচরণ নির্ভর করে কলামটিতে থাকা ডেটার উপর ( প্রতিবেদনের প্রকার রেফারেন্স প্রতিটি কলামের আচরণ প্রদর্শন করে):
অ্যাট্রিবিউট কলাম । একটি অ্যাট্রিবিউট কলামে এমন ডেটা থাকে যা প্রচারাভিযানের নাম বা কীওয়ার্ড বিডের মতো একটি প্রচারাভিযানের কোনো সত্তাকে কনফিগার করে বা শনাক্ত করে। অনুসন্ধান বিজ্ঞাপন 360 API সর্বদা একটি অ্যাট্রিবিউট কলামের বর্তমান মান প্রদান করে, কোনো অনুরোধে উল্লেখ করা তারিখ বা তারিখের পরিসর নির্বিশেষে। উদাহরণস্বরূপ, যদি আপনি গতকাল একটি কীওয়ার্ডের বিড 2.00 থেকে 1.50 এ পরিবর্তন করেন এবং তারপরে গত মাসের ডেটার জন্য একটি প্রতিবেদনের অনুরোধ করেন, তাহলে প্রতিবেদনটি কীওয়ার্ড বিডের জন্য 1.50 এর মান প্রদান করবে।
মেট্রিক কলাম । একটি মেট্রিক কলামে আপনার প্রচারাভিযানের পারফরম্যান্স সম্পর্কে ডেটা থাকে, যেমন একটি বিজ্ঞাপনে ক্লিকের সংখ্যা, ফ্লাডলাইট ট্যাগ দ্বারা রেকর্ড করা ভিজিটের সংখ্যা বা আয়৷ আপনি একটি দিনের একটি সময়সীমা নির্দিষ্ট না করলে, API মেট্রিক কলামগুলির জন্য একটি সমষ্টিগত মান প্রদান করে। উদাহরণস্বরূপ, আপনি যদি গত মাসের ডেটার জন্য একটি প্রতিবেদনের অনুরোধ করেন, তাহলে API গত মাসের জন্য ক্লিকের মোট সংখ্যা ফেরত দেবে।
সেগমেন্ট কলাম । একটি সেগমেন্ট কলাম পৃথক সারিতে ডেটা বিভক্ত করে। উদাহরণস্বরূপ,
dateহল একটি সেগমেন্ট কলাম যা আপনি অনেক ধরনের রিপোর্টের জন্য নির্দিষ্ট করতে পারেন। আপনি যদি 2013-01-01 থেকে 2013-01-07 তারিখের সীমার সাথে একটি কীওয়ার্ড রিপোর্টেdateকলাম নির্দিষ্ট করেন, তাহলে API প্রতিটি কীওয়ার্ডের জন্য সাতটি সারি প্রদান করবে, প্রতিটি একটি দিনের সাথে সম্পর্কিত এবং সেই দিনের জন্য মেট্রিক্স প্রদর্শন করবে। সেগমেন্টেড রিপোর্ট দেখুন।
মুদ্রা
আপনার প্রতিবেদনের অনুরোধটি আর্থিক ডেটার মুদ্রা নির্দিষ্ট করার জন্য প্রয়োজন (উভয় বৈশিষ্ট্য যেমন dailyBudget এবং মেট্রিক্স যেমন cost )। আপনি নিম্নলিখিতগুলির মধ্যে একটি নির্দিষ্ট করতে পারেন:
- এজেন্সির মুদ্রা, যদি প্রতিবেদনটি কোনো এজেন্সি, বিজ্ঞাপনদাতা বা ইঞ্জিন অ্যাকাউন্টের জন্য স্কোপ করা হয়।
- বিজ্ঞাপনদাতার মুদ্রা, যদি প্রতিবেদনটি বিজ্ঞাপনদাতা বা ইঞ্জিন অ্যাকাউন্টে স্কোপ করা হয়।
- ইঞ্জিন অ্যাকাউন্টের মুদ্রা, যদি রিপোর্টটি ইঞ্জিন অ্যাকাউন্টে স্কোপ করা হয়।
- আমেরিকান ডলার
একটি মুদ্রা নির্দিষ্ট করতে Reports.request.statisticsCurrency অনুরোধ সম্পত্তি ব্যবহার করুন।
রিপোর্ট নিজেই Reports.statisticsCurrencyCode সম্পত্তির মুদ্রা নির্দেশ করবে।
সময় অঞ্চল
Search Ads 360 মেট্রিক্স সময় অঞ্চল ছাড়াই তারিখে সংরক্ষণ করা হয়। এই তারিখগুলি ইঞ্জিন মেট্রিক্স (যেমন ক্লিক, ইমপ্রেশন এবং ভিজিট) এর জন্য ইঞ্জিন অ্যাকাউন্ট টাইম জোন এবং রূপান্তর মেট্রিক্সের (যেমন অ্যাকশন, লেনদেন এবং রাজস্ব) জন্য ক্যাম্পেইন ম্যানেজার নেটওয়ার্ক টাইম জোনের সাথে মিলে যায়। যখন রিপোর্টের প্রতিটি মেট্রিক একই টাইম জোন থেকে আসে, তখন অনুরোধে সেই টাইম জোনটি ফেরত দেওয়া হবে। অন্যথায়, কোন টাইম জোন ফেরত দেওয়া হবে না। আপনার অনুরোধগুলি Reports.request.verifySingleTimeZone : true ৷
যদি একটি প্রতিবেদনে উপস্থিত সমস্ত মেট্রিক্স একটি টাইম জোন থেকে হয়, তাহলে সেই সময় অঞ্চলটি Reports.statisticsTimeZoneReports এ ফেরত দেওয়া হয়।