דוחות

סקירה כללית

בדפים האלה מפורטים המשאבים שאפשר לשלוח לגביהם שאילתות ב-API באמצעות SearchAds360Service.SearchStream או SearchAds360Service.Search. שמות המשאבים מקושרים לדף משלהם. בכל דף מוצגות הרשימות הבאות:

  • רכיבים (משאבים, פלחים או מדדים) שאפשר להשתמש בהם באותו סעיף SELECT עם המשאב
  • משאבים משויכים שהשדות שלהם לא יחלקו את המדדים לפלחים, כשהם נכללים באותם סעיפי SELECT ו-WHERE של שדות המשאבים האלה

אחרי הרשימות האלה מוצגות טבלאות שמכילות שמות של שדות משאבים, פלחים ומדדים שאפשר לכלול בשאילתת חיפוש, כשהמשאב הזה מצוין בסעיף FROM. כל שם מקושר לטבלה שמכילה את המטא-נתונים שלו:

  • category
  • data type
  • type URL
  • filterable
  • selectable
  • sortable
  • repeated
ניתן לסינון
השורה הזו מציינת אם אפשר להשתמש בשדה בתנאים של הסעיף WHERE בשאילתה.
ניתן לבחירה
השורה הזו מציינת אם אפשר לציין את השדה בסעיף SELECT של השאילתה.
Sortable
השורה הזו מציינת אם אפשר למיין את השדה ולהשתמש בו בסעיף ORDER BY של השאילתה.
שדה
השורה הזו מציינת אם השדה חוזר, ואז צריך להתייחס אליו כרשימה.

רשימה של כל המשאבים

