Notas de lançamento arquivadas

Esta página fornece notas para as versões de desativação da API Bid Manager.

Acesse nossa página principal de notas da versão para ver todas as versões mais recentes.

15 de abril de 2021

Novos recursos

Lançamento da API Bid Manager v1.1.

v1.1

Desativação dos serviços de SDF e item de linha

SDF e Item de linha serviços estão desativados.

Usuários que buscam fazer o download de dados estruturados Os arquivos ou os gerenciar itens de linha precisam em vez disso, use os botões Display & API Video 360.

Problemas conhecidos

Nenhum.

6 de agosto de 2020

Novos recursos

v1.1

Caminho e Relatórios de atribuição de caminho

TYPE_PATH e TYPE_PATH_ATTRIBUTION report types estão ao vivo.

Isso inclui a adição do novo campo params.options.pathQueryOptions. (que contém os campos pathFilters e channelGrouping) para query e report.

Novo Filters adicionado:

  • FILTER_CHANNEL_GROUPING
  • FILTER_EVENT_TYPE
  • FILTER_PATH_EVENT_INDEX
  • FILTER_PATH_PATTERN_ID

Novo Metrics adicionado:

  • 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 conhecidos

Nenhum.

20 de março de 2020

Novos recursos

v1.1

Execução de consulta assíncrona

Queries.createquery e Método Queries.runquery agora permitem a execução de consultas de forma assíncrona.

Confira o novo parâmetro asynchronous em createquery e runquery para mais detalhes.

Problemas conhecidos

Nenhum.

14 de janeiro de 2020

Novos recursos

v1.1

Horário de início da programação de consulta

Método Queries.createquery agora permite especificar a data de início das programações de execução da consulta.

Mostrar novo campo schedule.startTimeMs para mais detalhes.

Problemas conhecidos

Nenhum.

8 de janeiro de 2020

Novos recursos

v1.1

Alternar dados das listas de público-alvo segmentadas

Método Queries.createquery agora permite especificar se os dados da lista de público-alvo devem ser limitados a determinados pedidos de inserção ou itens de linha.

Mostrar novo campo params.options.includeOnlyTargetedUserLists para mais detalhes.

Problemas conhecidos

Nenhum.

19 de novembro de 2019

Novos recursos

v1.1

Filtro de um para um para mapear o mapeamento de colunas do relatório

Os filtros mapeados para várias colunas do relatório agora são mapeados para um único colunas.

Por exemplo, na v1, incluir o filtro FILTER_ADVERTISER gera um relatório com as colunas "Anunciante" além do "ID do anunciante". Na v1.1, todos as colunas do relatório têm filtros próprios. Por exemplo, um novo filtro FILTER_ADVERTISER_NAME é mapeado para "Anunciante". Para conseguir as métricas "Anunciante" ID" e "Anunciante" colunas nos relatórios, os filtros FILTER_ADVERTISER e FILTER_ADVERTISER_NAME, respectivamente, terão que ser incluídos em Queries.createquery solicitações.

Mais especificamente, a solicitação createquery:

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

gera um arquivo de relatório com os seguintes cabeçalhos na v1:

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

e os seguintes cabeçalhos na v1.1:

Advertiser,Impressions

O código v1 a seguir usado para conseguir as colunas do relatório:

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

terá que ser modificados de forma semelhante ao seguinte na v1.1 (o filtro de observação ordenação):

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 adicionados
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
Paginação

v1.1 adiciona paginação aos métodos Queries.listqueries e Reports.listreports

Na v1.1, o número de resultados retornados por é igual a um parâmetro recém-adicionado pageSize (o padrão é 100 se não for especificado). As respostas contêm um parâmetro nextPageToken que pode ser usada para recuperar o próximo conjunto de resultados. Este campo ficará em branco se os resultados foram esgotadas.

O código v1 a seguir para recuperar todos os relatórios pertencentes a uma 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();
  }
}

terão que ser modificadas de forma semelhante ao exemplo a seguir na v1.1, a fim de continuar recuperando todos os relatórios:

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

Consulte Queries.listqueries e Método Reports.listreports documentação para saber mais.

Problemas conhecidos

Nenhum.