Notas de lançamento arquivadas

Esta página apresenta as notas da versão para as versões desativadas da API Bid Manager.

Acesse a página principal de notas da versão para todas as versões ativas.

15 de abril de 2021

Novos recursos

Versão v1.1 da API Bid Manager lançada.

v1.1

Serviços de SDF e itens de linha desativados

Os serviços de SDF e item de linha foram desativados.

Os usuários que querem fazer o download de arquivos de dados estruturados ou gerenciar itens de linha precisam usar a API Display & Video 360.

Problemas conhecidos

Nenhum.

6 de agosto de 2020

Novos recursos

v1.1

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

TYPE_PATH e TYPE_PATH_ATTRIBUTION report types estão disponíveis.

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

Novas Filters adicionadas:

• 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

O método Queries.createquery e Queries.runquery agora permitem executar consultas de forma assíncrona.

Consulte 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

O método Queries.createquery agora permite especificar a data em que os horários de execução de consulta começam.

Mostrar novo campo schedule.startTimeMs para mais detalhes.

Problemas conhecidos

Nenhum.

8 de janeiro de 2020

Novos recursos

v1.1

Ativar ou desativar os dados das listas segmentadas de público-alvo

O método Queries.createquery agora permite especificar se os dados da lista de público-alvo precisam ser limitados a pedidos de inserção ou itens de linha específicos.

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

Problemas conhecidos

Nenhum.

19 de novembro de 2019

Novos recursos

v1.1

Filtro individual para mapeamento de colunas

Os filtros que eram mapeados para várias colunas de relatório agora são mapeados para colunas únicas.

Por exemplo, na v1, a inclusão do filtro FILTER_ADVERTISER gera um relatório com as colunas "Anunciante" e "ID do anunciante". Na v1.1, todas as colunas do relatório têm os próprios filtros. 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 acessar 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);

precisa ser modificado de forma semelhante à seguinte na v1.1 (ordenação do filtro de notas):

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

Paginação

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

Na v1.1, o número de resultados retornados por esses métodos é igual a um parâmetro recém-adicionado pageSize. Ele será definido como 100 por padrão 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();
  }
}

vai precisar ser modificado de forma semelhante ao seguinte na v1.1 para continuar extraindo 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 a documentação do método Queries.listqueries e Reports.listreports para mais detalhes.

Problemas conhecidos

Nenhum.