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

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

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

בטבלה הבאה מפורטים כמה מהמונחים הנפוצים שמופיעים בממשק המשתמש, והמיפויים שלהם לשפת השאילתות של Google Ads‏ (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 הבא כדי ליצור את דוח החשבון:

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"