Arsip catatan rilis

Halaman ini menyediakan catatan rilis untuk versi Bid Manager API yang dihentikan.

Buka halaman catatan rilis utama untuk semua rilis ke versi aktif.

15 April 2021

Fitur baru

Merilis Bid Manager API v1.1.

v1.1

Penghentian layanan SDF dan Item Baris

SDF dan Item Baris layanan tersebut sekarang dihentikan.

Pengguna yang ingin mendownload Data Terstruktur Mengelola atau mengelola item baris harus sebagai gantinya, gunakan tombol Display & Video 360 API.

Masalah umum

Tidak ada.

6 Agustus 2020

Fitur baru

v1.1

Laporan Jalur & Atribusi Jalur

TYPE_PATH dan TYPE_PATH_ATTRIBUTION report types kini aktif.

Hal ini mencakup penambahan kolom baru params.options.pathQueryOptions (yang berisi kolom pathFilters dan channelGrouping) ke resource query dan report.

Filters baru ditambahkan:

• FILTER_CHANNEL_GROUPING
• FILTER_EVENT_TYPE
• FILTER_PATH_EVENT_INDEX
• FILTER_PATH_PATTERN_ID

Metrics baru yang ditambahkan:

• 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

Masalah umum

Tidak ada.

20 Maret 2020

Fitur baru

v1.1

Operasi kueri asinkron

Queries.createquery dan Metode Queries.runquery sekarang mengizinkan kueri berjalan secara asinkron.

Lihat parameter baru asynchronous di createquery dan runquery untuk mengetahui detail selengkapnya.

Masalah umum

Tidak ada.

14 Januari 2020

Fitur baru

v1.1

Waktu mulai jadwal kueri

Metode Queries.createquery sekarang memungkinkan Anda menentukan tanggal kapan jadwal kueri dijalankan.

Lihat kolom baru schedule.startTimeMs untuk secara lebih mendetail.

Masalah umum

Tidak ada.

8 Januari 2020

Fitur baru

v1.1

Aktifkan/nonaktifkan data daftar audiens yang ditargetkan

Metode Queries.createquery sekarang memungkinkan Anda untuk menentukan apakah data daftar audiens harus dibatasi perjanjian pemasangan iklan atau item baris.

Lihat kolom baru params.options.includeOnlyTargetedUserLists untuk mengetahui detail selengkapnya.

Masalah umum

Tidak ada.

19 November 2019

Fitur baru

v1.1

Filter satu-ke-satu untuk melaporkan pemetaan kolom

Filter yang dipetakan ke beberapa kolom laporan kini dipetakan ke satu kolom.

Misalnya, di v1, menyertakan filter FILTER_ADVERTISER akan menghasilkan laporan dengan kolom "Pengiklan" selain "ID Pengiklan". Di v1.1, semua kolom laporan memiliki filternya sendiri. Misalnya, filter baru FILTER_ADVERTISER_NAME dipetakan ke "Pengiklan". Untuk mendapatkan "Pengiklan" "ID" dan "Pengiklan" kolom di laporan, baik filter FILTER_ADVERTISER maupun FILTER_ADVERTISER_NAME, masing-masing, harus disertakan dalam Queries.createquery permintaan.

Lebih konkret, permintaan createquery:

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

membuat file laporan dengan header berikut di v1:

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

dan header berikut di v1.1:

Advertiser,Impressions

Kode v1 berikut digunakan untuk mendapatkan kolom laporan:

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

harus dimodifikasi seperti berikut di v1.1 (catatan filter ):

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

Penomoran halaman

v1.1 menambahkan penomoran halaman ke metode Queries.listqueries dan Reports.listreports.

Di v1.1, jumlah hasil yang ditampilkan oleh metode ini sama dengan parameter yang baru ditambahkan pageSize (defaultnya adalah 100 jika tidak ditentukan). Respons berisi entri yang baru ditambahkan Kolom nextPageToken yang dapat digunakan untuk mengambil kumpulan hasil berikutnya. Kolom ini kosong jika hasil telah habis.

Kode v1 berikut untuk mengambil semua laporan milik kueri tertentu:

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

    return reportListResponse.getReports();
  }
}

harus dimodifikasi mirip dengan berikut di v1.1, untuk terus mengambil semua laporan:

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

Lihat Queries.listqueries dan Metode Reports.listreports dokumentasi untuk detail lebih lanjut.

Masalah umum

Tidak ada.