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

ב-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 באותה בקשה ל-method‏ 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.
• קמפיינים > מיקומים: מחזיר נתונים שווי ערך ל-location_view.