Arşivlenmiş sürüm notları

Bu sayfada, kullanımdan kaldırılan Bid Manager API sürümlerinin sürüm notları sağlanmaktadır.

Aşağıdaki tüm sürümler için ana sürüm notları sayfamıza gidin: canlı sürümleri.

15 Nisan 2021

Yeni özellikler

Bid Manager API v1.1 sürümü kullanıma sunuldu.

v1.1

SDF ve satır öğesi hizmetlerinin kullanımdan kaldırılması

SDF ve satır öğesi hizmetleri kullanımdan kaldırıldı.

Yapılandırılmış Veri Dosyaları indirmek veya satır öğelerini yönetmek isteyen kullanıcılar bunun yerine Display & Video 360 API'yi kullanmalıdır.

Bilinen sorunlar

Yok.

6 Ağustos 2020

Yeni özellikler

v1.1

Yol ve Yol İlişkilendirme Raporları

TYPE_PATH ve TYPE_PATH_ATTRIBUTION report types artık yayında.

Buna, query ve report kaynaklarına yeni params.options.pathQueryOptions alanının (pathFilters ve channelGrouping alanlarını içeren) eklenmesi de dahildir.

Yeni Filters eklendi:

  • FILTER_CHANNEL_GROUPING
  • FILTER_EVENT_TYPE
  • FILTER_PATH_EVENT_INDEX
  • FILTER_PATH_PATTERN_ID

Yeni Metrics eklendi:

  • 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

Bilinen sorunlar

Yok.

20 Mart 2020

Yeni özellikler

v1.1

Eşzamansız sorgu çalıştırma

Queries.createquery ve Queries.runquery yöntemi şimdi sorguların eşzamansız olarak çalıştırılmasını sağlar.

Daha fazla bilgi için createquery ve runquery bölümündeki yeni asynchronous parametresine bakın.

Bilinen sorunlar

Yok.

14 Ocak 2020

Yeni özellikler

v1.1

Sorgu planı başlangıç zamanı

Queries.createquery yöntemi artık sorgu çalıştırma programlarının başladığı tarihi belirtmenize olanak tanır.

Daha fazla bilgi için yeni schedule.startTimeMs alanına bakın.

Bilinen sorunlar

Yok.

8 Ocak 2020

Yeni özellikler

v1.1

Hedeflenen kitle listesi verilerini aç/kapat

Şu an Queries.createquery yöntemi kitle listesi verilerinin belirli bir kitleyle sınırlı olup olmayacağının belirtilmesini sağlar satır öğelerini ekleyebilirsiniz.

Daha fazla bilgi için yeni params.options.includeOnlyTargetedUserLists alanına bakın.

Bilinen sorunlar

Yok.

19 Kasım 2019

Yeni özellikler

v1.1

Rapor sütunu eşlemesi için bire bir filtre

Birden fazla rapor sütunuyla eşlenen filtreler artık tek sütunlarla eşlenir.

Örneğin, v1'de FILTER_ADVERTISER filtresi eklendiğinde "Reklamveren kimliği"ne ek olarak "Reklamveren" sütunlarının da yer aldığı bir rapor oluşturulur. 1.1 sürümünde tüm rapor sütunlarının kendi filtreleri vardır. Örneğin, yeni bir filtre FILTER_ADVERTISER_NAME, "Reklamveren" ile eşlenir. Hem "Reklamveren"i hem de Kimlik" ve "Reklamveren" sütunlarda görebilirsiniz; hem FILTER_ADVERTISER hem de FILTER_ADVERTISER_NAME, dönüşüm hunisine dahil edilmeli Queries.createquery kabul edersiniz.

Daha açık belirtmek gerekirse createquery isteği:

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

v1'de aşağıdaki başlıklara sahip bir rapor dosyası oluşturur:

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

ve 1.1 sürümünde aşağıdaki üstbilgilerde:

Advertiser,Impressions

Rapor sütunlarını almak için kullanılan aşağıdaki v1 kodu:

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

(not filtresi) sipariş):

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);
Orijinal filtre Eklenen filtreler
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
Sayfalara ayırma

v1.1, yöntemlere sayfalara ayırma ekliyor Queries.listqueries ve Reports.listreports.

Sürüm 1.1'de, bu anahtar kelimeler tarafından döndürülen sonuçların sayısı yöntemleri yeni eklenen bir parametreye eşit pageSize (varsayılan olarak Belirtilmemişse 100). Yanıtlarda yeni eklenmiş bir nextPageToken alanı sonraki sonuç grubunu almak için kullanılabilir. Sonuçlarsa bu alan boş bırakılır için iyi bir fırsattır.

Belirli bir sorguya ait tüm raporları almak için kullanılan aşağıdaki v1 kodu:

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

    return reportListResponse.getReports();
  }
}

önce 1.1 sürümünde aşağıdakine benzer şekilde değiştirilmesi gerekir: tüm raporları almaya devam et:

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

Daha fazla bilgi için Queries.listqueries ve Reports.listreports yöntem dokümanlarına bakın.

Bilinen sorunlar

Yok.