বস্তু পুনরুদ্ধার করা হচ্ছে

উদ্দেশ্য: GoogleAdsService ব্যবহার করে কীভাবে বস্তু এবং কর্মক্ষমতা পরিসংখ্যান পুনরুদ্ধার করতে হয় তা বুঝুন। রিপোর্টিং ধারণাগুলির জন্য, রিপোর্টিং নির্দেশিকা দেখুন।

GoogleAdsService হল Google Ads API-এর একীভূত অবজেক্ট পুনরুদ্ধার এবং রিপোর্টিং পরিষেবা। পরিষেবাটিতে এমন পদ্ধতি রয়েছে যা:

• বস্তুর নির্দিষ্ট বৈশিষ্ট্যগুলি পুনরুদ্ধার করুন।
• তারিখের পরিসরের উপর ভিত্তি করে বস্তুর কর্মক্ষমতা মেট্রিক্স পুনরুদ্ধার করুন।
• বস্তুগুলিকে তাদের বৈশিষ্ট্যের উপর ভিত্তি করে সাজান।
• প্রতিক্রিয়ায় আপনি কোন বস্তুগুলি ফেরত চান তা নির্দেশ করার জন্য শর্তাবলী ব্যবহার করুন।
• ফেরত পাঠানো বস্তুর সংখ্যা সীমিত করুন।

GoogleAdsService দুটি উপায়ে ফলাফল ফেরত দিতে পারে:

• GoogleAdsService.SearchStream সমস্ত সারিকে একটি একক স্ট্রিমিং প্রতিক্রিয়ায় ফেরত পাঠায় যা বৃহৎ (১০,০০০ সারির বেশি) ফলাফল সেটের জন্য আরও দক্ষ। আপনার ব্যাচ অ্যাপ্লিকেশন যত দ্রুত সম্ভব ডেটা ডাউনলোড করতে চাইলে এটি আরও উপযুক্ত হতে পারে।
• GoogleAdsService.Search বৃহৎ প্রতিক্রিয়াগুলিকে পরিচালনাযোগ্য ফলাফলের পৃষ্ঠাগুলিতে বিভক্ত করে। আপনার ইন্টারেক্টিভ অ্যাপ্লিকেশনটি যদি একবারে ফলাফলের একটি পৃষ্ঠা প্রদর্শন করে তবে এটি আরও উপযুক্ত হতে পারে।

পেজিং বনাম স্ট্রিমিং সম্পর্কে আরও জানুন।

একটি অনুরোধ করুন

অনুসন্ধান পদ্ধতির জন্য একটি SearchGoogleAdsRequest প্রয়োজন, যার মধ্যে নিম্নলিখিত বৈশিষ্ট্যগুলি রয়েছে:

• একটি customer_id
• একটি Google বিজ্ঞাপন কোয়েরি ভাষা query যা কোন রিসোর্স কোয়েরি করতে হবে, কোন বৈশিষ্ট্য, বিভাগ এবং মেট্রিক্স পুনরুদ্ধার করতে হবে এবং কোন বস্তুগুলি ফেরত দেওয়া হবে তা সীমাবদ্ধ করার জন্য ব্যবহার করা শর্তগুলি নির্দেশ করে।
• (শুধুমাত্র GoogleAdsService.Search ) পেজিং ব্যবহার করার সময় পরবর্তী ব্যাচের ফলাফল পুনরুদ্ধার করার জন্য একটি ঐচ্ছিক page_token ।

গুগল বিজ্ঞাপন কোয়েরি ভাষা সম্পর্কে আরও তথ্যের জন্য, গুগল বিজ্ঞাপন কোয়েরি ভাষা নির্দেশিকাটি দেখুন।

একটি প্রতিক্রিয়া প্রক্রিয়া করুন

GoogleAdsService GoogleAdsRow অবজেক্টের একটি তালিকা প্রদান করে।

প্রতিটি GoogleAdsRow একটি কোয়েরি দ্বারা ফেরত পাঠানো একটি বস্তুকে প্রতিনিধিত্ব করে এবং এতে SELECT ধারায় অনুরোধ করা ক্ষেত্রগুলির উপর ভিত্তি করে পূরণ করা বৈশিষ্ট্যের একটি সেট থাকে। SELECT ধারায় অন্তর্ভুক্ত নয় এমন বৈশিষ্ট্যগুলি প্রতিক্রিয়ার GoogleAdsRow বস্তুতে পূরণ করা হয় না।

