이 페이지에서는 Google Bid Manager API의 출시 노트를 제공합니다.
최신 API 버전: v2
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
params.type
이 YOUTUBE
이고 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
로 대체했습니다.
다음과 같은 변경사항을 통해 보고서 검색을 간소화했습니다.
queries.reports.get
메서드가 추가되었습니다.queries.reports.list
에orderBy
쿼리 매개변수가 추가되었습니다.queries.run
응답 본문을 빈 객체에서 생성된Report
리소스의 인스턴스로 업데이트합니다.
API에서 반환하는 오류 메시지를 더 구체적으로 업데이트하고 더 많은 해결 방법을 제공합니다.
v2 이전 가이드에 나온 안내에 따라 v1.1에서 v2로 이전합니다.
v2
서비스 엔드포인트가 변경되었습니다.
v1 서비스 엔드포인트 v2 서비스 엔드포인트 https://www.googleapis.com/doubleclickbidmanager
https://doubleclickbidmanager.googleapis.com
서비스의 이름이 다음과 같이 변경되었습니다.
v1 서비스 v2 서비스 검색어 검색어 보고서 queries.reports 메서드의 이름이 다음과 같이 변경되었습니다.
다음 메서드가 추가되었습니다.
서비스 방법 queries.reports get 다음 메서드에는 새 응답 본문이 있습니다.
메서드 새 응답 본문 객체 queries.run 보고서 다음 필드가 삭제되었습니다.
리소스 필드 queries.list
응답 본문kind
queries.reports.list
응답 본문kind
쿼리 kind
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
다음 필드의 객체 유형이 다음과 같이 변경되었습니다.
리소스 필드 객체 유형 쿼리 보고서 RunQueryRequest 다음 메서드 쿼리 매개변수가 추가되었습니다.
메서드 쿼리 매개변수 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 출시에 관한 자세한 내용은 보관처리된 출시 노트를 참고하세요.