שפת השאילתות של 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 OR FIELD במשאב (למשל customer או campaign) או בשדה (למשל campaign.id,‏ metrics.impressions או ad_group.id).

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

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

מידע נוסף

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

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