Arsip catatan rilis

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

Buka halaman catatan rilis utama untuk semua rilis guna 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 kini 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

Jalur & Laporan Atribusi Jalur

TYPE_PATH dan TYPE_PATH_ATTRIBUTION report types kini sedang live.

Ini termasuk penambahan kolom baru params.options.pathQueryOptions (yang berisi kolom pathFilters dan channelGrouping) untuk query dan report.

Filters baru yang 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 one-to-one untuk pemetaan kolom laporan

Filter yang dipetakan ke beberapa kolom laporan kini dipetakan ke satu seperti baris dan kolom.

Misalnya, pada v1, menyertakan filter FILTER_ADVERTISER akan menghasilkan laporan dengan kolom "Advertiser" 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 jelasnya, 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);
Filter asli Filter ditambahkan
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
Penomoran halaman

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

Di v1.1, jumlah hasil yang dikembalikan oleh sama dengan parameter yang baru ditambahkan pageSize (default-nya adalah 100 jika tidak ditentukan). Respons berisi entri yang baru ditambahkan Kolom nextPageToken yang dapat digunakan untuk mengambil kumpulan hasil berikutnya. Bidang 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.