Actualmente, estamos migrando un subconjunto de tipos de informes de los informes sin conexión a los instantáneos. Una vez que se migra a un usuario, las respuestas de queries.list incluirán los informes instantáneos existentes. Consulta nuestra entrada de blog para obtener más información.

Se usó la API de Cloud Translation para traducir esta página.

Notas de la versión archivadas

En esta página, se proporcionan notas de las versiones descontinuadas de la API de Bid Manager.

Ve a la página principal de notas de la versión para que todas las versiones versiones publicadas.

15 de abril de 2021

Nuevas funciones

Se lanzó la versión 1.1 de la API de Bid Manager.

v1.1

Descontinuación de los servicios de SDF y líneas de pedido

SDF y línea de pedido servicios están desaparecidos.

Usuarios que buscan descargar datos estructurados Los archivos o las líneas de pedido administradas deben en cambio, usa la opción Display & API de Video 360.

Problemas conocidos

Ninguno

6 de agosto de 2020

Nuevas funciones

v1.1

Ruta y Informes de atribución de ruta

TYPE_PATH y TYPE_PATH_ATTRIBUTION report types ya están en vivo.

Esto incluye la adición del nuevo campo params.options.pathQueryOptions. (que contiene los campos pathFilters y channelGrouping) a query y report.

Se agregó un nuevo Filters:

FILTER_CHANNEL_GROUPING
FILTER_EVENT_TYPE
FILTER_PATH_EVENT_INDEX
FILTER_PATH_PATTERN_ID

Se agregó un nuevo 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

Problemas conocidos

Ninguno

20 de marzo de 2020

Nuevas funciones

v1.1

Ejecución de consulta asíncrona

Queries.createquery y Queries.runquery ahora permiten ejecutar consultas de forma asíncrona.

Consulta el nuevo parámetro asynchronous en createquery y runquery para obtener más información.

Problemas conocidos

Ninguno

14 de enero de 2020

Nuevas funciones

v1.1

Hora de inicio del programa de consultas

Queries.createquery ahora permite especificar la fecha en la que comienzan los programas de ejecución de consultas.

Ver campo nuevo schedule.startTimeMs para más detalles.

Problemas conocidos

Ninguno

8 de enero de 2020

Nuevas funciones

v1.1

Activar o desactivar los datos de las listas de público objetivo

Queries.createquery ahora permite especificar si los datos de la lista de público deben limitarse a contenido pedidos de inserción o líneas de pedido.

Ver campo nuevo params.options.includeOnlyTargetedUserLists para obtener más información.

Problemas conocidos

Ninguno

19 de noviembre de 2019

Nuevas funciones

v1.1

Filtro uno a uno para informar la asignación de columnas

Los filtros que se asignaron a varias columnas del informe ahora se asignan a una sola columnas.

Por ejemplo, en la versión 1, incluir el filtro FILTER_ADVERTISER genera un informe. con las columnas "Anunciante" además del "ID del anunciante". En la versión 1.1, todas las columnas de informes tienen sus propios filtros. Por ejemplo, un filtro nuevo FILTER_ADVERTISER_NAME se asigna a "Anunciante". Para obtener la configuración ID" y "Anunciante" columnas en los informes, ambos filtros FILTER_ADVERTISER y FILTER_ADVERTISER_NAME, respectivamente, deberán incluirse en Queries.createquery solicitudes.

En concreto, la solicitud createquery tiene las siguientes características:

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

genera un archivo de informe con los siguientes encabezados en la versión 1:

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

y los siguientes encabezados en v1.1:

Advertiser,Impressions

Utiliza el siguiente código de la versión 1 para obtener las columnas del informe:

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);

se deberá modificar de la siguiente manera en la versión 1.1 (filtro de notas pedidos):

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);

Filtro original	Filtros agregados
`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`

Paginación

La versión 1.1 agrega paginación a los métodos Queries.listqueries y Reports.listreports

En la versión v1.1, el número de resultados devueltos por estas de métodos equivale a un parámetro recién agregado pageSize (el valor predeterminado es 100 si no se especifica). Las respuestas contienen un error campo nextPageToken que para recuperar el siguiente conjunto de resultados. Este campo estará en blanco si los resultados se hayan agotado.

El siguiente código v1 para recuperar todos los informes que pertenecen a una consulta específica:

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

    return reportListResponse.getReports();
  }
}

se deberá modificar de la siguiente manera en la versión 1.1 para continuar recuperando todos los informes:

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;
  }
}

Consulta Queries.listqueries y Método Reports.listreports documentación para conocer más detalles.

Problemas conocidos

Ninguno