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

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

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

כלים ומשאבים

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

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

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

בטבלה הבאה מפורטים כמה מהמונחים הנפוצים שמופיעים בממשק המשתמש, והמיפוי שלהם לשפת השאילתות של Google Ads‏ (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, ולכן אפליקציית הלקוח צריכה לעצב את התגובה. בדוגמת הקוד של דוח קמפיין בפורמט CSV מוסבר איך להטמיע פורמט CSV בלקוח.

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

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

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

ריכזנו כאן רשימה של תצוגות נפוצות בממשק המשתמש ושם המשאב התואם ב-GAQL.

תצוגות בממשק המשתמש	שם משאב ב-GAQL (מציינים בפסוקית FROM)
חשבון	customer
קמפיין, פרטי הקמפיין	קמפיין
קבוצת מודעות, פרטי קבוצת מודעות	ad_group
מודעה, כתובת URL סופית	ad_group_ad
מילת מפתח בחיפוש	keyword_view
מונחי חיפוש	search_term_view
‫Paid and organic (תבנית של חשיפה בהשוואה למתחרים)^*	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 הבאה כדי ליצור דוח חשבון מצטבר ב-7 הימים האחרונים (הוסיפו את segments.date לסעיף SELECT אם אתם רוצים מדדים בחלוקה לפי יום):

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 כדי להחריג שורות שהוסרו (או כוללים במפורש ישויות ENABLED ו-PAUSED). לדוגמה:

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