שרת ה-MCP של Google Ads: מדריך שילוב למפתחים

‫Model Context Protocol ‏ (MCP) הוא תקן פתוח שמאפשר למודלים גדולים של שפה (LLM) ליצור אינטראקציה מאובטחת עם נתונים ואפליקציות חיצוניים. שרת ה-MCP של Google Ads מספק גשר סטנדרטי ל-Google Ads API, ומאפשר לסוכני AI לנתח ולאחזר נתוני קמפיין באמצעות שפה טבעית.

סקירה כללית טכנית

הטמעה של שרת MCP מבטלת את הצורך בכתיבת קוד מותאם אישית לחיבור בין מערכות שונות לצורך אימות של Google Ads API, אחזור משאבים וניתוח נתונים. השרת חושף כלים ספציפיים שמודל LLM יכול לגלות ולהפעיל באופן אוטונומי.

מפרטים מרכזיים

  • פרוטוקול: MCP (Model Context Protocol)
  • מצב: קריאה בלבד (הגרסה הנוכחית)
  • שפה: Python
  • העברה: קלט/פלט רגיל (stdio)
  • אימות: OAuth 2.0 או חשבון שירות

איך פועל לולאת האינטראקציה

  1. בקשה: משתמש שולח שאילתה כמו "מהם נתוני הביצועים של הקמפיין שלי השבוע?".
  2. גילוי: מודל ה-LLM בודק את הכלים הזמינים לו ומזהה את יכולות החיפוש של google-ads-mcp.
  3. ביצוע: שרת ה-MCP מפעיל את הלוגיקה הבסיסית של Python כדי לשלוח שאילתה ל-Google Ads API.
  4. הזרקת הקשר: תוצאות מובנות מוחזרות לחלון ההקשר של מודל ה-LLM.
  5. תשובה: מודל ה-LLM מסנתז את הנתונים לתשובה שקריאה לאנשים.

שנתחיל?

כדי להגדיר את השרת של פלטפורמת ניהול ההסכמה של Google Ads ולהשתמש בו, צריך לפעול לפי השלבים הבאים.

דרישות מוקדמות

לפני ההגדרה, צריך לוודא שיש לכם את פרטי הכניסה הבאים ממסוף המפתחים של Google Ads:

  • קוד מפתח: מחרוזת הגישה הייחודית שלכם, באורך 22 תווים.
  • מזהה הפרויקט: מזהה הפרויקט שלכם ב-Google Cloud.
  • קובץ פרטי כניסה: 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 Ads Query Language‏ (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?

משאבים ותמיכה מהקהילה