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

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

שירותי החיפוש של Google

אתם יכולים להשתמש בשפת השאילתות של 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:

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