התקנה ושימוש ב-Google Ads API Developer Assistant

הערה: הכלי הזה הוא פרויקט קוד פתוח ולא מוצר רשמי של Google.

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

לפני שמתחילים, חשוב לוודא שהתנאים הבאים מתקיימים:

1. גישה ל-Google Ads API:

   • קוד מפתח של מפתח ב-Google Ads API.
   • קובץ תצורה של Google Ads שמוגדר עם קוד המפתח, פרטי הכניסה של OAuth 2.0 ומספר הלקוח, ובדרך כלל נמצא בספריית הבית. אפשר לעיין במדריך להגדרת ספריית הלקוח.
   • היכרות עם המושגים והאימות של Google Ads API.

2. תוכנה:

   • ‫Python בגרסה 3.10 ואילך. ‫Python היא שפת ברירת המחדל, ולכן היא צריכה להיות מותקנת ומוגדרת בנתיב.
   • ‫gemini-cli מותקן.
   • ‫jq (מעבד JSON בשורת הפקודה). אם הוא לא מותקן, סקריפט ההתקנה ינסה להתקין אותו.

3. מאגר:

   • עותק מקומי של המאגר google-ads-api-developer-assistant מ-GitHub:

שנתחיל?

1. מנווטים לספריית הפרויקט:

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

2. מריצים את סקריפט ההגדרה: הסקריפט הזה מגדיר את gemini-cli כך שישתמש בקובצי ההקשר ובכלים הנדרשים של העוזר הדיגיטלי GEMINI.md

   ./install.sh
   

   אם אתם משתמשים ב-Windows, מריצים את setup.ps1 סקריפט PowerShell.

3. מפעילים את Gemini CLI:

   gemini
   

4. אינטראקציה עם Assistant: עכשיו אפשר לשאול שאלות או לתת פקודות בשפה טבעית.

תכונות עיקריות

• שאלות ותשובות בשפה טבעית: אפשר לשאול שאלות על תכונות של Google Ads API, על שיטות מומלצות או על משאבים ספציפיים.

  • מהם סוגי הקמפיינים הזמינים?
  • "איך מסננים לפי תאריך ב-GAQL?"
  • "תסביר את ההבדל בין click_view לבין impression_view".

• יצירת קוד: יצירת שאילתות GAQL וקטעי קוד Python שאפשר להריץ.

  • "תציג לי את הקמפיינים עם הכי הרבה המרות ב-30 הימים האחרונים".
  • "קבל את כל השמות של קבוצות המודעות שמופעלות עבור מזהה קמפיין 12345".
  • "איתור מודעות שנפסלו בכל הקמפיינים" הקוד שנוצר נשמר בספרייה saved_code/.

• הרצה ישירה של API: אפשר להריץ סקריפטים של Python שנוצרו לקריאה בלבד ישירות מ-gemini-cli ולראות את התוצאות בפורמט בטרמינל. אחרי ש-Assistant יצור את הקוד, תוצג לכם הנחיה במסך:

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, והסקריפט יופעל בהקשר של Assistant אם שפת ברירת המחדל היא Python,‏ Ruby או PHP. שפות שעברו קומפילציה לא יפעלו בגלל מדיניות אבטחה.

• ייצוא CSV: שמירת תוצאות טבלאיות מקריאות API בקובץ CSV.

  • שומרים את התוצאות בקובץ CSV. הקבצים נשמרים בספרייה saved_csv/.

• עזרה בפתרון בעיות: קבלת עזרה בנוגע להודעות שגיאה או להתנהגות לא צפויה של ה-API.

  • "קיבלתי את השגיאה 'AuthenticationError.OAUTH_TOKEN_INVALID', מה צריך לעשות?"
  • "למה לא מוצגות תוצאות לשאילתה שלי?"

• הקשר נוסף: מוסיפים את בסיס הקוד להקשר.

  • החל מגרסה 2.3.0, משתמשים בדגל context_dir כדי לכלול את קובצי הפרויקט: ./update.sh --context_dir /path/to/your/codebase כך העוזר הדיגיטלי יכול לכלול את הלוגיקה של האפליקציה בחשיבה הרציונלית שלו כשהוא יוצר תשובות.
  • התכונה הזו מאפשרת ל-Assistant ליצור דוגמאות קוד שמורות בשפה שבחרתם, ומספקת תמיכה גם כשספריית לקוח רשמית לא זמינה.
  • לפני שמבקשים מ-Assistant להפיק פלט של קוד, צריך להגיד לה: write saved code examples in <language of your application>

תרחישים לדוגמה

• דיווח:
  • "תביא לי את 5 מילות המפתח המובילות לפי עלות לחודש שעבר עבור לקוח מספר 12345678".
• מבנה החשבון:
  • "תציג את כל שמות הקמפיינים ואת המזהים שלהם".
• פתרון בעיות:
  • "העליתי 100 המרות, אבל רק 78 מופיעות בממשק המשתמש. איך אפשר לנפות באגים באמצעות ה-API?"
• למידה:
  • ‫"/explain what a shared set is"
• יצירת קוד:
  • "תכתוב קוד ליצירת קמפיין למיקסום הביצועים עבור company name".

תמיכה וקהילה

• בעיות ב-GitHub: אפשר לדווח על באגים, להציע תכונות או לבקש עזרה בכרטיסייה Issues במאגר.
• ‫Discord: אפשר להצטרף לדיון בערוץ #ads-api-ai-tools בשרת Discord של קהילת הפרסום והמדידה של Google.
• משוב: נשמח לקבל ממך משוב באמצעות טופס הסקר הזה.

הנחיות להוספת תוכן

נשמח לקבל תרומות! הנחיות זמינות בקובץ CONTRIBUTING.md במאגר GitHub.