נתוני גרסה

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

הגרסה האחרונה של ה-API‏: v2

‫22 בספטמבר 2025

בעיות מוכרות

הוצאנו משימוש שלושה ערכי enum‏ (Filter) בגלל שימוש נמוך, כפי שפורסם בעבר במרכז העזרה של Display & Video 360.

v2

  • התכונות הבאות Filters יצאו משימוש:

    ערך אחד או יותר של Filter

    FILTER_DFP_ORDER_ID

    FILTER_INSERTION_ORDER

    FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER

‫1 במרץ 2025

בעיות מוכרות

הוצאנו משימוש את הדוח 'זמינות מלאי שטחי פרסום ב-YouTube TrueView' ואת המאפיינים שקשורים אליו, כפי שפורסם בעבר במרכז העזרה של Display & Video 360.

v2

  • הערכים הבאים של enum הוצאו משימוש:

    Enumערכים
    ReportType INVENTORY_AVAILABILITY

  • המסננים הבאים הוצאו משימוש:

    ערכי סינון

    FILTER_DETAILED_DEMOGRAPHICS

    FILTER_DETAILED_DEMOGRAPHICS_ID

    FILTER_HOUSEHOLD_INCOME

    FILTER_LIFE_EVENT

    FILTER_REMARKETING_LIST

    FILTER_TRUEVIEW_IAR_AGE

    FILTER_TRUEVIEW_IAR_CATEGORY

    FILTER_TRUEVIEW_IAR_CITY

    FILTER_TRUEVIEW_IAR_COUNTRY

    FILTER_TRUEVIEW_IAR_COUNTRY_NAME

    FILTER_TRUEVIEW_IAR_GENDER

    FILTER_TRUEVIEW_IAR_INTEREST

    FILTER_TRUEVIEW_IAR_LANGUAGE

    FILTER_TRUEVIEW_IAR_PARENTAL_STATUS

    FILTER_TRUEVIEW_IAR_REGION_NAME

    FILTER_TRUEVIEW_IAR_REMARKETING_LIST

    FILTER_TRUEVIEW_IAR_TIME_OF_DAY

    FILTER_TRUEVIEW_IAR_YOUTUBE_CHANNEL

    FILTER_TRUEVIEW_IAR_YOUTUBE_VIDEO

    FILTER_TRUEVIEW_IAR_ZIPCODE

    FILTER_YOUTUBE_CHANNEL

    FILTER_YOUTUBE_VIDEO

  • הוצאנו משימוש את המדדים הבאים:

    ערכי מדדים

    METRIC_POTENTIAL_VIEWS

    METRIC_TEA_TRUEVIEW_IMPRESSIONS

    METRIC_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_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 עם 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

תכונות חדשות

השקנו את Bid Manager API v2.

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

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

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

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

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

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

כדי לעבור מגרסה 1.1 לגרסה 2, פועלים לפי ההוראות שמפורטות במדריך להעברה לגרסה 2.

v2

בעיות מוכרות

ללא.

גרסאות קודמות

כדי לקרוא על גרסאות קודמות של Bid Manager API שהוצאו משימוש, אפשר לעיין בנתוני הגרסה בארכיון.