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

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 resource:

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).

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

מידע נוסף

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