গুগল বিজ্ঞাপন এমসিপি সার্ভার: ডেভেলপার ইন্টিগ্রেশন গাইড

মডেল কনটেক্সট প্রোটোকল (MCP) হল একটি উন্মুক্ত মান যা লার্জ ল্যাঙ্গুয়েজ মডেল (LLM) কে বাহ্যিক ডেটা এবং অ্যাপ্লিকেশনের সাথে নিরাপদে ইন্টারঅ্যাক্ট করতে সক্ষম করে। Google Ads MCP সার্ভার Google Ads API-এর সাথে একটি মানসম্মত সেতু প্রদান করে, যা AI এজেন্টদের প্রাকৃতিক ভাষা ব্যবহার করে প্রচারণার ডেটা বিশ্লেষণ এবং পুনরুদ্ধার করতে দেয়।

প্রযুক্তিগত সারসংক্ষেপ

এই MCP সার্ভারটি বাস্তবায়নের মাধ্যমে, আপনি Google Ads API প্রমাণীকরণ, রিসোর্স আনা এবং ডেটা পার্সিংয়ের জন্য কাস্টম "গ্লু কোড" লেখার প্রয়োজনীয়তা দূর করেন। সার্ভারটি নির্দিষ্ট সরঞ্জামগুলি প্রকাশ করে যা একজন LLM স্বায়ত্তশাসিতভাবে আবিষ্কার এবং ব্যবহার করতে পারে।

মূল স্পেসিফিকেশন

  • প্রোটোকল: এমসিপি (মডেল কনটেক্সট প্রোটোকল)
  • মোড: কেবল পঠনযোগ্য (বর্তমান প্রকাশ)
  • ভাষা: পাইথন
  • পরিবহন: স্ট্যান্ডার্ড ইনপুট/আউটপুট ( stdio )
  • প্রমাণীকরণ: OAuth 2.0 অথবা পরিষেবা অ্যাকাউন্ট

মিথস্ক্রিয়া লুপ কীভাবে কাজ করে

  1. অনুরোধ: একজন ব্যবহারকারী "এই সপ্তাহে আমার প্রচারণার পারফর্ম্যান্স কেমন?" এর মতো একটি প্রশ্ন জমা দেন।
  2. আবিষ্কার: LLM তার উপলব্ধ সরঞ্জামগুলি পরীক্ষা করে এবং google-ads-mcp অনুসন্ধান ক্ষমতাগুলি সনাক্ত করে।
  3. এক্সিকিউশন: MCP সার্ভার Google Ads API কোয়েরি করার জন্য অন্তর্নিহিত পাইথন লজিক এক্সিকিউট করে।
  4. প্রসঙ্গ ইনজেকশন: কাঠামোগত ফলাফলগুলি LLM এর প্রসঙ্গ উইন্ডোতে ফিরিয়ে আনা হয়।
  5. প্রতিক্রিয়া: LLM তথ্যগুলিকে মানুষের পাঠযোগ্য উত্তরে সংশ্লেষিত করে।

শুরু করুন

Google Ads MCP সার্ভার কনফিগার এবং ব্যবহার করতে এই ধাপগুলি অনুসরণ করুন।

পূর্বশর্ত

কনফিগারেশনের আগে, নিশ্চিত করুন যে আপনার কাছে Google Ads ডেভেলপার কনসোল থেকে নিম্নলিখিত শংসাপত্রগুলি আছে:

  • ডেভেলপার টোকেন: আপনার অনন্য 22-অক্ষরের অ্যাক্সেস স্ট্রিং।
  • প্রজেক্ট আইডি: আপনার গুগল ক্লাউড প্রজেক্ট আইডেন্টিফায়ার।
  • শংসাপত্র ফাইল: একটি অনুমোদিত credentials.json (OAuth 2.0 অথবা পরিষেবা অ্যাকাউন্ট)।

কনফিগারেশন

সার্ভারটিকে একটি MCP-সামঞ্জস্যপূর্ণ হোস্টে একীভূত করতে, আপনার হোস্টের MCP কনফিগারেশন ফাইলে নিম্নলিখিত এন্ট্রি যোগ করুন (যেমন, settings.json )। এই কনফিগারেশনের সঠিক অবস্থান এবং ফাইলের নাম জানতে আপনার হোস্টের ডকুমেন্টেশন দেখুন।

JSON সম্পর্কে

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/credentials.json",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

মূল ক্ষমতা (সরঞ্জাম)

সার্ভারটি অ্যাকাউন্ট আবিষ্কার এবং কর্মক্ষমতা প্রতিবেদনের জন্য ডিজাইন করা সরঞ্জামগুলি প্রকাশ করে:

  • list_accessible_customers : প্রমাণীকৃত ব্যবহারকারীর কাছে অ্যাক্সেসযোগ্য Google Ads গ্রাহক আইডি এবং অ্যাকাউন্ট নামের তালিকা ফেরত পাঠায়।
  • search : প্রচারাভিযানের মেট্রিক্স, বাজেট এবং স্থিতি আনার জন্য Google বিজ্ঞাপন অনুসন্ধান ভাষা (GAQL) অনুরোধগুলি কার্যকর করে।

শুরু করার জন্য নমুনা প্রম্পট

সার্ভার কী করতে পারে জিজ্ঞাসা করুন :

What can the google-ads-mcp server do?

গ্রাহকদের সম্পর্কে জিজ্ঞাসা করুন :

What customers do I have access to?

প্রচারণা সম্পর্কে জিজ্ঞাসা করুন :

How many active campaigns do I have?
How is my campaign performance this week?

সম্প্রদায়ের সম্পদ এবং সহায়তা