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