출시 노트

이 페이지에서는 Google Bid Manager API의 출시 노트를 제공합니다.

최신 API 버전: v2

2025년 9월 22일

알려진 문제

Display & Video 360 고객센터에서 이전에 공지한 대로 사용률이 낮은 Filter enum 값 3개가 지원 중단됩니다.

v2

  • 다음 Filters은 지원이 중단되었습니다.

    Filter 값

    FILTER_DFP_ORDER_ID

    FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_INSERTION_ORDER

    FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER

2025년 3월 1일

알려진 문제

이전에 Display & Video 360 고객센터에서 발표한 대로 YouTube TrueView 인벤토리 가용성 보고서 및 관련 측정기준이 지원 중단됩니다.

v2

  • 다음 열거형 값은 지원 중단되었습니다.

    열거형값
    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

2024년 11월 20일

새로운 기능

FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID이 실행됩니다. 이를 통해 다음 접두사가 있는 측정항목에 신뢰도가 낮은 데이터를 포함할 수 있습니다.

  • METRIC_UNIQUE_REACH_
  • METRIC_VIRTUAL_PEOPLE_DUPLICATE_
  • METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
  • METRIC_VIRTUAL_PEOPLE_OVERLAP_

이 필터를 사용할 때는 관련 측정항목 중 하나를 포함해야 합니다.

출시 시 이 필터를 포함하지 않는 쿼리는 신뢰도가 높은 데이터만 포함하는 이전 기본 동작으로 기본 설정됩니다. 2025년 2월 4일부터 이 필터를 포함하지 않는 쿼리는 신뢰도가 낮은 데이터를 기본적으로 포함합니다.

v2

  • 다음 필터가 추가되었습니다.

    필터 유형사용 가능한 값
    FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID

    0: 신뢰도가 낮은 데이터를 포함합니다. (2025년 2월 4일 이후 기본값)

    1: 신뢰도가 높은 데이터만 포함합니다. (2025년 2월 4일 이전의 기본값)

2024년 10월 1일

새로운 기능

없음

알려진 문제

v2

익명 인벤토리 모델링 (AIM) 보고 측정기준 지원 종료

FILTER_ANONYMOUS_INVENTORY_MODELING 측정기준이 지원 종료됩니다.

params.groupBy에서 일몰 값을 사용하여 Query 리소스를 만들거나 실행하면 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

YOUTUBE의 params.type과 params.metrics의 관련 측정항목 값을 사용하여 Query 리소스를 만들거나 실행하면 400 오류가 반환됩니다.

2024년 5월 1일

새로운 기능

없음

알려진 문제

v2

전체 경로 및 경로 기여 분석 보고서 지원 종료

전체 경로 및 경로 기여 분석 보고서가 지원 종료됩니다. 이러한 유형의 Query 및 Report 리소스를 가져오거나 생성하면 오류가 발생합니다.

다음 ReportType 값은 지원이 종료됩니다.

  • FULL_PATH
  • PATH_ATTRIBUTION

Options 객체의 pathQueryOptions 필드도 지원이 종료됩니다.

2024년 2월 28일

새로운 기능

없음

알려진 문제

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

2022년 7월 6일

새로운 기능

Bid Manager API v2가 출시되었습니다.

서비스 엔드포인트를 업데이트하고 서비스와 메서드의 이름을 바꾸는 등 API의 구조를 변경했습니다.

불필요한 필드를 삭제하고, 기존 필드를 재구성하고, 필드 유형을 변경하여 쿼리 및 보고서 리소스를 크게 업데이트했습니다. 여기에는 일반적인 '중첩 객체' 정의 대신 명명된 객체를 사용하도록 필드 유형을 변경하는 것이 포함됩니다.

생성 후 자동으로 실행되는 대신 queries.run 메서드를 사용하여 임시 쿼리를 실행해야 합니다.

queries.run 쿼리 매개변수 asynchronous을 synchronous로 대체했습니다.

다음과 같은 변경사항을 통해 보고서 검색이 간소화되었습니다.

API에서 반환되는 오류 메시지가 더 구체적이고 더 많은 규범적 솔루션을 제공하도록 업데이트되었습니다.

v2 마이그레이션 가이드에 제시된 안내에 따라 v1.1에서 v2로 마이그레이션합니다.

v2

알려진 문제

없음

이전 출시

지원 종료 버전의 이전 Bid Manager API 출시에 대해 알아보려면 보관된 출시 노트를 참고하세요.