שפת השאילתות של Search Ads 360

שפת השאילתות של Search Ads 360 מאפשרת ליצור שאילתות חיפוש כדי לאחזר נתוני דיווח ומטא-נתונים של משאבים באמצעות Search Ads 360 Reporting API.

חיפוש שירותים

אתם יכולים להשתמש בשפת השאילתות של Search Ads 360 כדי לשלוח שאילתות ל-API באמצעות:

SearchAds360Service

משתמשים בשירות הזה כדי להריץ שאילתות על משאבים ועל המאפיינים, הפלחים והמדדים הקשורים אליהם. יש שתי שיטות, Search וSearchStream.

SearchAds360Service שאילתות מחזירות רשימה של SearchAds360Row מופעים:

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

למידע נוסף, ראו יצירת דוחות חיפוש.

SearchAds360FieldService

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

הפונקציה SearchAds360FieldService מחזירה רשימה של מכונות SearchAds360Field:

• כל שדה מכיל פרטים לגבי השדה המבוקש.

למידע נוסף, ראה אחזור מטא נתונים של משאבים.

שאילתות בסיסיות לדוגמה

בקטעים הבאים מתוארות דוגמאות בסיסיות לשאילתות, שתוכלו להתאים כדי ליצור שאילתות משלכם.

שאילתה לגבי תכונות של משאב

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

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

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

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

שאילתת מדדים

זוהי שאילתה בסיסית לגבי מדדים שקשורים למאפיינים של המשאב 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 חשיפות.
• לכל SearchAds360Row שמוחזר יש שדה metrics שמאוכלס במדדים שנבחרו.
• סדר השאילתות לפי מזהה הקמפיין.

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

שאילתת פלחים

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

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 חשיפות.
• הוא מפלח את הנתונים לפי תאריך.
• כתוצאה מהפילוח, כל SearchAds360Row מייצג צירוף של קמפיין ושל טווח התאריכים.
• סדר השאילתות לפי מזהה הקמפיין.

ב-segments יש רשימה של הפלחים שאפשר להשתמש בהם בשאילתות, ובפילוח למידע נוסף על פילוח הדוחות.

שאילתה לגבי תכונות של משאב קשור

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

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

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

ראו campaign אילו משאבים משויכים זמינים לשאילתות של קמפיינים.

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

אפשר להשתמש ב-SearchAds360FieldService כדי לאחזר את המטא-נתונים של השדות.

זוהי שאילתה בסיסית למטא-נתונים של שדה:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD

• מחליפים את Resource או Field במשאב (כמו customer או campaign) או בשדה (כמו campaign.id, metrics.impressions או ad_group.id).

הערה: אין סעיף FROM בשאילתה למטא-נתונים של שדות.

מידע נוסף על אחזור מטא-נתונים של השדות זמין במאמר אחזור מטא-נתונים של משאבים.

מידע נוסף

מידע נוסף על בניית שאילתות ב-Search Ads 360 Reporting API:

• מבנה וסעיפים של שאילתות
• טווחי תאריכים
• אפס מדדים
• שאילתות לדוגמה
• דקדוק של שאילתות