গুগল অ্যাডস কোয়েরি বিল্ডার হলো একটি ইন্টারেক্টিভ টুল, যা আপনাকে গুগল অ্যাডস কোয়েরি ল্যাঙ্গুয়েজ (GAQL) ব্যবহার করে ইন্টারেক্টিভভাবে কোয়েরি তৈরি ও যাচাই করতে সাহায্য করার জন্য ডিজাইন করা হয়েছে। আপনি GAQL-এ নতুন হন বা একজন অভিজ্ঞ ব্যবহারকারী, কোয়েরি বিল্ডার গুগল অ্যাডস এপিআই থেকে আপনার প্রয়োজনীয় সঠিক ডেটা সংগ্রহ করার প্রক্রিয়াকে সহজ করে তুলতে পারে।
সুবিধা
- ব্যবহারের সহজতা: নির্দিষ্ট সিনট্যাক্স এবং উপলব্ধ ফিল্ডগুলির সাথে পরিচিতির প্রয়োজন ছাড়াই GAQL কোয়েরি লেখার প্রক্রিয়াকে সহজ করে তোলে।
- আবিষ্কারযোগ্যতা: গুগল অ্যাডস এপিআই ডেটা মডেলের মধ্যে উপলব্ধ রিসোর্স, ফিল্ড, সেগমেন্ট এবং মেট্রিক্স অন্বেষণ করতে ও খুঁজে পেতে সাহায্য করে।
- ভুলের পরিমাণ হ্রাস: একটি সুসংগঠিত ইন্টারফেস এবং বৈধ বিকল্পগুলোর ড্রপ-ডাউন মেনু প্রদানের মাধ্যমে এটি সিনট্যাক্স ত্রুটি ও টাইপিংয়ের ভুল প্রতিরোধ করতে সাহায্য করে, যা তৈরি হওয়া কোয়েরিটির বৈধতা নিশ্চিত করে।
- দ্রুততর কোয়েরি তৈরি: কোয়েরি স্ট্রিং তৈরি প্রক্রিয়াকে স্বয়ংক্রিয় করার মাধ্যমে ডেভেলপমেন্ট প্রক্রিয়াকে ত্বরান্বিত করে।
- যাচাইকরণ: কোয়েরিগুলো কার্যকর করার আগে এপিআই নিয়মের সাথে মিলিয়ে দেখার জন্য এই টুলটি এপিআই এক্সপ্লোরার এবং কোয়েরি ভ্যালিডেটরের সাথে সংযুক্ত রয়েছে।
এটি কীভাবে কাজ করে
গুগল অ্যাডস কোয়েরি বিল্ডার দৃশ্যমানভাবে GAQL কোয়েরি তৈরি করার জন্য একটি ব্যবহার-বান্ধব ইন্টারফেস প্রদান করে। এর মৌলিক কার্যপ্রবাহটি নিচে দেওয়া হলো:
- একটি রিসোর্স নির্বাচন করুন: আপনি যে সংস্করণটি কোয়েরি করতে চান, তার জন্য রেফারেন্স ট্যাব থেকে প্রাথমিক রিসোর্সটি বেছে নেওয়ার মাধ্যমে শুরু করবেন। এই রিসোর্সটি
FROMক্লজে থাকবে। রিসোর্সগুলো গুগল অ্যাডসের অভ্যন্তরীণ সত্তাগুলোকে (entities) প্রতিনিধিত্ব করে, যেমনcampaign,ad_group, বাkeyword_view। বিল্ডারটি সমস্ত উপলব্ধ রিসোর্সের তালিকা দেখায়। - ফিল্ড নির্বাচন করুন: একবার কোনো রিসোর্স নির্বাচন করা হলে, টুলটি সেই রিসোর্স এবং তার অ্যাট্রিবিউটেড (অন্তর্নিহিতভাবে যুক্ত করা যায় এমন) রিসোর্সগুলোর সাথে সম্পর্কিত অ্যাট্রিবিউট, সেগমেন্ট এবং মেট্রিকসহ সমস্ত নির্বাচনযোগ্য ফিল্ড প্রদর্শন করে। আপনার
SELECTক্লজে ফিল্ড অন্তর্ভুক্ত করার জন্য আপনি চেকবক্স ব্যবহার করতে পারেন। আপনি নির্বাচন করার সাথে সাথে, টুলটি স্বয়ংক্রিয়ভাবে সংশ্লিষ্ট GAQL কোয়েরি স্ট্রিং তৈরি করে, কোনো ত্রুটি থাকলে তা প্রদর্শন করে এবং বেমানান ফিল্ডের সংমিশ্রণগুলো ফিল্টার করে বাদ দেয়। - ফিল্টার প্রয়োগ করুন: ফলাফল ফিল্টার করার জন্য আপনি
WHEREক্লজ শর্ত যোগ করতে পারেন। বিল্ডারটি আপনাকে ফিল্ড, অপারেটর এবং ভ্যালু বেছে নিতে সাহায্য করে এবং সঠিক সিনট্যাক্স নিশ্চিত করে। - ফলাফল সাজানো:
ORDER BYক্লজ ব্যবহার করে সাজানোর ক্রম নির্দিষ্ট করুন। - সীমা নির্ধারণ করুন: ফেরত আসা ফলাফলের সংখ্যা নিয়ন্ত্রণ করতে একটি
LIMITক্লজ যোগ করুন। - যাচাই করুন: টুলটি আপনাকে স্বয়ংক্রিয়ভাবে বৈধ ফিল্ড কম্বিনেশনের দিকে পরিচালিত করে, তবে এটি এপিআই এক্সপ্লোরারের সাথেও লিঙ্ক করে, যাতে আপনি আপনার অ্যাকাউন্ট ডেটার সাথে আপনার কোয়েরি পরীক্ষা করতে পারেন। এছাড়াও একটি পৃথক [কোয়েরি ভ্যালিডেটর](পৃষ্ঠার লিঙ্ক) রয়েছে যেখানে আপনি হাতে লেখা GAQL কোয়েরি পেস্ট করে পরীক্ষা করতে পারেন।
- এক্সপোর্ট: আপনার কোয়েরি নিয়ে সন্তুষ্ট হলে, আপনার পরীক্ষিত ও বাক্যগঠনগতভাবে সঠিক GAQL স্ট্রিংটি কপি করে আপনার
GoogleAdsService.SearchঅথবাSearchStreamক্লায়েন্ট রিকোয়েস্টগুলোতে পেস্ট করুন।
বিল্ডারটি নিশ্চিত করে যে নির্বাচিত ফিল্ড, সেগমেন্ট এবং মেট্রিকগুলো সামঞ্জস্যপূর্ণ এবং গুগল অ্যাডস এপিআই-এর অন্তর্নিহিত মেটাডেটাকে রেফারেন্স করে একটি একক কোয়েরিতে একসাথে ব্যবহার করা যায়।
শুরু করুন
কোয়েরি বিল্ডারে যাওয়ার দুটি উপায় আছে। একটি উপায় হলো রিপোর্টিং রেফারেন্স ডক্সের একটি নির্দিষ্ট পৃষ্ঠার মাধ্যমে যাওয়া, এবং অন্যটি হলো কোয়েরি বিল্ডার ওভারভিউ পৃষ্ঠা থেকে অন্বেষণ করা।
রিপোর্টিং রেফারেন্স ডক্স থেকে
- রিপোর্টিং রেফারেন্স ডক্স দিয়ে শুরু করুন, এবং সমস্ত রিসোর্সের তালিকা থেকে শুরু করার জন্য একটি নির্দিষ্ট রিসোর্স বেছে নিন। বিকল্পভাবে, বাম দিকের নেভিগেশন প্যানেল থেকে সরাসরি রিসোর্সটিতে যান।
- ‘Help me build a query’- তে ক্লিক করুন, যা আপনাকে সেই নির্দিষ্ট রিসোর্সের জন্য কোয়েরি বিল্ডারে নিয়ে যাবে।
কোয়েরি বিল্ডার ওভারভিউ পৃষ্ঠা থেকে
রিপোর্টিং রেফারেন্স ডকুমেন্টের কোয়েরি বিল্ডার বিভাগে যান এবং আপনি যে রিসোর্সটি অন্বেষণ করতে চান তা নির্বাচন করুন।
অন্যান্য টুলের সাথে ইন্টিগ্রেশন
কোয়েরি বিল্ডারটি গুগল অ্যাডস এপিআই ডেভেলপার টুলকিটের অন্যান্য টুলের সাথে সমন্বিত। আপনি কোয়েরি বিল্ডারে তৈরি করা একটি কোয়েরি নিয়ে এপিআই এক্সপ্লোরারে পরীক্ষা করতে পারেন অথবা কোয়েরি ভ্যালিডেটর দিয়ে যাচাই করতে পারেন।
এপিআই এক্সপ্লোরার
আপনার কোয়েরি তৈরি হয়ে গেলে, এপিআই এক্সপ্লোরারে (API Explorer) সেটি খোলার জন্য 'ট্রাই ইন এপিআই এক্সপ্লোরার' (Try in API Explorer) এ ক্লিক করুন। আপনার কোয়েরিটি স্বয়ংক্রিয়ভাবে রিকোয়েস্ট বডিতে (request body) যুক্ত হয়ে যাবে, এবং এরপর আপনি আপনার অ্যাকাউন্টের ডেটার (account data) উপর এটি চালিয়ে কোয়েরিটি পরীক্ষা করতে পারবেন। এই টুলটি সম্পর্কে আরও তথ্যের জন্য এপিআই এক্সপ্লোরার (API Explorer) দেখুন।
কোয়েরি ভ্যালিডেটর
আপনি যখন কোনো কোয়েরি এন্টার বা এডিট করেন , তখন কোয়েরি ভ্যালিডেটর খুলে যায়। আপনার কোয়েরির সিনট্যাক্স যাচাই করতে কোয়েরি ভ্যালিডেটর ব্যবহার করুন। কোয়েরি বিল্ডারের মাধ্যমে সম্পূর্ণভাবে তৈরি করা যেকোনো কোয়েরিতে আগে থেকেই সঠিক সিনট্যাক্স থাকবে, কিন্তু আপনি যে রিসোর্সটি কোয়েরি করছেন সেটির সাথে পরিচিত থাকলে, কোয়েরি ভ্যালিডেটর একটি কোয়েরি ইনপুট করে তার বৈধতা যাচাই করার দ্রুত উপায় দেবে। এই টুলটি সম্পর্কে আরও তথ্যের জন্য কোয়েরি ভ্যালিডেটর দেখুন।