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

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

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

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

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

עמודות

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