הערות מוצר

בדף הזה מופיעים נתוני הגרסה של Google Bid Manager API.

גרסת ה-API האחרונה: גרסה 2

1 באוקטובר 2024

זהירות: השינוי הזה צפוי.

תכונות חדשות

ללא.

בעיות מוכרות

v2

סגירה של מאפיין הדיווח על מודלים של מלאי שטחי פרסום אנונימי (ACE)

המאפיין FILTER_ANONYMOUS_INVENTORY_MODELING נסגר.

בתהליך יצירה או הפעלה של Query משאבים שמשתמשים בערכי שקיעה params.groupBy מחזירה שגיאה 400.

מדדי DST/ROC (דמי תפעול רגולטורי) ו'עלות מדיה כוללת' תואמים לדוחות YOUTUBE.

לא ניתן יותר להשתמש בערכי המדדים הבאים בדוחות YOUTUBE:

• METRIC_TOTAL_MEDIACOST_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPAPC_USD
• METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPAPV_USD
• METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPA_USD
• METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPCV_USD
• METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPC_USD
• METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPM_USD
• METRIC_TOTAL_MEDIACOST_PARTNER
• METRIC_TOTAL_MEDIACOST_USD
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
• METRIC_FEE32_ADVERTISER
• METRIC_FEE32_PARTNER
• METRIC_FEE32_USD

בתהליך יצירה או הפעלה של Query משאבים באמצעות params.type מתוך YOUTUBE וערך מדד רלוונטי ב- params.metrics מחזירה שגיאה 400.

1 במאי 2024

תכונות חדשות

ללא.

בעיות מוכרות

v2

הפסקת השימוש בדוחות שיוך מסוג 'נתיב מלא' ו'נתיב'

הדוחות 'שיוך נתיב מלא' ו'נתיב' עומדים לצאת משימוש. אחזור או יצירה של ההגדרות האלה סוגים של Query Report משאבים יוביל לשגיאה.

הבאים הערכים של ReportType הם שקיעה:

• FULL_PATH
• PATH_ATTRIBUTION

pathQueryOptions שדה של גם האובייקט Options הוא לשקיעה.

‫28 בפברואר 2024

תכונות חדשות

ללא.

בעיות מוכרות

v2

הפסקת השימוש בערכים של מדדי המרות חוצות-מכשירים

המרה חוצת-מכשירים מדדים נסגרים. המדד הבא של Bid Manager API כלולים:

• METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
• METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
• METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
• METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
• METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT

6 ביולי 2022

תכונות חדשות

הושקה גרסה 2 של Bid Manager API.

בוצעו שינויים מבניים ב-API, כולל עדכון השירות של נקודות קצה ושינוי שם של שירותים ושיטות.

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

נדרשת הרצת שאילתות אד-הוק באמצעות השיטה queries.run במקום שהן יופעלו באופן אוטומטי אחרי שיוצרים אותן.

פרמטר השאילתה queries.run הוחלף בפרמטר asynchronous synchronous.

כדי לאחזר דוחות בצורה פשוטה יותר, אפשר לבצע את השינויים הבאים:

• הוספת השיטה queries.reports.get.
• הוספת פרמטר השאילתה orderBy אל queries.reports.list
• עדכון גוף התגובה queries.run מאובייקט ריק ל- מופע של המשאב Report שנוצר.

הודעות שגיאה מעודכנות שהוחזרו על ידי ה-API כך שיהיו ספציפיות יותר ויספקו יותר באמצעות מרשם.

פועלים לפי ההוראות במדריך להעברת גרסה 2 כדי: לעבור מ-v1.1 לגרסה 2.

v2

• נקודת הקצה של השירות השתנתה:

  נקודת קצה של שירות גרסה 1	נקודת קצה (endpoint) של שירות גרסה 2
  https://www.googleapis.com/doubleclickbidmanager	https://doubleclickbidmanager.googleapis.com

• שמות השירותים השתנו כך:

  שירות גרסה 1	שירות גרסה 2
  שאילתות	שאילתות
  דוחות	queries.reports

• שמות השיטות השתנו כך:

  שיטה גרסה 1	שיטת גרסה 2
  Queries.createquery	queries.create
  Queries.deletequery	queries.delete
  Queries.getquery	queries.get
  Queries.listqueries	queries.list
  Queries.runquery	queries.run
  Reports.listreports	queries.reports.list

• נוספו השיטות הבאות:

  שירות	שיטות
  queries.reports	הורדה

• לשיטות הבאות יש גוף תגובה חדש:

  שיטה	אובייקט חדש של גוף התשובה
  queries.run	דיווח

• הוסרו השדות הבאים:

  משאב	שדות
  queries.list גוף התשובה	סיווג
  queries.reports.list גוף התשובה	סיווג
  שאילתה	סיווג reportDataEndTimeMs reportDataStartTimeMs timezoneCode
  RunQueryRequest	reportDataEndTimeMs reportDataStartTimeMs timezoneCode

• סוג האובייקט בשדות הבאים השתנה ועכשיו הוא:

  משאב	שדות	סוג אובייקט
  שאילתה	מטא-נתונים פרמטרים לוח זמנים	QueryMetadata פרמטרים QuerySchedule
  דיווח	מפתח מטא-נתונים פרמטרים	ReportKey ReportMetadata פרמטרים
  RunQueryRequest	dataRange	DataRange

• הפרמטרים הבאים של שאילתת השיטה נוספו:

  שיטה	פרמטרים של שאילתות
  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 לגרסאות סגורות, אפשר לעיין נתוני הגרסה שהועברו לארכיון.