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

SDF ed Elemento pubblicitario e i servizi Google sono stati ritirati.

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

Percorso e Report sull'attribuzione del percorso

TYPE_PATH e TYPE_PATH_ATTRIBUTION report types sono ora disponibili.

È inclusa l'aggiunta del nuovo campo params.options.pathQueryOptions (che contiene i campi pathFilters e channelGrouping) per query e report di risorse.

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

Queries.createquery e Metodo 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 pianificazione 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 di destinazione

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

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

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 una singola 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 ottenere entrambi gli attributi ID" e "Inserzionista" colonne nei report, entrambi i filtri FILTER_ADVERTISER e Dovrai includere rispettivamente FILTER_ADVERTISER_NAME nel Queries.createquery: richieste.

Più concretamente, la richiesta createquery:

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

genera un file di report con le seguenti intestazioni nella versione v1:

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 alla seguente nella v1.1 (nota filtro ordinazione):

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 l'impaginazione ai metodi Queries.listqueries e Reports.listreports.

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

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

Vedi Queries.listqueries e Metodo Reports.listreports documentazione per ulteriori dettagli.

Problemi noti

Nessuno.