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

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

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

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

  2. תוכנה:

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

  3. מאגר:

שנתחיל?

  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', מה צריך לעשות?"
    • "למה לא מוצגות תוצאות לשאילתה שלי?"

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

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

תמיכה וקהילה

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

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