উদাহরণস্বরূপ, যদিও একটি ad_group_criterion একটি status অ্যাট্রিবিউট থাকে, সারির ad_group_criterion অ্যাট্রিবিউটের status ফিল্ডটি এমন একটি প্রশ্নের উত্তরে পূরণ করা হয় না যেখানে SELECT ক্লজে ad_group_criterion.status অন্তর্ভুক্ত থাকে না। একইভাবে, সারির campaign অ্যাট্রিবিউটটি পূরণ করা হয় না যদি SELECT ক্লজে campaign রিসোর্স থেকে কোনও ক্ষেত্র অন্তর্ভুক্ত না থাকে।

প্রতিটি GoogleAdsRow একই ফলাফল সেটের অন্য সারির থেকে আলাদা বৈশিষ্ট্য এবং মেট্রিক্স থাকতে পারে; তাই সারিগুলিকে একটি টেবিলের স্থির সারি হিসেবে না দেখে বস্তু হিসেবে দেখা উচিত।

অজানা এনাম প্রকার

UNKNOWN ধরণের রিটার্ন সহ রিসোর্সগুলি সেই API সংস্করণে সম্পূর্ণরূপে সমর্থিত নয়। এই রিসোর্সগুলি Google Ads UI এর মতো অন্যান্য ইন্টারফেসের মাধ্যমে তৈরি করা যেতে পারে। যখন কোনও রিসোর্সে UNKNOWN ধরণের থাকে তখন আপনি মেট্রিক্স নির্বাচন করতে পারেন, কিন্তু আপনি API এর মাধ্যমে রিসোর্সটি পরিবর্তন করতে পারবেন না। এর একটি উদাহরণ হতে পারে একটি নতুন প্রচারণা বা বিজ্ঞাপন যা UI তে চালু করা হচ্ছে, কিন্তু আপনি যে API সংস্করণটি অনুসন্ধান করছেন তাতে সমর্থিত নয়।

এখানে কিছু বিবেচ্য বিষয় মনে রাখতে হবে:

• UNKNOWN ধরণের একটি রিসোর্স পরেও সমর্থিত হতে পারে অথবা অনির্দিষ্টকালের জন্য UNKNOWN থাকতে পারে।
• UNKNOWN টাইপের নতুন অবজেক্ট যেকোনো সময় দেখা যেতে পারে। এই অবজেক্টগুলি ব্যাকওয়ার্ড সামঞ্জস্যপূর্ণ কারণ enum মান ইতিমধ্যেই উপলব্ধ। এই পরিবর্তনের সাথে রিসোর্সগুলি উপলব্ধ থাকার সাথে সাথে প্রবর্তন করা হয় যাতে আপনি আপনার অ্যাকাউন্টের সঠিক ধারণা পেতে পারেন। অন্যান্য ইন্টারফেসের মাধ্যমে আপনার অ্যাকাউন্টে নতুন কার্যকলাপের কারণে, অথবা যখন কোনও রিসোর্স আর সমর্থিত না থাকে তখন UNKNOWN রিসোর্সটি দেখা যেতে পারে।
• UNKNOWN সম্পদের সাথে বিস্তারিত মেট্রিক্স সংযুক্ত থাকতে পারে যা জিজ্ঞাসাযোগ্য।
• UNKNOWN রিসোর্সগুলি সাধারণত Google বিজ্ঞাপন UI-তে সম্পূর্ণরূপে দৃশ্যমান হয়।
• UNKNOWN সম্পদ সাধারণত পরিবর্তন করা যায় না।

বিভাজন

প্রতিক্রিয়াটিতে নিম্নলিখিত প্রতিটি সংমিশ্রণের জন্য একটি করে GoogleAdsRow থাকবে:

• FROM ধারায় উল্লেখিত মূল সম্পদের উদাহরণ
• প্রতিটি নির্বাচিত segment ক্ষেত্রের মান

উদাহরণস্বরূপ, SELECT ধারায় FROM campaign নির্বাচন করে এবং segments.ad_network_type এবং segments.date আছে এমন একটি প্রশ্নের উত্তরে নিম্নলিখিতগুলির প্রতিটি সংমিশ্রণের জন্য একটি করে সারি থাকবে:

• campaign
• segments.ad_network_type
• segments.date

ফলাফলগুলি মূল সম্পদের প্রতিটি উদাহরণ দ্বারা পরোক্ষভাবে ভাগ করা হয়, নির্বাচিত পৃথক ক্ষেত্রের মান দ্বারা নয়। উদাহরণস্বরূপ,

SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS

এর ফলে প্রতিটি প্রচারণায় একটি সারি তৈরি হয়, campaign.status ক্ষেত্রের প্রতিটি স্বতন্ত্র মানের জন্য একটি সারি তৈরি হয় না।