סקירה כללית
בדפים האלה מפורטים המשאבים שאפשר לשלוח לגביהם שאילתות ב-API באמצעות SearchAds360Service.SearchStream או SearchAds360Service.Search. שמות המשאבים מקושרים לדף משלהם. בכל דף מוצגות הרשימות הבאות:
- רכיבים (משאבים, פלחים או מדדים) שאפשר להשתמש בהם באותו סעיף SELECT עם המשאב
- משאבים משויכים שהשדות שלהם לא יחלקו את המדדים לפלחים, כשהם נכללים באותם סעיפי SELECT ו-WHERE של שדות המשאבים האלה
אחרי הרשימות האלה מוצגות טבלאות שמכילות שמות של שדות משאבים, פלחים ומדדים שאפשר לכלול בשאילתת חיפוש, כשהמשאב הזה מצוין בסעיף FROM. כל שם מקושר לטבלה שמכילה את המטא-נתונים שלו:
categorydata typetype URLfilterableselectablesortablerepeated
- ניתן לסינון
- השורה הזו מציינת אם אפשר להשתמש בשדה בתנאים של הסעיף
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 | צפייה בדף אינטרנט. |