এই নির্দেশিকাটি গুগল অ্যাডস UI-তে থাকা রিপোর্টগুলির ধারণা ও নামকরণের রীতির সাথে গুগল অ্যাডস কোয়েরি ল্যাঙ্গুয়েজ (GAQL) এবং গুগল অ্যাডস API ব্যবহার করে তৈরি করা যায় এমন রিপোর্টগুলির সংযোগ স্থাপন করে।
সাধারণ UI পরিভাষা
নিম্নলিখিত সারণিতে UI-তে ব্যবহৃত কিছু সাধারণ পরিভাষা এবং Google Ads Query Language (GAQL)- এর সাথে সেগুলোর সংযোগ সংক্ষেপে তুলে ধরা হলো।
| UI | GAQL |
|---|---|
| কলাম | GAQL কোয়েরির SELECT ক্লজের যেকোনো রিসোর্স, সেগমেন্ট ফিল্ড বা মেট্রিক। |
| তারিখের পরিসর | তারিখের পরিসরগুলো একটি WHERE ক্লজের সাথে সংযুক্ত থাকে, যা segments.date এর উপর ভিত্তি করে ফিল্টার করে। |
| ফিল্টার | WHERE ক্লজে এক বা একাধিক শর্ত। |
| সেগমেন্ট ক্ষেত্র | আপনার GAQL কোয়েরিতে সেগমেন্ট ফিল্ড অন্তর্ভুক্ত করে সেগমেন্টেশন প্রয়োগ করুন। |
| পৃষ্ঠা সংখ্যা | পেজিং কোয়েরির ফলাফল সেটকে একাধিক পেজে বিভক্ত করে। |
কলাম
UI-এর কলামগুলো GAQL-এর রিসোর্স ফিল্ড , সেগমেন্ট ফিল্ড এবং মেট্রিক্সের সমতুল্য।
ফিল্টারিং
আপনি আপনার রিপোর্টের ডেটা ফিল্টার ও সাজাতে পারেন।
তারিখের পরিসর
গুগল অ্যাডস UI-তে অ্যাকাউন্টের পরিসংখ্যান দেখানোর জন্য একটি টেবিল এবং এই পরিসংখ্যানগুলোর তারিখের পরিসীমা নিয়ন্ত্রণ করার জন্য একটি ড্রপ-ডাউন মেনু রয়েছে।
GAQL কোয়েরির WHERE ক্লজে segments.date এর উপর ফিল্টার করার মাধ্যমে আপনি GAQL-এও একই নিয়ন্ত্রণ রাখতে পারেন।
ফিল্টার
UI-এর ফিল্টারগুলো GAQL-এর WHERE ক্লজের এক বা একাধিক শর্তের সমতুল্য।
বিভাজন
আরও বিস্তারিত পরিসংখ্যানের জন্য, ডেটা সেগমেন্ট অনুযায়ী ভাগ করুন। উদাহরণস্বরূপ, ধরুন আপনি গুগল ডিসপ্লে নেটওয়ার্ক থেকে আলাদাভাবে গুগল সার্চ নেটওয়ার্কের ইম্প্রেশনের সংখ্যা দেখতে চান। সেক্ষেত্রে, আপনার রিপোর্টটি নেটওয়ার্ক অনুযায়ী সেগমেন্ট করুন। SELECT ক্লজে কীভাবে সেগমেন্ট ফিল্ড অন্তর্ভুক্ত করতে হয়, তা জানতে সেগমেন্টেশন (Segmentation) অংশটি দেখুন।
পৃষ্ঠা সংখ্যা
প্রতিটি ডেটা টেবিলের নীচে উপলব্ধ কন্ট্রোলগুলি ব্যবহার করে UI-তে আপনার রিপোর্টগুলির মধ্যে নেভিগেট করুন, যা আপনাকে পৃষ্ঠা পরিবর্তন করতে এবং একটি নির্দিষ্ট আকারের সেট থেকে প্রদর্শিত ফলাফলের সংখ্যা নির্বাচন করতে দেয়।
GoogleAdsService.Search ব্যবহার করে next_page_token মাধ্যমে রিপোর্ট আনার সময় ফলাফলের মধ্যে পেজিং করা যায়। কোনো পেজিনেশন ছাড়াই সম্পূর্ণ ফলাফল সেট পেতে, GoogleAdsService.SearchStream ব্যবহার করুন।
ফলাফল অর্ডার করুন
UI-তে, আপনি একটি কলাম নির্বাচন করে ফলাফলগুলো সাজাতে পারেন।
GAQL-এ, আপনি আপনার কোয়েরির ফলাফল সাজানোর জন্য ORDER BY ক্লজ এবং LIMIT ক্লজ ব্যবহার করতে পারেন।
ডাউনলোড ফরম্যাট
ইউজার ইন্টারফেস থেকে রিপোর্টগুলো CSV, TSV বা XML-এর মতো বিভিন্ন ফরম্যাটে ডাউনলোড করা যায়।
এপিআই তার আউটপুটে সরাসরি বিভিন্ন ফরম্যাট সমর্থন করে না, তাই আপনাকে কিছু পোস্ট-প্রসেসিং করতে হবে। এই কোড উদাহরণটি দেখুন, যেখানে দেখানো হয়েছে কীভাবে একটি ক্লায়েন্টে CSV ফরম্যাটিং প্রয়োগ করতে হয়।
সময়সূচী এবং ইমেল রিপোর্ট
আপনি UI থেকে একটি রিপোর্ট শিডিউল করতে এবং ইমেল করতে পারেন, কিন্তু এই বৈশিষ্ট্যগুলো API-তে সমর্থিত নয়।
পূর্বনির্ধারিত প্রতিবেদন
আপনি গুগল অ্যাডস UI-তে পূর্বনির্ধারিত রিপোর্টের একটি তালিকা তৈরি করতে পারেন।
এখানে মৌলিক পূর্বনির্ধারিত রিপোর্টসমূহ এবং তাদের সংশ্লিষ্ট GAQL রিসোর্স নেমের একটি তালিকা দেওয়া হলো।
| মৌলিক পূর্বনির্ধারিত প্রতিবেদন | GAQL রিসোর্সের নাম ( FROM ক্লজে উল্লেখ করুন) |
|---|---|
| অ্যাকাউন্ট | গ্রাহক |
| প্রচারণা, প্রচারণার বিবরণ | প্রচারণা |
| বিজ্ঞাপন গোষ্ঠী, বিজ্ঞাপন গোষ্ঠীর বিবরণ | বিজ্ঞাপন_গোষ্ঠী |
| বিজ্ঞাপন, চূড়ান্ত ইউআরএল | বিজ্ঞাপন_গ্রুপ_বিজ্ঞাপন |
| কীওয়ার্ড অনুসন্ধান করুন | কীওয়ার্ড_ভিউ |
| অনুসন্ধানের শর্তাবলী | অনুসন্ধান_শব্দ_ভিউ |
| পরিশোধিত এবং জৈব | পেইড_অর্গানিক_সার্চ_টার্ম_ভিউ |
| ল্যান্ডিং পেজ | ল্যান্ডিং_পেজ_ভিউ |
| সম্প্রসারিত ল্যান্ডিং পৃষ্ঠা | প্রসারিত_ল্যান্ডিং_পৃষ্ঠা_ভিউ |
| বিষয়বস্তু > প্লেসমেন্ট | পরিচালিত প্লেসমেন্ট ভিউ |
| বিষয়বস্তু > যেখানে বিজ্ঞাপন দেখানো হয়েছিল | গ্রুপ_প্লেসমেন্ট_ভিউ |
| বিষয়বস্তু > যেখানে বিজ্ঞাপন দেখানো হয়েছে > বিস্তারিত দেখুন | বিস্তারিত_স্থাপন_দৃশ্য |
পূর্ববর্তী সারণী থেকে উদাহরণ হিসেবে, আপনি অ্যাকাউন্ট রিপোর্ট তৈরি করতে নিম্নলিখিত 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
সাধারণ পার্থক্য
UI রিপোর্ট এবং API রিপোর্টের তুলনা করার সময়, সবচেয়ে সাধারণ পার্থক্যগুলোর মধ্যে একটি হলো এই যে, UI স্বয়ংক্রিয়ভাবে অপসারিত এনটিটিগুলোকে ফিল্টার করে দেয়, কিন্তু API তা করে না।
ডিফল্ট UI ভিউ অনুকরণ করার জন্য, মুছে ফেলা সারিগুলো বাদ দিতে আপনাকে একটি ফিল্টার যোগ করতে হবে, যা সাধারণত একটি status ফিল্ড ব্যবহার করে করা হয়। উদাহরণস্বরূপ:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"