בדף הזה מפורטים נתוני הגרסה של Google Bid Manager API.
גרסת ה-API העדכנית ביותר: v2
1 במרץ 2025
תכונות חדשות
בעיות מוכרות
הוצאה משימוש של הדוח 'זמינות מלאי שטחי הפרסום ב-YouTube TrueView' והמאפיינים הקשורים, כפי שפורסם בעבר במרכז העזרה של Display & Video 360.
v2
ערכי ה-enum הבאים הוצאו משימוש:
Enum ערכים ReportTypeINVENTORY_AVAILABILITYהמסננים הבאים הוצאו משימוש:
ערכי סינון FILTER_DETAILED_DEMOGRAPHICSFILTER_DETAILED_DEMOGRAPHICS_IDFILTER_HOUSEHOLD_INCOMEFILTER_LIFE_EVENTFILTER_REMARKETING_LISTFILTER_TRUEVIEW_IAR_AGEFILTER_TRUEVIEW_IAR_CATEGORYFILTER_TRUEVIEW_IAR_CITYFILTER_TRUEVIEW_IAR_COUNTRYFILTER_TRUEVIEW_IAR_COUNTRY_NAMEFILTER_TRUEVIEW_IAR_GENDERFILTER_TRUEVIEW_IAR_INTERESTFILTER_TRUEVIEW_IAR_LANGUAGEFILTER_TRUEVIEW_IAR_PARENTAL_STATUSFILTER_TRUEVIEW_IAR_REGION_NAMEFILTER_TRUEVIEW_IAR_REMARKETING_LISTFILTER_TRUEVIEW_IAR_TIME_OF_DAYFILTER_TRUEVIEW_IAR_YOUTUBE_CHANNELFILTER_TRUEVIEW_IAR_YOUTUBE_VIDEOFILTER_TRUEVIEW_IAR_ZIPCODEFILTER_YOUTUBE_CHANNELFILTER_YOUTUBE_VIDEOהמדדים הבאים הוצאו משימוש:
ערכי המדדים METRIC_POTENTIAL_VIEWSMETRIC_TEA_TRUEVIEW_IMPRESSIONSMETRIC_TEA_TRUEVIEW_UNIQUE_COOKIES
20 בנובמבר 2024
תכונות חדשות
ה-FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID מופעל. כך אפשר לכלול נתונים ברמת וודאות נמוכה יותר למדדים עם הקידומות הבאות:
METRIC_UNIQUE_REACH_METRIC_VIRTUAL_PEOPLE_DUPLICATE_METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_METRIC_VIRTUAL_PEOPLE_OVERLAP_
כשמשתמשים במסנן הזה, צריך לכלול אחד מהמדדים הרלוונטיים.
במהלך ההשקה, שאילתות שלא יכללו את המסנן הזה יפעלו כברירת מחדל לפי התנהגות ברירת המחדל הקודמת, כלומר יכללו רק נתונים מהימנים. החל מ-4 בפברואר 2025, שאילתות שלא כוללות את המסנן הזה יכללו כברירת מחדל נתונים עם רמת אמינות נמוכה יותר.
v2
נוספו המסננים הבאים:
סוג מסנן הערכים הזמינים FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID0: הכללת נתונים עם רמת סמך נמוכה יותר. (ברירת המחדל אחרי 4 בפברואר 2025)1: כוללים רק נתונים עם רמת מהימנות גבוהה. (ברירת המחדל לפני 4 בפברואר 2025)
1 באוקטובר 2024
תכונות חדשות
ללא.
בעיות מוכרות
v2
הוצאה משימוש של המאפיין לדיווח על יצירת מודלים של מלאי אנונימי (AIM)
המאפיין FILTER_ANONYMOUS_INVENTORY_MODELING הוא שקיעה.
יצירת משאבים של Query או הפעלתם באמצעות ערכים של סיום תמיכה ב-params.groupBy מחזירה את השגיאה 400.
המדדים 'מס שירותים דיגיטליים (DST)', 'דמי תפעול רגולטורי (ROC)' ו'עלות המדיה הכוללת' לא תואמים יותר לדוחות YOUTUBE.
אי אפשר יותר להשתמש בערכים הבאים של המדדים בדוחות YOUTUBE:
METRIC_TOTAL_MEDIACOST_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPC_PARTNERMETRIC_TOTAL_MEDIACOST_ECPAPC_USDMETRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPV_PARTNERMETRIC_TOTAL_MEDIACOST_ECPAPV_USDMETRIC_TOTAL_MEDIACOST_ECPA_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPA_PARTNERMETRIC_TOTAL_MEDIACOST_ECPA_USDMETRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPCV_PARTNERMETRIC_TOTAL_MEDIACOST_ECPCV_USDMETRIC_TOTAL_MEDIACOST_ECPC_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPC_PARTNERMETRIC_TOTAL_MEDIACOST_ECPC_USDMETRIC_TOTAL_MEDIACOST_ECPM_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPM_PARTNERMETRIC_TOTAL_MEDIACOST_ECPM_USDMETRIC_TOTAL_MEDIACOST_PARTNERMETRIC_TOTAL_MEDIACOST_USDMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISERMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNERMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USDMETRIC_FEE32_ADVERTISERMETRIC_FEE32_PARTNERMETRIC_FEE32_USD
יצירת משאבים מסוג Query או הפעלתם עם הערך YOUTUBE בשדה params.type ועם ערך מדד רלוונטי בשדה params.metrics מחזירה את השגיאה 400.
1 במאי 2024
תכונות חדשות
ללא.
בעיות מוכרות
v2
הוצאה משימוש של הדוחות 'נתיב מלא' ו'נתיב שיוך (Attribution)'
הדוחות 'נתיב מלא' ו'שיוך (Attribution) לפי נתיב' יוצאו משימוש. אחזור או יצירה של משאבים מהסוגים האלה של Query ו-Report יגרמו לשגיאה.
הערכים הבאים של ReportType הם שקיעה:
FULL_PATHPATH_ATTRIBUTION
גם השדה pathQueryOptions של האובייקט Options יצא משימוש.
28 בפברואר 2024
תכונות חדשות
ללא.
בעיות מוכרות
v2
הפסקת השימוש בערכים של מדדי המרות חוצות-מכשירים
מדדי המרות חוצות-מכשירים יוצאו משימוש. הדוח כולל את ערכי המדדים הבאים של Bid Manager API:
METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENTMETRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENTMETRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENTMETRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENTMETRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT
6 ביולי 2022
תכונות חדשות
השקנו את Bid Manager API גרסה 2.
ביצענו שינויים מבניים ב-API, כולל עדכון נקודת הקצה של השירות ושינוי השמות של השירותים והשיטות.
עדכנו באופן משמעותי את המשאבים של שאילתות ודוחות על ידי הסרת שדות מיותרים, ארגון מחדש של שדות קיימים ושינוי סוגי השדות. זה כולל שינוי סוגי השדות כך שישתמשו באובייקטים עם שמות במקום בהגדרה כללית של 'אובייקט בתצוגת עץ'.
נדרש להריץ שאילתות חד-פעמיות באמצעות השיטה queries.run במקום להריץ אותן באופן אוטומטי אחרי היצירה.
פרמטר השאילתה asynchronous של queries.run הוחלף ב-synchronous.
אחזור פשוט יותר של דוחות באמצעות השינויים הבאים:
- הוספת שיטה
queries.reports.get. - הוספת פרמטר של שאילתה
orderByאלqueries.reports.list. - העדכון של גוף התגובה
queries.runמאובייקט ריק למכונה של המשאבReportשנוצר.
עדכנו את הודעות השגיאה שמוחזרות על ידי ה-API כדי שהן יהיו ספציפיות יותר ויספקו פתרונות מפורטים יותר.
כדי לעבור מגרסה 1.1 לגרסה 2, פועלים לפי ההוראות שמפורטות במדריך להעברה לגרסה 2.
v2
נקודת הקצה (endpoint) של השירות השתנתה:
נקודת קצה של שירות בגרסה 1 נקודת קצה של שירות בגרסה 2 https://www.googleapis.com/doubleclickbidmanagerhttps://doubleclickbidmanager.googleapis.comהשמות של השירותים השתנו באופן הבא:
שירות v1 שירות v2 שאילתות שאילתות דוחות queries.reports השמות של השיטות השתנו באופן הבא:
נוספו השיטות הבאות:
שירות שיטות queries.reports get לשיטות הבאות יש גוף תגובה חדש:
שיטה אובייקט חדש של גוף התשובה queries.run דיווח השדות הבאים הוסרו:
משאב שדות queries.listגוף התגובהסיווג
queries.reports.listגוף התגובהסיווג
שאילתה סיווג
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
סוג האובייקט של השדות הבאים השתנה לערכים הבאים:
נוספו הפרמטרים הבאים של שאילתות לשיטה:
שיטה פרמטרים של שאילתות queries.list orderBy queries.reports.list orderBy queries.run סינכרוני הפרמטרים הבאים של שאילתות שיטות הוסרו:
שיטה פרמטרים של שאילתות queries.create אסינכרוני queries.run אסינכרוני הוספנו את ערכי המסננים הבאים:
ערך המסנן FILTER_INVENTORY_MEDIA_COST_TYPE FILTER_TARGETING_EXPANSION הערכים הבאים של המסנן הוסרו:
ערך המסנן FILTER_TRUEVIEW_IAR_REGION נוספו הערכים הבאים של המדדים:
ערך המדד METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH
בעיות מוכרות
ללא.
גרסאות קודמות
כדי לקרוא על גרסאות קודמות של Bid Manager API לגרסאות שיצאו משימוש, אפשר לעיין בנתוני הגרסה הקודמים ששמורים בארכיון.