סוגי המשאבים
accessible_bidding_strategy מייצג תצוגה של שיטות הבידינג שבבעלות הלקוח ומשותפות איתו. בניגוד ל-BiddingStrategy, המשאב הזה כולל שיטות בידינג שנמצאות בבעלות של מנהלי הלקוח ומשותפות עם הלקוח הזה – בנוסף לשיטות בידינג שנמצאות בבעלות של הלקוח הזה. המשאב הזה לא מספק מדדים וחושף רק קבוצת משנה מוגבלת של מאפייני BiddingStrategy.
ad_group קבוצת מודעות.
ad_group_ad מודעה בקבוצת מודעות.
ad_group_ad_effective_label קשר בין מודעה בקבוצת מודעות לבין תווית אפקטיבית. תווית אפקטיבית היא תווית שעוברת בירושה או מוקצית ישירות למודעה הזו בקבוצת המודעות.
ad_group_ad_label קשר בין מודעה בקבוצת מודעות לבין תווית.
ad_group_asset קישור בין קבוצת מודעות לנכס.
ad_group_asset_set ‫AdGroupAssetSet הוא הקישור בין קבוצת מודעות לקבוצת נכסים. כשיוצרים AdGroupAssetSet, מקשרים קבוצת נכסים לקבוצת מודעות.
ad_group_audience_view תצוגת קהל של קבוצת מודעות. כולל נתוני ביצועים מתחומי עניין ומרשימות רימרקטינג של מודעות ברשת המדיה וברשת YouTube, ומרשימות רימרקטינג עבור מודעות לרשת החיפוש (RLSA), שנצברו ברמת הקהל.
ad_group_bid_modifier מייצג התאמת הצעת מחיר לקבוצת מודעות.
ad_group_criterion קריטריון של קבוצת מודעות. הדוח ad_group_criterion מחזיר רק קריטריונים שנוספו באופן מפורש לקבוצת המודעות.
ad_group_criterion_effective_label קשר בין קריטריון של קבוצת מודעות לבין תווית אפקטיבית. תווית אפקטיבית היא תווית שעוברת בירושה או מוקצית ישירות לקריטריון הזה של קבוצת המודעות.
ad_group_criterion_label קשר בין קריטריון של קבוצת מודעות לבין תווית.
ad_group_effective_label קשר בין קבוצת מודעות לבין תווית אפקטיבית. תווית אפקטיבית היא תווית שעוברת בירושה או מוקצית ישירות לקבוצת המודעות הזו.
ad_group_label קשר בין קבוצת מודעות לתווית.
age_range_view תצוגה של טווח גילאים. מייצג את התצוגה של מדדי הביצועים של הלקוח (כמו חשיפות וקליקים) שנצברו לפי טווח גילאים. כל הנתונים הסטטיסטיים נצברים ברמת קבוצת המודעות. הערה: אפשר לפלח מדדים לפי טווח גילאים באמצעות age_range_view או לפי מגדר באמצעות gender_view, אבל Search Ads 360 API לא תומך בפילוח מדדים לפי טווח גילאים ומגדר בו-זמנית בשאילתה אחת. ב-Search Ads 360 API אין תמיכה בניתוח הביצועים בשני המאפיינים ביחד.
נכס נכס הוא חלק ממודעה שאפשר לשתף בין כמה מודעות. הוא יכול להיות תמונה (ImageAsset), סרטון (YoutubeVideoAsset) וכו'. נכסים הם לא ניתנים לשינוי ואי אפשר להסיר אותם. כדי להפסיק את ההצגה של נכס, צריך להסיר אותו מהישות שמשתמשת בו.
asset_group קבוצת נכסים. האובייקט AssetGroupAsset משמש לקישור של נכס לקבוצת הנכסים. האובייקט AssetGroupSignal משמש לשיוך של אות לקבוצת נכסים.
asset_group_asset ‫AssetGroupAsset הוא הקישור בין נכס לבין קבוצת נכסים. הוספה של AssetGroupAsset מקשרת נכס לקבוצת נכסים.
asset_group_listing_group_filter ‫AssetGroupListingGroupFilter מייצג צומת בעץ של מסנני קבוצות של כרטיסי מוצר בקבוצת נכסים.
asset_group_signal ‫AssetGroupSignal מייצג אות בקבוצת נכסים. האותות האלה מציינים לקמפיין למיקסום הביצועים מיהם המשתמשים שהסיכוי שישלימו המרות הוא הגבוה ביותר. כשבוחרים אותות של קהלים בקמפיינים למיקסום הביצועים, המערכת מתבססת עליהם כדי לחפש אנשים חדשים עם כוונת רכישה דומה או גבוהה יותר, וכך להשיג יותר המרות בחיפוש, ברשת המדיה, בווידאו ועוד.
asset_group_top_combination_view תצוגה של השימוש בשילובים המובילים של נכסים בקבוצת נכסים.
asset_set קבוצת נכסים שמייצגת אוסף של נכסים. משתמשים ב-AssetSetAsset כדי לקשר נכס לקבוצת הנכסים.
asset_set_asset AssetSetAsset הוא הקישור בין נכס לבין קבוצת נכסים. הוספה של AssetSetAsset מקשרת נכס לקבוצת נכסים.
קהל קהל הוא אפשרות יעילה לטירגוט שמאפשרת ליצור חפיפה בין מאפייני פילוח שונים, כמו מידע דמוגרפי מפורט וקהלים עם תחום עניין משותף, וכך ליצור קהלים שמייצגים קטעים של פילוחי היעד.
bidding_strategy שיטת בידינג.
campaign קמפיין.
campaign_asset קישור בין קמפיין לנכס.
campaign_asset_set ‫CampaignAssetSet הוא הקישור בין קמפיין לבין קבוצת נכסים. הוספה של CampaignAssetSet מקשרת קבוצת נכסים לקמפיין.
campaign_audience_view תצוגה של קהל בקמפיין. כולל נתוני ביצועים מתחומי עניין ומרשימות רימרקטינג של מודעות ברשת המדיה וברשת YouTube, ורשימות רימרקטינג עבור מודעות לרשת החיפוש (RLSA), שנצברו לפי קמפיין וקריטריון קהל. התצוגה הזו כוללת רק קהלים שמצורפים ברמת הקמפיין.
campaign_budget תקציב הקמפיין.
campaign_criterion קריטריון של קמפיין.
campaign_effective_label מייצג קשר בין קמפיין לבין תווית אפקטיבית. תווית אפקטיבית היא תווית שעברה בירושה או הוקצתה ישירות לקמפיין הזה.
campaign_label מייצג קשר בין קמפיין לתווית.
cart_data_sales_view תצוגת מכירות של נתוני עגלות הקניות. מספק מידע על המוצרים שנרכשו אם הוטמעו המרות עם נתונים מעגלות קניות (CwCD). מדדי ביצועים כמו הכנסה, רווח ברוטו, מדדי לידים/מכירת מוצר או שירות לא קשור (cross-sell) וכו' ומאפייני Merchant Center כמו מותג, קטגוריה וכו' זמינים למוצרים שמוגדרים בפיד מלאי ונמכרים כתוצאה ממודעות Google. לגבי רכישות שמשויכות לקליקים על מודעות שופינג, אפשר לראות את המאפיינים של המוצרים שנמכרו ושל המוצרים שהקליקו עליהם ביחד.
המרה המרה.
conversion_action פעולת המרה.
conversion_custom_variable משתנה המרה מותאם אישית. מידע נוסף זמין במאמר "מידע על מדדים ומאפיינים של Floodlight בממשק החדש של Search Ads 360" בכתובת https://support.google.com/sa360/answer/13567857
customer לקוח.
customer_asset קישור בין לקוח לנכס.
customer_asset_set CustomerAssetSet הוא הקישור בין לקוח לבין קבוצת נכסים. הוספה של CustomerAssetSet מקשרת בין קבוצת נכסים לבין לקוח.
customer_client קישור בין הלקוח הנתון לבין לקוח משלם ולקוח קצה. השדה CustomerClients קיים רק בחשבונות ניהול. הוא כולל את כל הלקוחות המשלמים ולקוחות הקצה הישירים והעקיפים, וגם את חשבון הניהול עצמו.
customer_manager_link מייצג את הקשר בין הלקוח למנהל.
dynamic_search_ads_search_term_view תצוגה של מונחי חיפוש במודעות דינמיות לרשת החיפוש.
gender_view משאב של תצוגת מגדר. מייצג את התצוגה של מדדי לבדיקת ביצועים של הלקוח, מקובצים לפי מגדר. כל הנתונים הסטטיסטיים נצברים ברמת קבוצת המודעות. הערה: אפשר לפלח מדדים לפי טווח גילאים באמצעות age_range_view או לפי מגדר באמצעות gender_view, אבל Search Ads 360 API לא תומך בפילוח מדדים לפי טווח גילאים ומגדר בו-זמנית בשאילתה אחת. ב-Search Ads 360 API אין תמיכה בניתוח הביצועים בשני המאפיינים ביחד.
geo_target_constant קבוע של מיקום גיאוגרפי לטירגוט.
keyword_view תצוגה של מילת מפתח.
label תווית.
language_constant שפה.
location_view תצוגת מיקום מסכמת את הביצועים של קמפיינים לפי קריטריון מיקום.
product_bidding_category_constant קטגוריית בידינג על מוצר.
product_group_view תצוגה של קבוצת מוצרים.
shopping_performance_view תצוגת ביצועים של שופינג. מספק נתונים סטטיסטיים של קמפיינים של שופינג וקמפיינים למיקסום הביצועים, שנאספו בכמה רמות של מאפייני מוצרים. ערכי מאפייני המוצרים מ-Merchant Center, כמו מותג, קטגוריה, מאפיינים מותאמים אישית, מצב המוצר וסוג המוצר, ישקפו את מצב המאפיין בתאריך ובשעה שבהם האירוע המתאים תועד. יכול להיות שמספר החשיפות והקליקים שמוצגים בנתונים הסטטיסטיים של shopping_performance_view יהיה שונה מהמספרים שמוצגים בדוחות של הקמפיין. ב-shopping_performance_view מוצגים חשיפות וקליקים על מוצרים שמופיעים במודעות, ובדוחות של הקמפיינים מוצגים חשיפות וקליקים על המודעות עצמן. בהתאם לפורמט, מודעה יכולה להציג בין אפס לכמה מוצרים, כך שהמספרים לא תמיד תואמים. בממשק המשתמש של Search Ads 360, אפשר לשלוח שאילתות לגבי חשיפות וקליקים של מוצרים שמופיעים במודעות. כדי לעשות את זה, בוחרים עמודה מתוך "מאפייני מוצר" בכלי הדוחות. לדוגמה, בחירה בעמודה "מותג" שקולה לבחירה באפשרות segments.product_brand.
user_list רשימת משתמשים. זו רשימה של משתמשים שלקוח יכול לטרגט. המפתח הייחודי של רשימת משתמשים מורכב מהשדות הבאים: id. חשוב לשים לב שגם השדה name חייב להיות ייחודי לרשימות משתמשים שבבעלות לקוח מסוים, חוץ ממקרים מסוימים שבהם השדה access_reason מוגדר כ-SHARED. הפרה של אילוץ השם הייחודי גורמת לשגיאה: UserListError.INVALID_NAME.
user_location_view תצוגה של מיקומי משתמשים. תצוגת מיקום המשתמש כוללת את כל המדדים המצטברים ברמת המדינה, שורה אחת לכל מדינה. הוא מדווח על מדדים במיקום הפיזי בפועל של המשתמש, לפי מיקום גיאוגרפי מטורגט או לא מטורגט. אם משתמשים בשדות פילוח אחרים, יכול להיות שיופיעו כמה שורות לכל מדינה.
ביקור ביקור.
webpage_view צפייה בדף אינטרנט.