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

পূর্বশর্ত

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

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

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

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

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

শুরু করুন

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

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

    (দ্রষ্টব্য: আপনার যদি অ্যান্টিগ্র্যাভিটি শেল ইন্টিগ্রেশন সক্রিয় করা থাকে, তাহলে এই ডিরেক্টরিতে প্রবেশ করলে অ্যাসিস্ট্যান্ট সেশনটি স্বয়ংক্রিয়ভাবে চালু হয়ে যাবে)।

  2. ইনস্টল স্ক্রিপ্টটি চালান: এই স্ক্রিপ্টটি ডেভেলপমেন্ট এনভায়রনমেন্ট চালু করে এবং প্রয়োজনীয় গুগল অ্যাডস ক্লায়েন্ট লাইব্রেরিগুলো ক্লোন করে (পাইথন ডিফল্টভাবে ইনস্টল করা থাকে)।

    ./install.sh

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

  3. ক্রেডেনশিয়াল কনফিগার করুন: নিশ্চিত করুন যে আপনার google-ads.yaml (বা এর সমতুল্য ভাষা) ফাইলটি আপনার হোম ডিরেক্টরিতে রাখা আছে।

  4. অ্যাসিস্ট্যান্টের সাথে যোগাযোগ করুন: সেশনটি সক্রিয় হয়ে গেলে, আপনি সরাসরি আপনার টার্মিনালে স্বাভাবিক ভাষা ব্যবহার করে অ্যাসিস্ট্যান্টের সাথে যোগাযোগ করতে পারবেন।

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

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

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

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

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

  • সরাসরি এপিআই এক্সিকিউশন: তৈরি করা রিড-অনলি পাইথন স্ক্রিপ্টগুলো সরাসরি একটি সুরক্ষিত ভার্চুয়াল এনভায়রনমেন্টের ( .venv ) মধ্যে চালান এবং আপনার টার্মিনালে ফরম্যাট করা ফলাফল টেবিল আকারে দেখুন।

    • অ্যাসিস্ট্যান্টকে শুধু বলুন: "কোডটি চালান" অথবা "স্ক্রিপ্টটি চালান" ।
    • নিরাপত্তার স্বার্থে, পরিবর্তনমূলক অপারেশনগুলো (তৈরি, আপডেট, ডিলিট) তৈরি করা হলেও কখনো কার্যকর করা হয় না।

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

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

  • উন্নত ডায়াগনস্টিকস ও ট্রাবলশুটিং: এরর মেসেজ, অপ্রত্যাশিত API আচরণ, বা অফলাইন কনভার্সন সংক্রান্ত সমস্যায় সাহায্য নিন।

    • আমার অনুসন্ধানের কোনো ফলাফল দেখতে পাচ্ছি না কেন?
    • "গ্রাহক 123-456-7890-এর জন্য আমার কনভার্সনগুলোর সমস্যা সমাধান করুন।" ( saved/data/ ফোল্ডারে একটি বিস্তারিত ডায়াগনস্টিক রিপোর্ট তৈরি করে)।

  • অতিরিক্ত প্রেক্ষাপট: প্রাসঙ্গিকতার জন্য আপনার নিজস্ব কোডবেস বা কাস্টম লাইব্রেরি যোগ করুন।

    • আপনার প্রোজেক্ট ফাইলগুলো রেজিস্টার করতে --context_path অপশনসহ update.sh স্ক্রিপ্টটি ব্যবহার করুন: none ./update.sh --context_path /path/to/your/codebase
    • এর ফলে অ্যাসিস্ট্যান্ট প্রতিক্রিয়া তৈরি করার সময় বা আপনার পছন্দের ভাষায় কোড জেনারেট করার সময় তার যুক্তিতে আপনার অ্যাপ্লিকেশন লজিক অন্তর্ভুক্ত করতে পারে।

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

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

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

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

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

পূর্ববর্তী
গুগল অ্যাডস এপিআই ডেভেলপার অ্যাসিস্ট্যান্ট বলতে কী বোঝায়?