Note di rilascio archiviate

Questa pagina fornisce le note di rilascio per le versioni ritirate dell'API Bid Manager.

Vai alla pagina principale delle note di rilascio per tutte le release per le versioni live.

15 aprile 2021

Nuove funzionalità

È stata rilasciata la versione 1.1 dell'API Bid Manager.

v1.1

Ritiro dei servizi SDF e elementi pubblicitari

I servizi SDF e Elemento pubblicitario non sono più disponibili.

Utenti che cercano di scaricare dati strutturati I file o la gestione degli elementi pubblicitari devono: utilizza invece lo strumento Display & API Video 360.

Problemi noti

Nessuno.

6 agosto 2020

Nuove funzionalità

v1.1

Report Percorso e Attribuzione percorso

TYPE_PATH e TYPE_PATH_ATTRIBUTION report types sono ora disponibili.

Ciò include l'aggiunta del nuovo campo params.options.pathQueryOptions (che contiene i campi pathFilters e channelGrouping) alle risorse query e report.

Nuovo Filters aggiunto:

  • FILTER_CHANNEL_GROUPING
  • FILTER_EVENT_TYPE
  • FILTER_PATH_EVENT_INDEX
  • FILTER_PATH_PATTERN_ID

Nuovo Metrics aggiunto:

  • 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

Problemi noti

Nessuno.

20 marzo 2020

Nuove funzionalità

v1.1

Esecuzione query asincrona

I metodi Queries.createquery e Queries.runquery ora consentono di eseguire query in modo asincrono.

Visualizza nuovo parametro asynchronous in createquery e runquery per ulteriori dettagli.

Problemi noti

Nessuno.

14 gennaio 2020

Nuove funzionalità

v1.1

Ora di inizio della pianificazione delle query

Metodo Queries.createquery ora consente di specificare la data di inizio delle pianificazioni dell'esecuzione delle query.

Visualizza nuovo campo schedule.startTimeMs per ulteriori dettagli.

Problemi noti

Nessuno.

8 gennaio 2020

Nuove funzionalità

v1.1

Attiva/disattiva i dati degli elenchi dei segmenti di pubblico scelti come target

Metodo Queries.createquery ora consente di specificare se i dati degli elenchi del segmento di pubblico devono essere limitati a dati specifici ordini di inserzione o elementi pubblicitari.

Visualizza nuovo campo params.options.includeOnlyTargetedUserLists per ulteriori dettagli.

Problemi noti

Nessuno.

19 novembre 2019

Nuove funzionalità

v1.1

Filtro uno a uno per la mappatura delle colonne del report

I filtri mappati a più colonne del report ora vengono mappati a singole colonne.

Ad esempio, nella versione 1, l'inclusione del filtro FILTER_ADVERTISER genera un report con le colonne "Inserzionista" oltre a "ID inserzionista". Nella versione 1.1, le colonne del report hanno i propri filtri. Ad esempio, un nuovo filtro FILTER_ADVERTISER_NAME viene mappato a "Inserzionista". Per visualizzare le colonne "ID inserzionista" e "Inserzionista" nei report, è necessario includere entrambi i filtri FILTER_ADVERTISER e FILTER_ADVERTISER_NAME nelle richieste Queries.createquery.

Più concretamente, la richiesta createquery:

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

genera un file report con le seguenti intestazioni nella versione 1:

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

e le seguenti intestazioni nella versione 1.1:

Advertiser,Impressions

Il seguente codice v1 utilizzato per ottenere le colonne del report:

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

dovrà essere modificato in modo simile al seguente nella versione 1.1 (nota l'ordine 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 originale Filtri aggiunti
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
Impaginazione

La versione 1.1 aggiunge la paginazione ai metodi Queries.listqueries e Reports.listreports.

Nella versione 1.1, il numero di risultati restituiti da questi metodi è uguale a un parametro appena aggiunto pageSize (se non specificato, il valore predefinito è 100). Le risposte contengono un'email appena aggiunta nextPageToken campo che può essere utilizzata per recuperare il successivo insieme di risultati. Questo campo è vuoto se i risultati sono stati esauriti.

Il seguente codice v1 per recuperare tutti i report appartenenti a una query specifica:

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

    return reportListResponse.getReports();
  }
}

dovrà essere modificato in modo simile alla seguente nella v1.1, per continua a recuperare tutti i report:

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

Per ulteriori dettagli, consulta la documentazione dei metodi Queries.listqueries e Reports.listreports.

Problemi noti

Nessuno.