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

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

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

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

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

עמודות

העמודות בממשק המשתמש מקבילות לשדות משאבים, לשדות פלחים ולמדדים ב-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.

דוחות שהוגדרו מראש

אפשר ליצור רשימה של דוחות מוגדרים מראש בממשק המשתמש של Google Ads.

ריכזנו כאן רשימה של הדוחות הבסיסיים שהוגדרו מראש ושמות המשאבים התואמים שלהם ב-GAQL.

דוחות בסיסיים שהוגדרו מראש	שם המשאב ב-GAQL (מציינים בפסוקית FROM)
חשבון	לקוח
Campaign, Campaign details	קמפיין
קבוצת מודעות, פרטי קבוצת מודעות	ad_group
Ad, Final 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

לדוגמה, כדי ליצור את דוח החשבון, אפשר להשתמש בשאילתת 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"