שפת השאילתות של 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).

נקודה חשובה: שימו לב שאין סעיף FROM בשאילתה הזו.

במסמכי התיעוד של GoogleAdsField תוכלו למצוא רשימת שדות שניתן להריץ עליהם שאילתות.

דוגמאות לקוד

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