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

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

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

Los usuarios que deseen descargar archivos de datos estructurados o administrar líneas de pedido deben usar la API de Display & 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

El método Queries.createquery ahora permite especificar la fecha en la que comienzan las programaciones 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

Cómo activar o desactivar los datos de las listas de públicos de segmentación

El método Queries.createquery ahora permite especificar si los datos de la lista de público deben limitarse a órdenes de inserción o líneas de pedido específicas.

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 asignaban a varias columnas de informes ahora se asignan a columnas únicas.

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 del informe 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.

Más concretamente, la solicitud createquery hace lo siguiente:

{
...
"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

El siguiente código de v1 se usa 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 manera similar a lo siguiente en la v1.1 (nota el orden del filtro):

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 1.1, la cantidad de resultados que muestran estos métodos es igual a un parámetro agregado recientemente, pageSize (se establece de forma predeterminada en 100 si no se especifica). Las respuestas contienen un campo nextPageToken agregado recientemente que se puede usar 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 la documentación de los métodos Queries.listqueries y Reports.listreports para obtener más detalles.

Problemas conocidos

Ninguno