הערות מוצר

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

גרסת ה-API העדכנית ביותר: v2

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_ID	0: הכללתם נתונים ברמת סמך נמוכה יותר. (ברירת המחדל אחרי 4 בפברואר 2025) 1: כוללים רק נתונים עם רמת ביטחון גבוהה. (ברירת המחדל לפני 4 בפברואר 2025)

‫1 באוקטובר 2024

תכונות חדשות

ללא.

בעיות מוכרות

v2

הוצאה משימוש של המאפיין לדיווח על יצירת מודלים של מלאי אנונימי (AIM)

המאפיין 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 או הפעלתם עם הערך YOUTUBE בשדה params.type וערך רלוונטי של מדד בשדה params.metrics מחזירה את השגיאה 400.

1 במאי 2024

תכונות חדשות

ללא.

בעיות מוכרות

v2

הוצאה משימוש של דוחות 'נתיב מלא' ו'שיוך (Attribution) של נתיב'

הדוחות 'נתיב מלא' ו'שיוך לנתיב' יוצאו משימוש. אחזור או יצירה של משאבים מהסוגים האלה של 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

תכונות חדשות

השקנו את 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/doubleclickbidmanager	https://doubleclickbidmanager.googleapis.com

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

  שירות v1	שירות v2
  שאילתות	שאילתות
  דוחות	queries.reports

• השמות של השיטות השתנו באופן הבא:

  השיטה v1	שיטת v2
  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	get

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

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

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

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

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

  משאב	שדות	סוג אובייקט
  שאילתה	מטא-נתונים params לוח זמנים	QueryMetadata פרמטרים QuerySchedule
  דיווח	key מטא-נתונים params	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 לגרסאות שיצאו משימוש, אפשר לעיין בנתוני הגרסה הקודמים שעברנו לארכיון.