এই নির্দেশিকাটি Google Ads UI-তে রিপোর্টের ধারণা এবং নামকরণের নিয়মগুলিকে সেই রিপোর্টগুলিতে ম্যাপ করে যা আপনি Google Ads Query Language (GAQL) এবং Google Ads API ব্যবহার করে তৈরি করতে পারেন।
সাধারণ UI শর্তাবলী
নিম্নলিখিত সারণীতে UI-তে ব্যবহৃত কিছু সাধারণ শব্দ এবং Google Ads Query Language (GAQL)- এ তাদের ম্যাপিংয়ের সংক্ষিপ্ত বিবরণ দেওয়া হয়েছে।
UI | GAQL |
---|---|
কলাম | একটি GAQL ক্যোয়ারির সিলেক্ট ক্লজে যেকোন রিসোর্স, সেগমেন্ট ফিল্ড বা মেট্রিক। |
তারিখ পরিসীমা | তারিখের ব্যাপ্তিগুলি segments.date এ একটি WHERE ক্লজ ফিল্টারিং এর মানচিত্র। |
ফিল্টার | WHERE ক্লজে এক বা একাধিক শর্ত। |
সেগমেন্ট ক্ষেত্র | আপনার GAQL ক্যোয়ারীতে সেগমেন্ট ক্ষেত্রগুলি অন্তর্ভুক্ত করে বিভাজন প্রয়োগ করুন। |
পৃষ্ঠা সংখ্যা | পেজিং কোয়েরির ফলাফল সেটকে একাধিক পৃষ্ঠায় বিভক্ত করে। |
কলাম
UI-এর কলামগুলি GAQL-এর রিসোর্স ক্ষেত্র , সেগমেন্ট ক্ষেত্র এবং মেট্রিক্সের সমতুল্য৷
ফিল্টারিং
আপনি আপনার প্রতিবেদনে ডেটা ফিল্টার এবং সংগঠিত করতে পারেন।
তারিখ ব্যাপ্তি
Google Ads UI-তে অ্যাকাউন্ট পরিসংখ্যান প্রদর্শনের একটি টেবিল এবং এই পরিসংখ্যানগুলির তারিখ পরিসর নিয়ন্ত্রণ করার জন্য একটি ড্রপ-ডাউন মেনু রয়েছে।
একটি GAQL কোয়েরির WHERE ক্লজে segments.date
ফিল্টার করে GAQL-এ আপনার একই নিয়ন্ত্রণ রয়েছে।
ফিল্টার
UI-তে ফিল্টারগুলি GAQL-এর WHERE ক্লজের এক বা একাধিক শর্তের সমতুল্য।
সেগমেন্টেশন
আরও বিশদ পরিসংখ্যানের জন্য, বিভাগ দ্বারা ডেটা বিভক্ত করুন। উদাহরণস্বরূপ, ধরুন আপনি Google ডিসপ্লে নেটওয়ার্ক থেকে আলাদাভাবে Google অনুসন্ধান নেটওয়ার্কের জন্য নির্দিষ্ট ইম্প্রেশনের সংখ্যা দেখতে চান৷ সেক্ষেত্রে, নেটওয়ার্ক অনুসারে আপনার রিপোর্ট ভাগ করুন। SELECT ক্লজে সেগমেন্ট ক্ষেত্রগুলিকে কীভাবে অন্তর্ভুক্ত করতে হয় সে সম্পর্কে সেগমেন্টেশন দেখুন।
পৃষ্ঠা সংখ্যা
ডেটার প্রতিটি সারণীর নীচে উপলব্ধ নিয়ন্ত্রণগুলি ব্যবহার করে UI-তে আপনার রিপোর্টগুলির মাধ্যমে নেভিগেট করুন যা আপনাকে পৃষ্ঠাগুলি পরিবর্তন করতে দেয় এবং একটি নির্দিষ্ট আকারের সেট থেকে প্রদর্শিত ফলাফলের সংখ্যা নির্বাচন করতে দেয়৷
GoogleAdsService.Search
এর মাধ্যমে রিপোর্ট পুনরুদ্ধার করার সময় ফলাফলের মাধ্যমে পেজিং পাওয়া যায়। next_page_token
এর মাধ্যমে অনুসন্ধান করুন। কোনো পেজিনেশন ছাড়াই সম্পূর্ণ ফলাফল সেট আনতে, GoogleAdsService.SearchStream
ব্যবহার করুন।
অর্ডার ফলাফল
UI-তে, আপনি একটি কলাম নির্বাচন করে ফলাফল অর্ডার করতে পারেন।
GAQL-এ, আপনি আপনার প্রশ্নের ফলাফল অর্ডার করতে ORDER BY clause এবং LIMIT clause ব্যবহার করতে পারেন।
ফরম্যাট ডাউনলোড করুন
UI-তে, রিপোর্টগুলি বিভিন্ন ফর্ম্যাটে ডাউনলোড করা যেতে পারে, যেমন CSV, TSV, বা XML৷
API সরাসরি তার আউটপুটে বিভিন্ন ফর্ম্যাট সমর্থন করে না, তাই আপনাকে কিছু পোস্ট-প্রসেসিং করতে হবে। এই কোডের উদাহরণটি দেখুন যা দেখায় কিভাবে একটি ক্লায়েন্টে CSV ফর্ম্যাটিং প্রয়োগ করতে হয়।
সময়সূচী এবং ইমেল রিপোর্ট
আপনি UI থেকে একটি প্রতিবেদনের সময়সূচী এবং ইমেল করতে পারেন, কিন্তু এই বৈশিষ্ট্যগুলি API-এ সমর্থিত নয়৷
পূর্বনির্ধারিত প্রতিবেদন
আপনি Google Ads UI-তে পূর্বনির্ধারিত প্রতিবেদনের একটি তালিকা তৈরি করতে পারেন।
এখানে প্রাথমিক পূর্বনির্ধারিত প্রতিবেদনের একটি তালিকা এবং তাদের মিলিত GAQL সম্পদের নাম।
প্রাথমিক পূর্বনির্ধারিত প্রতিবেদন | GAQL সম্পদের নাম ( FROM ধারায় উল্লেখ করুন) |
---|---|
হিসাব | গ্রাহক |
প্রচারণা, প্রচারের বিশদ বিবরণ | প্রচারণা |
বিজ্ঞাপন গ্রুপ, বিজ্ঞাপন গোষ্ঠীর বিবরণ | বিজ্ঞাপন_গোষ্ঠী |
বিজ্ঞাপন, চূড়ান্ত URL | ad_group_ad |
অনুসন্ধান কীওয়ার্ড | keyword_view |
অনুসন্ধান পদ | সার্চ_টার্ম_ভিউ |
প্রদত্ত এবং জৈব | অর্থপ্রদানের_জৈব_অনুসন্ধান_পরিমাণ_দর্শন |
ল্যান্ডিং পৃষ্ঠা | ল্যান্ডিং_পৃষ্ঠা_দর্শন |
প্রসারিত ল্যান্ডিং পৃষ্ঠা | প্রসারিত_ল্যান্ডিং_পৃষ্ঠা_দর্শন |
পূর্ববর্তী টেবিল থেকে একটি উদাহরণ হিসাবে, আপনি অ্যাকাউন্ট রিপোর্ট তৈরি করতে নিম্নলিখিত GAQL ব্যবহার করতে পারেন:
SELECT
customer.descriptive_name,
customer.id,
metrics.clicks,
metrics.impressions,
metrics.ctr,
metrics.average_cpc,
metrics.cost_micros,
metrics.absolute_top_impression_percentage,
metrics.top_impression_percentage,
metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS
সাধারণ পার্থক্য
API রিপোর্টের সাথে UI প্রতিবেদনের তুলনা করার সময়, সবচেয়ে সাধারণ পার্থক্যগুলির মধ্যে একটি হল যে UI অন্তর্নিহিতভাবে সরানো সত্তাগুলিকে ফিল্টার করে, যেখানে API তা করে না।
একটি ডিফল্ট UI ভিউ প্রতিলিপি করার জন্য, আপনাকে একটি ফিল্টার যোগ করতে হবে, সাধারণত একটি status
ক্ষেত্র ব্যবহার করে, সরানো সারিগুলি বাদ দিতে৷ যেমন:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"