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

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.