보관처리된 출시 노트

이 페이지에는 Bid Manager API의 지원 종료 버전에 관한 출시 노트가 포함되어 있습니다.

다음 버전을 사용할 수 있는 모든 버전의 기본 출시 노트 페이지로 이동합니다. 서비스 중인 버전입니다

2021년 4월 15일

새로운 기능

Bid Manager API v1.1이 출시되었습니다.

v1.1

SDF 및 광고 항목 서비스 지원 종료

이제 SDF 및 광고 항목 서비스가 지원 중단됩니다.

구조화된 데이터 파일을 다운로드하거나 광고 항목을 관리하려는 사용자는 대신 Display & Video 360 API를 사용해야 합니다.

알려진 문제

없음

2020년 8월 6일

새로운 기능

v1.1

경로 및 경로 기여도 보고서

TYPE_PATH 및 TYPE_PATH_ATTRIBUTION report types의 실시간 스트리밍이 시작되었습니다.

여기에는 새 필드 params.options.pathQueryOptions가 추가되었습니다. (pathFilters 및 channelGrouping 필드 포함)를 사용하여 query 및 리소스 report개.

새 Filters 추가됨:

  • FILTER_CHANNEL_GROUPING
  • FILTER_EVENT_TYPE
  • FILTER_PATH_EVENT_INDEX
  • FILTER_PATH_PATTERN_ID

새로운 Metrics가 추가되었습니다.

  • METRIC_ACTIVITY_REVENUE
  • METRIC_CONVERTING_PATHS
  • METRIC_EXPOSURE_CONVERSION_RATE
  • METRIC_LAST_TOUCH_CLICK_THROUGH_CONVERSIONS
  • METRIC_LAST_TOUCH_TOTAL_CONVERSIONS
  • METRIC_LAST_TOUCH_VIEW_THROUGH_CONVERSIONS
  • METRIC_PATH_CONVERSION_RATE
  • METRIC_PROVISIONAL_IMPRESSIONS
  • METRIC_TOTAL_EXPOSURES
  • METRIC_TOTAL_PATHS

알려진 문제

없음

2020년 3월 20일

새로운 기능

v1.1

비동기 쿼리 실행

이제 Queries.createquery 및 Queries.runquery 메서드를 사용하여 쿼리를 비동기식으로 실행할 수 있습니다.

자세한 내용은 createquery 및 runquery의 새 매개변수 asynchronous를 참고하세요.

알려진 문제

없음

2020년 1월 14일

새로운 기능

v1.1

쿼리 일정 시작 시간

이제 Queries.createquery 메서드 쿼리 실행 일정이 시작되는 날짜를 지정할 수 있습니다.

새 필드 보기 schedule.startTimeMs: 확인하세요.

알려진 문제

없음

2020년 1월 8일

새로운 기능

v1.1

타겟 잠재고객 목록 데이터 전환

이제 Queries.createquery 메서드를 사용하여 잠재고객 목록 데이터를 특정 게재 신청서 또는 광고 항목으로 제한해야 하는지 지정할 수 있습니다.

자세한 내용은 새 필드 params.options.includeOnlyTargetedUserLists를 참고하세요.

알려진 문제

없음

2019년 11월 19일

새로운 기능

v1.1

보고서 열 매핑에 대한 일대일 필터

여러 보고서 열에 매핑되던 필터가 이제 단일 보고서 열에 매핑됨 열 수 있습니다.

예를 들어 v1에서 FILTER_ADVERTISER 필터를 포함하면 '광고주 ID' 외에 '광고주' 열이 포함된 보고서가 생성됩니다. v1.1에서 모든 보고서 열에는 자체 필터가 있습니다. 예를 들어 FILTER_ADVERTISER_NAME는 '광고주'에 매핑됩니다. 보고서에서 '광고주 ID' 열과 '광고주' 열을 모두 가져오려면 Queries.createquery 요청에 필터 FILTER_ADVERTISER와 FILTER_ADVERTISER_NAME를 모두 포함해야 합니다.

