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

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

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

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

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

עמודות

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