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

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

לקוחות Google Ads API צריכים לציין את השדות התואמים ad_group_criterion או 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

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

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

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

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

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