דוחות בממשק המשתמש של 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,
Campaign details		 campaign
קבוצת מודעות,
פרטי קבוצת מודעות		 ad_group
קבוצות נכסים asset_group
מודעה,
כתובת URL סופית		 ad_group_ad
מוצרים shopping_performance_view,
shopping_product
מילת מפתח בחיפוש keyword_view
מונחי חיפוש search_term_view,
campaign_search_term_view
בתשלום ואורגני
(תבנית של חשיפה בהשוואה למתחרים)*		 paid_organic_search_term_view
דף נחיתה landing_page_view
דף נחיתה מורחב expanded_landing_page_view
תוכן > מיקומי מודעות managed_placement_view
תוכן > המיקומים שבהם הוצגו המודעות group_placement_view
תוכן > איפה הוצגו המודעות > הצגת פרטים detail_placement_view
מיקומי מודעות בקמפיינים למיקסום ביצועים performance_max_placement_view
תוכן > נושאים topic_view
קהלים ad_group_audience_view,
campaign_audience_view
קהלים > דמוגרפיה > גיל age_range_view
קהלים > דמוגרפיה > מגדר gender_view
מיקומים location_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'
הקודם
חלוקה לדפים
הבא
מיפוי פרמטרים של ערך מעקב עם שדות דוח