ב-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
בדף העיון שלו.