דוחות בממשק המשתמש

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

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

בטבלה הבאה מופיע סיכום של חלק מהמונחים הנפוצים בשימוש בממשק המשתמש והמיפוי שלהם לשפת השאילתות של Google Ads (GAQL).

UI	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
מודעה, כתובת URL סופית	ad_group_ad
מילת מפתח בחיפוש	keyword_view
מונחי חיפוש	search_term_view
בתשלום ואורגני	paid_organic_search_term_view
Landing page (דף הנחיתה)	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"