No momento, estamos migrando um subconjunto de tipos de relatório dos relatórios off-line para os instantâneos. Depois da migração de um usuário, as respostas do queries.list incluirão os relatórios instantâneos atuais. Confira nossa postagem do blog para mais informações.

Esta página foi traduzida pela API Cloud Translation.

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.