현재 일부 보고서 유형이 오프라인에서 빠른 보고서로 이전 중입니다. 사용자가 이전되면 queries.list 응답에 기존의 빠른 보고서가 포함됩니다. 자세한 내용은 블로그 게시물을 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

보관처리된 출시 노트

이 페이지에는 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 메서드 비동기식으로 쿼리를 실행할 수 있습니다

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

알려진 문제

없음

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' '광고주'라는 보고서의 열(필터가 FILTER_ADVERTISER 및 FILTER_ADVERTISER_NAME는 각각 Queries.createquery 요청을 처리합니다

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

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

는 v1에서 다음과 같은 헤더가 있는 보고서 파일을 생성합니다.

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

및 다음 헤더가 있습니다.

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에서는 이 API를 통해 반환된 결과의 메서드는 새로 추가된 매개변수와 같음 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();
  }
}

를 모든 보고서를 계속 가져옵니다.

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 메서드 문서를 참조하세요.

알려진 문제

없음