Google Ads API ডেভেলপার অ্যাসিস্ট্যান্ট ইনস্টল করুন এবং ব্যবহার করুন

পূর্বশর্ত

শুরু করার আগে, নিশ্চিত হয়ে নিন আপনার কাছে নিম্নলিখিত জিনিসগুলো আছে:

  1. গুগল অ্যাডস এপিআই অ্যাক্সেস:

  2. সফটওয়্যার:

    • পাইথন ৩.১০ বা তার নতুন সংস্করণ। পাইথন হলো ডিফল্ট ভাষা, তাই এটি অবশ্যই ইনস্টল করা থাকতে হবে এবং আপনার পাথে (path) অন্তর্ভুক্ত থাকতে হবে।
    • gemini-cli ইনস্টল করা হয়েছে।
    • jq (কমান্ড-লাইন JSON প্রসেসর)। এটি অনুপস্থিত থাকলে ইনস্টলেশন স্ক্রিপ্টটি এটি ইনস্টল করার চেষ্টা করবে।

  3. সংগ্রহস্থল:

শুরু করুন

  1. প্রজেক্ট ডিরেক্টরিতে যান:

    cd <full path>/google-ads-api-developer-assistant

  2. সেটআপ স্ক্রিপ্টটি চালান: এই স্ক্রিপ্টটি অ্যাসিস্ট্যান্টের GEMINI.md কনটেক্সট ফাইল এবং প্রয়োজনীয় টুলগুলো ব্যবহার করার জন্য gemini-cli-কে কনফিগার করে।

    ./install.sh

    আপনি যদি উইন্ডোজ ব্যবহার করেন, তাহলে setup.ps1 পাওয়ারশেল স্ক্রিপ্টটি চালান।

  3. gemini-cli শুরু করুন:

    gemini

  4. অ্যাসিস্ট্যান্টের সাথে যোগাযোগ করুন: আপনি এখন স্বাভাবিক ভাষায় প্রশ্ন করতে বা নির্দেশ দিতে পারেন।

মূল বৈশিষ্ট্য

  • স্বাভাবিক ভাষায় প্রশ্নোত্তর: গুগল অ্যাডস এপিআই-এর ফিচার, সেরা অনুশীলন বা নির্দিষ্ট রিসোর্স সম্পর্কে প্রশ্ন করুন।

    • কী কী ধরনের ক্যাম্পেইন পাওয়া যায়?
    • GAQL-এ তারিখ অনুযায়ী কীভাবে ফিল্টার করব?
    • click_view এবং impression_view এর মধ্যে পার্থক্য ব্যাখ্যা করুন।

  • কোড জেনারেশন: GAQL কোয়েরি এবং এক্সিকিউটেবল পাইথন কোড স্নিপেট তৈরি করুন।

    • গত ৩০ দিনে সর্বাধিক কনভার্সন হওয়া ক্যাম্পেইনগুলো দেখান।
    • ক্যাম্পেইন আইডি ১২৩৪৫-এর জন্য সক্রিয় সমস্ত অ্যাড গ্রুপের নামগুলো খুঁজুন।
    • সমস্ত ক্যাম্পেইন জুড়ে অননুমোদিত বিজ্ঞাপনগুলি খুঁজুন। তৈরি হওয়া কোড saved_code/ ডিরেক্টরিতে সংরক্ষিত হয়।

  • সরাসরি এপিআই এক্সিকিউশন: gemini-cli থেকে সরাসরি তৈরি করা রিড-অনলি পাইথন স্ক্রিপ্টগুলো চালান এবং আপনার টার্মিনালে ফরম্যাট করা ফলাফল দেখুন। অ্যাসিস্ট্যান্ট কোডটি তৈরি করার পর, আপনি স্ক্রিনে একটি প্রম্পট পাবেন: 

To run this script, you will need to replace YOUR_CUSTOMER_ID with your actual
Google Ads customer ID and execute the following command in
your shell: <command>

আপনার ডিফল্ট ভাষা পাইথন, রুবি বা পিএইচপি হলে, run চাপুন এবং স্ক্রিপ্টটি অ্যাসিস্ট্যান্ট কনটেক্সটে এক্সিকিউট হবে। নিরাপত্তা নীতির কারণে কম্পাইল করা ভাষাগুলো রান করবে না।

  • CSV এক্সপোর্ট: API কল থেকে প্রাপ্ত সারণিবদ্ধ ফলাফল একটি CSV ফাইলে সংরক্ষণ করুন।

    • ফলাফলগুলো একটি CSV ফাইলে সংরক্ষণ করুন। ফাইলগুলো saved_csv/ ডিরেক্টরিতে সংরক্ষিত হয়।

  • সমস্যা সমাধানে সহায়তা: ত্রুটির বার্তা বা অপ্রত্যাশিত API আচরণের ক্ষেত্রে সাহায্য নিন।

    • আমি 'AuthenticationError.OAUTH_TOKEN_INVALID' ত্রুটিটি পেয়েছি, আমার কী করা উচিত?
    • আমার অনুসন্ধানের কোনো ফলাফল দেখতে পাচ্ছি না কেন?

ব্যবহারের উদাহরণ

  • প্রতিবেদন:
    • গ্রাহক ১২৩৪৫৬৭৮-এর জন্য গত মাসের খরচ অনুযায়ী শীর্ষ ৫টি কীওয়ার্ড খুঁজে দিন।
  • অ্যাকাউন্টের কাঠামো:
    • সমস্ত প্রচারণার নাম এবং তাদের আইডি তালিকাভুক্ত করুন।
  • সমস্যা সমাধান:
    • আমি ১০০টি কনভার্সন আপলোড করেছি, কিন্তু UI-তে মাত্র ৭৮টি দেখা যাচ্ছে। আমি API ব্যবহার করে কীভাবে এটি ডিবাগ করতে পারি?
  • শিক্ষা:
    • শেয়ার্ড সেট কী তা ব্যাখ্যা করুন।
  • কোড তৈরি:
    • " company name "-এর জন্য একটি পারফরম্যান্স ম্যাক্স ক্যাম্পেইন তৈরি করতে কোড লিখুন।

সম্প্রদায় এবং সমর্থন

অবদান নির্দেশিকা

অবদান স্বাগত! নির্দেশিকার জন্য গিটহাব রিপোজিটরিতে থাকা CONTRIBUTING.md ফাইলটি দেখুন।