더 구체적으로 createquery 요청은 다음을 충족해야 합니다.

{
...
"params": {
  ...
  "groupBys": ["FILTER_ADVERTISER"],
  "metrics": ["METRIC_IMPRESSIONS"],
  ...
}
...
}

v1에서 다음 헤더가 포함된 보고서 파일을 생성합니다.

Advertiser,Advertiser ID,Advertiser Status,Advertiser Integration Code,Impressions

v1.1의 다음 헤더:

Advertiser,Impressions

보고서 열을 가져오는 데 사용된 다음 v1 코드:

List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
    new com.google.api.services.doubleclickbidmanager.model.Parameters()
        .setGroupBys(groupBys)
        .setMetrics(metrics);

v1.1에서는 다음과 같이 수정해야 합니다(필터 순서 참고).

List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER_NAME");
groupBys.add("FILTER_ADVERTISER");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_STATUS");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_CODE");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
    new com.google.api.services.doubleclickbidmanager.model.Parameters()
        .setGroupBys(groupBys)
        .setMetrics(metrics);
기존 필터 필터 추가됨
FILTER_ADVERTISER FILTER_ADVERTISER_NAME
FILTER_ADVERTISER_INTEGRATION_CODE
FILTER_ADVERTISER_INTEGRATION_STATUS
FILTER_AD_POSITION FILTER_AD_POSITION_NAME
FILTER_CARRIER FILTER_CARRIER_NAME
FILTER_CHANNEL_ID FILTER_CHANNEL_NAME
FILTER_CITY FILTER_CITY_NAME
FILTER_COMPANION_CREATIVE_ID FILTER_COMPANION_CREATIVE_NAME
FILTER_DMA FILTER_DMA_NAME
FILTER_INSERTION_ORDER FILTER_INSERTION_ORDER_NAME
FILTER_PARTNER FILTER_PARTNER_NAME
FILTER_PARTNER_STATUS
FILTER_REGION FILTER_REGION_NAME
FILTER_TRUEVIEW_DMA FILTER_TRUEVIEW_DMA_NAME
FILTER_TRUEVIEW_IAR_REGION FILTER_TRUEVIEW_IAR_REGION_NAME
FILTER_USER_LIST_FIRST_PARTY FILTER_USER_LIST_FIRST_PARTY_NAME
FILTER_USER_LIST_THIRD_PARTY FILTER_USER_LIST_THIRD_PARTY_NAME
페이지로 나누기

v1.1에서는 Queries.listqueries 및 Reports.listreports 메서드에 페이징을 추가합니다.

v1.1에서 이러한 메서드가 반환하는 결과 수는 새로 추가된 매개변수 pageSize와 같습니다(지정되지 않은 경우 기본값은 100). 응답에는 다음 결과 집합을 검색하는 데 사용할 수 있는 새로 추가된 nextPageToken 필드가 포함됩니다. 결과가 나오면 이 필드는 비어 있습니다. 모두 소진되었습니다.

다음 v1 코드는 특정 검색어에 속한 모든 보고서를 가져옵니다.

public class GetReports {
  public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
    ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();

    return reportListResponse.getReports();
  }
}

모든 보고서를 계속 가져오려면 v1.1에서 다음과 같이 수정해야 합니다.

public class GetReports {
  public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
    ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();

    List<Report> reports = new ArrayList<>(reportListResponse.getReports());
    while (reportListResponse.getNextPageToken() != null
        && reportListResponse.getNextPageToken().length() > 0) {
      // Get next set, or page, of results.
      reportListResponse =
          service
              .reports()
              .listreports(queryId)
              .setPageToken(reportListResponse.getNextPageToken())
              .execute();
      reports.addAll(reportListResponse.getReports());
    }

    return reports;
  }
}

Queries.listqueries 및 Reports.listreports 메서드 문서를 참조하세요.

알려진 문제

없음