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

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

אפשר להשתמש בשפת השאילתות של Google Ads כדי לשלוח שאילתות ל-Google Ads API לגבי סוגי המידע הבאים:

• משאבים והמאפיינים, הפלחים והמדדים שקשורים אליהם באמצעות GoogleAdsService ‫Search או 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. 1. מקבלים את האובייקט Campaign מהשדה campaign של כל GoogleAdsRow בתשובה. 1. משנים את הסטטוס של כל קמפיין מPAUSED לENABLED. 1. מתקשרים אל 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. בתיקייה basic operations יש דוגמאות כמו GetCampaigns, GetKeywords ו-SearchForGoogleAdsFields.