דוחות בממשק המשתמש של Google Ads

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

במדריך הזה מוסבר על מושגים נפוצים שקשורים לדיווח ועל מוסכמות מתן שמות בממשק המשתמש של Google Ads, ואיך הם קשורים לדוחות שאפשר ליצור באמצעות Google Ads Query Language‏ (GAQL) ו-Google Ads API. אתם יכולים גם לפעול לפי ההנחיות בממשק המשתמש כדי ליצור את הדוח שהכי מתאים לדרישות שלכם.

כלים ומשאבים

דוגמאות מפורטות יותר ועזרה אוטומטית במיפוי מסכי ממשק משתמש ל-API זמינות במקורות המידע הבאים:

• ספר מתכוני שאילתות: אוסף של שאילתות GAQL שמשכפלות את הנתונים שמוצגים במסכים נפוצים רבים בממשק המשתמש של Google Ads.
• ‫Google Ads API Reporting Extension: תוסף ל-Chrome שעוזר לכם לזהות משאבי API ושמות שדות ישירות בממשק המשתמש של Google Ads.

מונחים נפוצים בממשק המשתמש

בטבלה הבאה מפורטים כמה מהמונחים הנפוצים שמופיעים בממשק המשתמש, והמיפוי שלהם ל-Google Ads Query Language (GAQL).

ממשק משתמש	GAQL
עמודות	כל משאב, שדה פלח או מדד בפסוקית SELECT של שאילתת GAQL.
טווח תאריכים	טווחי תאריכים ממופים למשפט WHERE שבו מתבצע סינון לפי segments.date.
מסננים	תנאי אחד או יותר בסעיף WHERE.
שדות של פלחים	כדי להחיל פילוח, צריך לכלול שדות של פלחים בשאילתת GAQL.
חלוקה לעמודים	חלוקה לדפים מפצלת את קבוצת התוצאות של השאילתה למספר דפים.

עמודות

העמודות בממשק המשתמש שוות לשימוש בפסקה SELECT עבור שדות של משאבים, שדות של פלחים או מדדים ב-GAQL.

מידע על העמודות בטבלת הנתונים הסטטיסטיים

טווחי תאריכים

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

ב-GAQL, אפשר להשתמש באותו אמצעי בקרה על ידי סינון לפי segments.date במשפט WHERE של שאילתת GAQL.

מסננים

מסננים בממשק המשתמש שווים לתנאי אחד או יותר בתנאי WHERE של GAQL.

איך מסננים את התצוגה של נתוני הביצועים

פילוח

כדי לראות נתונים סטטיסטיים מפורטים יותר, צריך לפלח את הנתונים. לדוגמה, נניח שאתם רוצים לראות את מספר החשיפות שספציפי לרשת החיפוש של Google בנפרד מרשת המדיה של Google. במקרה כזה, צריך לפלח את הדוח לפי רשת. במאמר בנושא פילוח מוסבר איך לכלול שדות פילוח במשפט SELECT.

חלוקה לדפים

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

אפשר לעבור בין דפים של תוצאות כשמאחזרים דוחות באמצעות GoogleAdsService.Search עד next_page_token. כדי לאחזר את כל מערך התוצאות בלי חלוקה לדפים, משתמשים ב-GoogleAdsService.SearchStream.

סדר התוצאות

בממשק המשתמש, אפשר למיין את התוצאות על ידי בחירת עמודה.

ב-GAQL, אפשר להשתמש בפסוקית ORDER BY ובפסוקית LIMIT כדי להגדיר את הסדר של תוצאות השאילתה.

פורמטים להורדה

בממשק המשתמש, אפשר להוריד דוחות בפורמטים שונים, כמו CSV,‏ TSV או XML.

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

תזמון ושליחה של דוחות באימייל

אפשר לתזמן דוח ולשלוח אותו באימייל דרך ממשק המשתמש, אבל התכונות האלה לא נתמכות ב-API.

מיפוי תצוגות בממשק המשתמש למשאבי API

בהמשך מופיעה רשימה של תצוגות נפוצות בממשק המשתמש ושם המשאב התואם ב-GAQL.

תצוגות בממשק המשתמש	שם משאב ב-GAQL (מציינים בסעיף FROM)
חשבון	לקוח
Campaign, Campaign details	קמפיין
קבוצת מודעות, פרטי קבוצת מודעות	ad_group
מודעה, כתובת URL סופית	ad_group_ad
מילת מפתח בחיפוש	keyword_view
מונחי חיפוש	search_term_view
ערוצים אורגניים וערוצים בתשלום (תבנית חשיפה בהשוואה למתחרים)^*	paid_organic_search_term_view
דף נחיתה	landing_page_view
דף נחיתה מורחב	expanded_landing_page_view
תוכן > מיקומי מודעות	managed_placement_view
תוכן > המיקומים שבהם הוצגו המודעות	group_placement_view
תוכן > המיקומים שבהם הוצגו המודעות > הצגת פרטים	detail_placement_view
קהלים > דמוגרפיה > גיל	age_range_view
קהלים > דמוגרפיה > מגדר	gender_view
מיקומים	location_view
תוכן > נושאים	topic_view
מיקומים > דוח גיאוגרפי	geographic_view

^* כדי ליצור את הדוח חיפוש בתשלום וחיפוש אורגני, צריך לקשר חשבון Google Search Console לחשבון Google Ads ברמת הלקוח.

לדוגמה, אפשר להשתמש ב-GAQL הבאה כדי ליצור את דוח החשבון:

SELECT
  customer.descriptive_name,
  customer.id,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  metrics.absolute_top_impression_percentage,
  metrics.top_impression_percentage,
  metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS

הבדלים נפוצים

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

כדי לשכפל תצוגת ברירת מחדל בממשק המשתמש, צריך להוסיף מסנן, בדרך כלל באמצעות שדה status, כדי להחריג שורות שהוסרו. לדוגמה:

SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'