מדדי קריטריונים

ב-Google Ads API, כל דוח קריטריונים מיוצג על ידי משאב נפרד. אלא אם יש צורך אחר, משאבי *_view מכילים רק שדה resource_name.

לקוחות Google Ads API צריכים לציין את השדות המתאימים ad_group_criterion או campaign_criterion אם יש צורך באחזור נתונים ספציפיים לקריטריון. כל תצוגה מצטרפת למשאב הקריטריון שתואם לרמת הטירגוט שלה (לדוגמה, keyword_view מצטרף ל-ad_group_criterion, ואילו location_view מצטרף ל-campaign_criterion). כך לקוחות של Google Ads API יכולים לבקש שדות של ad_group_criterion או campaign_criterion ואת המשאב *_view באותה בקשה לשיטה GoogleAdsService.SearchStream.

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

SELECT
  ad_group_criterion.keyword.text,
  ad_group.name,
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS

כדי לאחזר נתוני ביצועים (מדדים) עבור סוג קריטריון ספציפי, מציינים את משאב התצוגה המתאים שלו בסעיף FROM. לדוגמה, אפשר להשתמש ב-keyword_view בפסוקית FROM ובשדות metrics בפסוקית SELECT כדי לאחזר מדדים של מילות מפתח.

אפשר לבחור שדות ממקורות מידע ראשיים עד customer מתצוגת קריטריונים. לדוגמה, כשבוחרים את FROM keyword_view, אפשר לבקש שדות מכל המשאבים הבאים:

• ad_group_criterion
• ad_group
• campaign
• customer

כדי לגלות אילו משאבים אפשר לבקש בדרך הזו עבור משאב מסוים, צריך לעיין בשורה Attributed resources בדף ההפניה שלו. לדוגמה, אפשר למצוא את המשאבים של keyword_view בדף העזר שלו.

מיפוי לממשק המשתמש

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

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

• קמפיינים > קהלים, מילות מפתח ותוכן > מילות מפתח לרשת החיפוש: מחזיר נתונים ששווים לנתונים של keyword_view.
• קמפיינים > קהלים, מילות מפתח ותוכן > קהלים > נתונים דמוגרפיים: הפונקציה מחזירה נתונים ששווים לנתונים של age_range_view ושל gender_view.
• ‫Campaigns > Locations: מחזירה נתונים ששווים לנתונים של location_view.