דוחות בממשק המשתמש של 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)
חשבון	לקוח
קמפיין, פרטי הקמפיין	קמפיין
קבוצת מודעות, פרטי קבוצת מודעות	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

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