סקירה כללית
בדפים האלה מפורטים המשאבים שאפשר לשלוח לגביהם שאילתות ב-API באמצעות SearchAds360Service.SearchStream או SearchAds360Service.Search. שמות המשאבים מקושרים לדף שלהם. בכל דף מוצגות הרשימות הבאות:
- ארטיפקטים (משאבים, פלחים או מדדים) שאפשר להשתמש בהם באותו משפט SELECT עם המשאב
- משאבים משויכים שהשדות שלהם לא יפלחו מדדים, אם הם ייכללו באותם סעיפי SELECT ו-WHERE של שדות המשאבים האלה
אחרי הרשימות האלה מוצגות הטבלאות שמכילות את השמות של שדות המשאבים, הפלחים והמדדים שאפשר לכלול בשאילתת חיפוש, כשמציינים את המשאב הזה במשפט FROM. כל שם מקושר לטבלה שמכילה את המטא-נתונים שלו:
categorydata typetype URLfilterableselectablesortablerepeated
- ניתן לסינון
- בשורה הזו מצוין אם אפשר להשתמש בשדה בתנאים של סעיף
WHEREבשאילתה. - ניתן לבחירה
- בשורה הזו מצוין אם אפשר לציין את השדה בסעיף
SELECTשל השאילתה. - אפשר למיין
- בשורה הזו מצוין אם אפשר למיין את השדה ולהשתמש בו בסעיף
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 | תצוגה של טווח גילאים. |
| נכס | נכס הוא חלק ממודעה שאפשר לשתף בכמה מודעות. יכול להיות שמדובר בתמונה (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_asset | קישור בין קמפיין לבין נכס. |
| campaign_asset_set | CampaignAssetSet הוא הקישור בין קמפיין לבין קבוצת נכסים. הוספה של CampaignAssetSet מקשרת בין קבוצת נכסים לקמפיין. |
| campaign_audience_view | תצוגת קהל ברמת הקמפיין. כולל נתוני ביצועים מתחומי עניין ומרשימות רימרקטינג עבור מודעות ברשת המדיה וברשת YouTube, ורשימות רימרקטינג עבור מודעות לרשת החיפוש (RLSA), שמצטברים לפי קמפיין וקריטריון קהל. בתצוגה הזו נכללים רק קהלים שמצורפים ברמת הקמפיין. |
| campaign_budget | תקציב הקמפיין. |
| campaign_criterion | קריטריון של קמפיין. |
| campaign_effective_label | מייצג קשר בין קמפיין לבין תווית יעילה. תווית אפקטיבית היא תווית שעברה בירושה או שהוקצתה ישירות לקמפיין הזה. |
| campaign_label | מייצג קשר בין קמפיין לתווית. |
| cart_data_sales_view | תצוגת מכירות לפי נתוני עגלות קניות. |
| המרות | המרה. |
| conversion_action | פעולת המרה. |
| conversion_custom_variable | משתנה מותאם אישית של המרה. מידע נוסף על מדדים ומאפיינים מותאמים אישית של Floodlight בממשק החדש של Search Ads 360 זמין בכתובת https://support.google.com/sa360/answer/13567857 |
| לקוח | לקוח. |
| customer_asset | קישור בין לקוח לבין נכס. |
| customer_asset_set | CustomerAssetSet הוא הקישור בין לקוח לבין קבוצת נכסים. הוספה של CustomerAssetSet מקשרת בין קבוצת נכסים לבין לקוח. |
| customer_client | קישור בין הלקוח שצוין לבין לקוח של לקוח. האובייקט CustomerClients קיים רק עבור לקוחות בחשבון ניהול. כל הלקוחות הישירים והעקיפים כלולים, וגם חשבון הניהול עצמו. |
| customer_manager_link | מייצג את הקשר בין חשבון לקוח לחשבון ניהול. |
| dynamic_search_ads_search_term_view | תצוגה של מונחי חיפוש של מודעות דינמיות לרשת החיפוש. |
| gender_view | תצוגת מגדר. המשאב gender_view משקף את מצב ההצגה בפועל, ולא את הקריטריונים שנוספו. קבוצת מודעות ללא קריטריונים של מגדר מוצגת כברירת מחדל לכל המגדרים, ולכן כל המגדרים מופיעים בתצוגת gender_view עם נתונים סטטיסטיים. |
| 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 | צפייה בדף אינטרנט. |