שפת השאילתות של Google Ads

שפת השאילתות של Google Ads יכולה לשלוח שאילתות לגבי Google Ads API

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

GoogleAdsService חיפוש או SearchStream

התוצאה משאילתה של GoogleAdsService היא רשימת מכונות של GoogleAdsRow, וכל GoogleAdsRow מייצג משאב. אם נשלחה בקשה למאפיינים או מדדים, השורה תכלול גם את השדות האלה. אם צריך להוסיף פלחים, התשובה תציג גם שורה נוספת לכל שילוב של משאב-פלח.

מטא-נתונים על שדות ומשאבים זמינים ב-

GoogleAdsFieldService

השירות הזה מספק קטלוג של שדות שאפשר להריץ עליהם שאילתות, עם פירוט לגבי התאימות והסוג שלהם.

התוצאה משאילתה GoogleAdsFieldService היא רשימה של מכונות GoogleAdsField, כשכל GoogleAdsField מכיל פרטים לגבי השדה המבוקש.

שליחת שאילתה לגבי מאפיינים של משאב

לפניכם שאילתה בסיסית לגבי המאפיינים של משאב הקמפיין שממחישה איך מחזירים את המזהה, השם והסטטוס של הקמפיין:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

השאילתה הזו מסודרת לפי מזהה קמפיין. כל GoogleAdsRow שמתקבל ייצג אובייקט campaign שמאוכלס בשדות שנבחרו (כולל ה-resource_name של הקמפיין הנתון).

כדי לברר אילו שדות אחרים זמינים לשאילתות של קמפיינים, תוכלו לעיין במאמרי העזרה של Campaign.

שליחת שאילתה לגבי מדדים

בנוסף למאפיינים שנבחרו למשאב מסוים, אפשר גם לשלוח שאילתה על מדדים קשורים:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id

בשאילתה הזו מסננים רק את הקמפיינים עם הסטטוס PAUSED ושצברו יותר מ-1,000 חשיפות, בסדר יורד לפי מזהה הקמפיין. בכל תוצאה של GoogleAdsRow יופיע שדה metrics שיאוכלס במדדים שנבחרו.

רשימה של מדדים שאפשר להריץ עליהם שאילתות זמינה במסמכי העזרה של Metrics.

שליחת שאילתות לגבי פלחים

בנוסף למאפיינים שנבחרו למשאב מסוים, אפשר גם לשלוח שאילתות לגבי פלחים קשורים:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id

בדומה לשאילתות על מדדים, השאילתה הזו מסוננת רק את הקמפיינים עם הסטטוס PAUSED ושצברו יותר מ-1,000 חשיפות. עם זאת, השאילתה הזו מפלחת את הנתונים לפי תאריך. התוצאה הזו מובילה לכך שכל ערך מסוג GoogleAdsRow שמתקבל מייצג חלק גדול של קמפיין בקמפיין ואת התאריך Segment. חשוב לציין שהפילוח מפצל את המדדים שנבחרו, ומקובצים לפי כל פלח בסעיף SELECT.

כדי לראות רשימה של פלחים שאפשר להריץ עליהם שאילתות, כדאי לעיין במסמכי העזרה של Segments.

שליחת שאילתה לגבי מאפיינים של משאב קשור

בתגובה לשאילתה על משאב מסוים, יכול להיות שתוכלו להצטרף למשאבים קשורים אחרים, אם יש כאלה. המשאבים הקשורים האלה נקראים 'משאבים משויכים'. אפשר לבחור מאפיין בשאילתה ישירות כדי לצרף אליו משאבים משויכים.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

השאילתה הזו לא רק בוחרת מאפייני קמפיין, אלא גם משלבת מאפיינים קשורים מכל קמפיין שנבחר. כל ערך של GoogleAdsRow שמתקבל מייצג אובייקט campaign שמאוכלס במאפייני הקמפיין שנבחרו, וגם במאפיין שיטת הבידינג שנבחר bidding_strategy.name.

כדי לבדוק אילו משאבים משויכים זמינים לשאילתות של קמפיינים, אפשר לעיין במאמרי העזרה של Campaign.

שינוי על סמך תוצאות השאילתה

כששולחים שאילתה למשאב מסוים, אפשר לקבל באופן מיידי את התוצאות המוחזרות כאובייקטים, לשנות אותן ולשלוח אותן חזרה לשיטת השינוי בשירות של אותו משאב. תהליך עבודה לדוגמה:

1. מריצים שאילתה על כל הקמפיינים שכרגע יש להם PAUSED ושיש להם יותר מ-1,000 חשיפות.
2. מקבלים את האובייקט Campaign מהשדה campaign של כל GoogleAdsRow בתשובה.
3. משנים את הסטטוס של כל קמפיין מPAUSED לENABLED.
4. קוראים לפונקציה CampaignService.MutateCampaigns כדי לעדכן את הקמפיינים שעברו שינוי.

מטא-נתונים של שדות

שאילתות שנשלחות אל GoogleAdsFieldService מיועדות לאחזור מטא-נתונים של שדות. אפשר להשתמש במידע הזה כדי להבין איך אפשר להשתמש בשדות יחד בשאילתה. הנתונים זמינים מה-API והם מספקים את המטא-נתונים הדרושים לאימות או לפיתוח של שאילתה, ולכן המפתחים יכולים לעשות זאת באופן פרוגרמטי. הנה שאילתה אופיינית למטא-נתונים:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

אפשר להחליף את <INSERT_RESOURCE_OR_FIELD> בשאילתה הזו במשאב (כמו customer או campaign) או בשדה (כמו campaign.id, metrics.impressions או ad_group.id).

רשימה של שדות שאפשר לשלוח לגביהם שאילתות זמינה במסמכי העזרה של GoogleAdsField.

דוגמאות לקוד

ספריות הלקוח כוללות דוגמאות לשימוש בשפת השאילתות של Google Ads ב-GoogleAdsService. תיקיית הפעולות הבסיסיות כוללת דוגמאות כמו GetCampaigns, GetKeywords ו-SearchForGoogleAdsFields. תיקיית Reporting מכילה את הדוגמה GetKeywordStats.