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

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

מידע נוסף

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

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