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

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

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